/serviceconfigs//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//sessions) 지정된 세션 정보를 검색합니다.

함께 보기

상위

Session Directory URIs

마지막 수정일 2026년 10월 19일

⌘I