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

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

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

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

지정된 템플릿 이름의 세션 템플릿 집합을 검색하는 GET 작업을 지원합니다.

## 도메인

sessiondirectory.xboxlive.com

## 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 | 검색할 최대 세션 수를 나타내는 양의 정수입니다. |

## 유효한 메서드

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

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

## 함께 보기

##### 상위

[Session Directory URIs](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/atoc-reference-sessiondirectory)


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