> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions

> /serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions

# /serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions

Dá suporte a uma operação GET para recuperar um conjunto de modelos de sessão com os nomes de modelo especificados.

<a id="ID4EO" />

## Domínio

sessiondirectory.xboxlive.com

<a id="ID4ET" />

## Parâmetros de URI

| Parâmetro | Tipo | Descrição |
| - | - | - |
| scid | GUID | Identificador de configuração de serviço (SCID). Parte 1 da ID da sessão. |
| keyword | string | Uma palavra-chave usada para filtrar os resultados apenas para as sessões identificadas com essa cadeia de caracteres. |
| xuid | GUID | IDs de usuário XBOX dos usuários para os quais recuperar sessões. Os usuários devem estar ativos nas sessões. |
| reservations | string | Valor que indica se a lista de sessões inclui aquelas que os usuários não aceitaram. Esse parâmetro só pode ser definido como true. Essa configuração exige que o chamador tenha acesso em nível de servidor à sessão ou que a declaração XUID do chamador corresponda ao filtro de ID de usuário XBOX. |
| inactive | string | Valor que indica se a lista de sessões inclui aquelas que os usuários aceitaram, mas nas quais não estão jogando ativamente. Esse parâmetro só pode ser definido como true. |
| private | string | Valor que indica se a lista de sessões inclui sessões privadas. Esse parâmetro só pode ser definido como true. Ele é válido somente ao consultar suas próprias sessões ou ao fazer consultas de servidor para servidor. Definir esse parâmetro como true exige que o chamador tenha acesso em nível de servidor à sessão ou que a declaração XUID do chamador corresponda ao filtro de ID de usuário XBOX. |
| visibility | string | Um valor de enumeração que indica o status de visibilidade usado na filtragem dos resultados. Atualmente, esse parâmetro só pode ser definido como Open para incluir sessões abertas. Consulte <b>MultiplayerSessionVisibility</b>. |
| version | string | Um inteiro positivo que indica a versão principal de sessão, ou inferior, das sessões a serem incluídas. O valor deve ser menor ou igual à versão do contrato da solicitação módulo 100. |
| take | string | Um inteiro positivo que indica o número máximo de sessões a serem recuperadas. |

<a id="ID4EZD" />

## Métodos válidos

[GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions)](/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionsget)

  Recupera documentos de modelo de sessão.

<a id="ID4EDE" />

## Confira também

<a id="ID4EFE" />

##### Pai

[URIs do Session Directory](/pt-BR/reference/live/rest/uri/sessiondirectory/atoc-reference-sessiondirectory)


## Related topics

- [XblMultiplayerSessionReferenceUri](/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreferenceuri.md)
- [Multiplayer Session Directory overview](/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)