/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions
지정된 템플릿 이름이 있는 세션 템플릿 집합을 검색하는 GET 작업을 지원합니다.
도메인
URI 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| scid | GUID | 서비스 구성 식별자(SCID). 세션 ID의 파트 1. |
| keyword | 문자열 | 해당 문자열로 식별된 세션으로 결과를 필터링하는 데 사용되는 키워드입니다. |
| xuid | GUID | 세션을 검색할 사용자의 Xbox 사용자 ID입니다. 사용자는 세션에서 활성화되어 있어야 합니다. |
| reservations | 문자열 | 세션 목록에 사용자가 허용하지 않은 세션 목록이 포함되어 있는지 나타내는 값입니다. 이 매개 변수는 true로만 설정할 수 있습니다. 이 설정을 사용하려면 호출자에게 세션에 대한 서버 수준의 액세스 권한이 있거나 호출자의 XUID 클레임이 Xbox 사용자 ID 필터와 일치해야 합니다. |
| inactive | 문자열 | 세션 목록에 사용자가 수락했지만 플레이하지 않는 세션 목록이 포함되어 있는지 나타내는 값입니다. 이 매개 변수는 true로만 설정할 수 있습니다. |
| private | 문자열 | 세션 목록에 비공개 세션이 포함되는지 여부를 나타내는 값입니다. 이 매개 변수는 true로만 설정할 수 있습니다. 자체 세션을 쿼리하거나 서버 간에 쿼리할 때만 유효합니다. 이 매개 변수를 true로 설정하려면 호출자에게 세션에 대한 서버 수준의 액세스 권한이 있거나 호출자의 XUID 클레임이 Xbox 사용자 ID 필터와 일치해야 합니다. |
| visibility | 문자열 | 필터링 결과에 사용된 가시성 상태를 나타내는 열거형 값입니다. 현재 이 매개 변수는 공개 세션만 포함하도록 Open으로만 설정할 수 있습니다. MultiplayerSessionVisibility를 참조하세요. |
| version | 문자열 | 포함할 세션의 주요 세션 버전 또는 그 이하를 나타내는 양의 정수입니다. 값은 요청의 계약 버전인 modulo 100 이하여야 합니다. |
| take | 문자열 | 검색할 최대 세션 수를 나타내는 양의 정수입니다. |
유효한 메서드
GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions)
세션 템플릿 문서를 검색합니다.