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

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

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

세션 템플릿 문서를 검색합니다.

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

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

## 설명

이 HTTP/REST 메서드는 제공된 필터에 대한 세션 템플릿 정보를 검색합니다. 이 메서드는 **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsAsync**로 래핑될 수 있습니다.

> **참고:**\
> 2015 멀티플레이어의 경우 이 메서드는 **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsForUsersFilterAsync**에서 호출합니다.

> **참고:**\
> 이 메서드에 대한 모든 호출에는 키워드, XBOX 사용자 ID 필터 또는 둘 다가 포함되어야 합니다. 호출자에게 *private* 및 *reservations* 매개 변수에 대한 올바른 권한이 없는 경우 메서드는 실제로 이러한 세션이 존재하는지 여부에 관계없이 오류 코드 403 Forbidden을 반환합니다.

## URI 매개 변수

\| 매개 변수| 형식| 설명|
\| --- | --- | --- | --- | --- | --- |
\| scid| GUID| 서비스 구성 식별자(SCID). 세션 ID의 파트 1입니다.|
\| keyword| string| 결과를 해당 문자열로 식별된 세션으로만 필터링하는 데 사용되는 키워드입니다.|
\| xuid| GUID| 세션을 검색할 사용자의 XBOX 사용자 ID입니다. 사용자는 세션에서 활성 상태여야 합니다. |
\| reservations| string| 사용자가 수락하지 않은 세션이 세션 목록에 포함되는지 여부를 나타내는 값입니다. 이 매개 변수는 true로만 설정할 수 있습니다. 이 설정에는 호출자가 세션에 대한 서버 수준 액세스 권한이 있거나 호출자의 XUID 클레임이 XBOX 사용자 ID 필터와 일치해야 합니다. |
\| inactive| string| 사용자가 수락했지만 활발히 플레이하지 않은 세션이 세션 목록에 포함되는지 여부를 나타내는 값입니다. 이 매개 변수는 true로만 설정할 수 있습니다. |
\| private| string| 프라이빗 세션이 세션 목록에 포함되는지 여부를 나타내는 값입니다. 이 매개 변수는 true로만 설정할 수 있습니다. 자신의 세션을 쿼리하거나 서버 대 서버로 쿼리할 때만 유효합니다. 이 매개 변수를 true로 설정하려면 호출자가 세션에 대한 서버 수준 액세스 권한이 있거나 호출자의 XUID 클레임이 XBOX 사용자 ID 필터와 일치해야 합니다. |
\| visibility| string| 결과 필터링에 사용되는 표시 상태를 나타내는 열거형 값입니다. 현재 이 매개 변수는 open 세션을 포함하기 위해 Open으로만 설정할 수 있습니다. **MultiplayerSessionVisibility**를 참조하십시오. |
\| version| string| 포함할 세션의 주 세션 버전 또는 그 이하를 나타내는 양의 정수입니다. 이 값은 요청의 계약 버전 modulo 100 이하여야 합니다. |
\| take| string| 검색할 최대 세션 수를 나타내는 양의 정수입니다.|

## HTTP 상태 코드

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

## 요청 본문

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

## 응답 본문

이 메서드의 반환은 인라인으로 포함된 일부 세션 데이터가 있는 세션 참조의 JSON 배열입니다.

```cpp theme={null}
{
    "results": [ {
            "xuid": "9876",    // If the session was found from a xuid, that xuid.
            "startTime": "2009-06-15T13:45:30.0900000Z",
            "sessionRef": {
                "scid": "foo",
                "templateName": "bar",
                "name": "session-seven"
            },
            "accepted": 4,    // Approximate number of non-reserved members.
            "status": "active",    // or "reserved" or "inactive". This is the state of the user in the session, not the session itself. Only present if the session was found using a xuid.
            "visibility": "open",    // or "private", "visible", or "full"
            "joinRestriction": "local",    // or "followed". Only present if 'visibility' is "open" or "full" and the session has a join restriction.
            "myTurn": true,    // Not present is the same as 'false'. Only present if the session was found using a xuid.
            "keywords": [ "one", "two" ]
        }
    ]
}

```

## 함께 보기

##### 상위

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


## Related topics

- [XblMultiplayerSessionReferenceUri](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreferenceuri.md)
- [Multiplayer Session Directory overview](https://devdocs.xbox.com/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)