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

# GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})

> GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})

# GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})

Obtém um objeto de sessão.

> **Importante:**\
> Este método de URI requer um elemento de cabeçalho X-Xbl-Contract-Version: 104/105 ou posterior em todas as solicitações.

* [Comentários](#ID4ET)
* [Parâmetros de URI](#ID4EMB)
* [Códigos de status HTTP](#ID4EZB)
* [Corpo da solicitação](#ID4E6B)
* [Corpo da resposta](#ID4EKC)

## Comentários

Este método HTTP/REST lê um documento de sessão para o nome especificado e recupera a sessão. Em caso de êxito, ele retorna o objeto de sessão, com todos os seus atributos, obtido do servidor. Este método pode ser encapsulado por **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionAsync**. Os parâmetros do método GET correspondem diretamente aos especificados no objeto **MultiplayerSessionReference** da sessão, passado no parâmetro *sessionReference* de **GetCurrentSessionAsync**.

O formato de transmissão do método GET é mostrado abaixo.

```cpp theme={null}
GET /serviceconfigs/00000000-0000-0000-0000-000000000000/sessiontemplates/quick/sessions/00000000-0000-0000-0000-000000000001 HTTP/1.1
      Content-Type: application/json

```

## Parâmetros de URI

\| Parâmetro| Tipo| Descrição|
\| --- | --- | --- | --- |
\| scid| GUID| Identificador de configuração de serviço (SCID). Parte 1 do identificador da sessão.|
\| sessionTemplateName| string| Nome da instância atual do modelo de sessão. Parte 2 do identificador da sessão.|
\| sessionName| GUID| ID exclusiva da sessão. Parte 3 do identificador da sessão.|

## Códigos de status HTTP

O serviço retorna um código de status HTTP conforme aplicável ao MPSD.

## Corpo da solicitação

Nenhum objeto é enviado no corpo desta solicitação.

## Corpo da resposta

Veja a estrutura da resposta em [MultiplayerSession (JSON)](https://docs.xbox.com/pt-BR/reference/live/rest/json/json-multiplayersession.md).

## Confira também

##### Pai

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


## Related topics

- [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionname.md)
- [PUT (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnameput.md)
- [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/servers/{server-name}](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionnamemembersservername.md)
- [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/members/me](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnamemembersme.md)
- [DELETE (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/members/{index})](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionnamemembersindexdelete.md)