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

세션 개체를 가져옵니다.

> **중요:**\
> 이 URI 메서드는 모든 요청에 X-Xbl-Contract-Version: 104/105 이상의 헤더 요소가 필요합니다.

* [설명](#ID4ET)
* [URI 매개 변수](#ID4EMB)
* [HTTP 상태 코드](#ID4EZB)
* [요청 본문](#ID4E6B)
* [응답 본문](#ID4EKC)

## 설명

이 HTTP/REST 메서드는 지정된 이름에 대한 세션 문서를 읽고 세션을 검색합니다. 성공하면 서버에서 얻은 모든 특성이 포함된 세션 개체를 반환합니다. 이 메서드는 **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionAsync**로 래핑될 수 있습니다. GET 메서드의 매개 변수는 **GetCurrentSessionAsync**의 *sessionReference* 매개 변수에 전달되는 세션에 대한 **MultiplayerSessionReference** 개체에 지정된 매개 변수와 직접적으로 대응됩니다.

GET 메서드의 와이어 형식은 다음과 같습니다.

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

```

## URI 매개 변수

\| 매개 변수| 형식| 설명|
\| --- | --- | --- | --- |
\| scid| GUID| 서비스 구성 식별자(SCID). 세션 식별자의 파트 1입니다.|
\| sessionTemplateName| string| 세션 템플릿의 현재 인스턴스 이름입니다. 세션 식별자의 파트 2입니다.|
\| sessionName| GUID| 세션의 고유 ID입니다. 세션 식별자의 파트 3입니다.|

## HTTP 상태 코드

서비스는 MPSD에 적용되는 HTTP 상태 코드를 반환합니다.

## 요청 본문

이 요청의 본문에는 개체가 전송되지 않습니다.

## 응답 본문

[MultiplayerSession (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-multiplayersession)의 응답 구조를 참조하십시오.

## 함께 보기

##### 상위

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


## Related topics

- [XblMultiplayerSessionReferenceUri](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreferenceuri.md)
- [XblMultiplayerSessionReference](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference.md)