> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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.

## Domínio

sessiondirectory.xboxlive.com

## 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 **MultiplayerSessionVisibility**. |
| 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. |

## Métodos válidos

[GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions)](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionsget.md)

  Recupera documentos de modelo de sessão.

## Confira também

##### Pai

[URIs do Session Directory](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/atoc-reference-sessiondirectory.md)


## Related topics

- [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatename.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions)](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionsget.md)
- [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionname.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnameget.md)
- [PUT (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnameput.md)
