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

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

<a id="ID4ET" />

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

```

<a id="ID4EMB" />

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

<a id="ID4EZB" />

## Códigos de status HTTP

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

<a id="ID4E6B" />

## Corpo da solicitação

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

<a id="ID4EKC" />

## Corpo da resposta

Veja a estrutura da resposta em [MultiplayerSession (JSON)](/pt-BR/reference/live/rest/json/json-multiplayersession).

<a id="ID4ETC" />

## Confira também

<a id="ID4EVC" />

##### Pai

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


## Related topics

- [XblMultiplayerSessionReferenceUri](/zh-CN/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreferenceuri.md)
- [XblMultiplayerSessionReference](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference.md)
- [XblMultiplayerSessionReferenceCreate](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionreferencecreate.md)