다음을 통해 공유


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

세션 개체를 가져옵니다.

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

설명

이 HTTP/REST 메서드는 지정된 이름의 세션 문서를 읽고 세션을 검색합니다. 성공하면 모든 속성과 함께 서버에서 얻은 세션 개체를 반환합니다. 이 메서드는 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionAsync로 래핑될 수 있습니다. GET 메서드의 매개 변수는 GetCurrentSessionAsyncsessionReference 파라미터에서 전달된 세션용 MultiplayerSessionReference 개체에 지정된 매개 변수와 유사합니다.

GET 메서드의 통신 형식은 다음과 같습니다.

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 문자열 세션 템플릿의 현재 인스턴스 이름. 세션 식별자의 파트 2.
sessionName GUID 세션의 고유한 ID. 세션 식별자의 파트 3.

HTTP 상태 코드

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

요청 본문

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

응답 본문

MultiplayerSession(JSON)의 응답 구조를 참조하세요.

참고 항목

부모

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