> ## Documentation Index > Fetch the complete documentation index at: https://docs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # POST (/serviceconfigs/{scid}/batch) > POST (/serviceconfigs/{scid}/batch) # POST (/serviceconfigs/{scid}/batch) 서비스 구성에 대한 여러 XBOX 사용자 ID에 대한 일괄 쿼리를 만듭니다. > **중요:**\ > 이 메서드는 2015 멀티플레이어에서 사용되며 해당 멀티플레이어 버전 이상에만 적용됩니다. 템플릿 계약 104/105 이상과 함께 사용하도록 설계되었으며, 모든 요청에 X-Xbl-Contract-Version: 104/105 이상의 헤더 요소가 필요합니다. * [설명](#ID4ET) * [URI 매개 변수](#ID4ELB) * [쿼리 문자열 매개 변수](#ID4EVB) * [HTTP 상태 코드](#ID4EGF) * [요청 본문](#ID4ENF) * [응답 본문](#ID4EWF) ## 설명 이 HTTP/REST 메서드는 서비스 구성 ID(SCID) 수준에서 여러 XBOX 사용자 ID에 대한 일괄 쿼리를 만듭니다. 이 메서드는 **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsForUsersFilterAsync**로 래핑될 수 있습니다. 2015 멀티플레이어에서는 *xuid* 쿼리 문자열 매개 변수에 표시된 것처럼 모든 쿼리가 동일하지만 서로 다른 XBOX 사용자 ID(XUID)를 처리하는 경우 여러 쿼리를 단일 호출로 결합할 수 있습니다. 쿼리 문자열 매개 변수와 응답은 일반 쿼리와 일괄 쿼리에서 동일합니다. 일괄 쿼리의 경우 각 XUID에 속한 세션은 요청에 제시된 *xuid* 매개 변수와 동일한 순서로 응답에 기록됩니다. 동일한 세션이 응답에 여러 번 나타날 수 있으며, 일치하는 각 *xuid*에 대해 한 번씩 나타납니다. ## URI 매개 변수 \| 매개 변수| 형식| 설명| \| --- | --- | --- | --- | \| scid| GUID| 서비스 구성 식별자(SCID). 세션 식별자의 파트 1입니다.| ## 쿼리 문자열 매개 변수 쿼리는 다음 표의 쿼리 문자열 매개 변수를 사용하여 수정할 수 있습니다. \| **매개 변수**| **형식**| **설명**| \| --- | --- | --- | --- | --- | --- | --- | \| keyword| string| 세션 또는 템플릿을 검색할 때 검색 대상에 포함되어야 하는 키워드(예: "foo")입니다. | \| xuid| 64비트 부호 없는 정수| 쿼리에 포함할 세션에 대한 XBOX 사용자 ID(예: "123")입니다. 기본적으로 사용자는 세션에 포함되기 위해 활성 상태여야 합니다. | \| reservations| boolean| 사용자가 예약된 플레이어로 설정되었지만 활성 플레이어가 되기 위해 조인하지 않은 세션을 포함하려면 True입니다. 이 매개 변수는 자신의 세션을 쿼리하거나 서버 대 서버로 특정 사용자의 세션을 쿼리할 때만 사용됩니다. | \| inactive| boolean| 사용자가 수락했지만 활발히 플레이하지 않은 세션을 포함하려면 True입니다. 사용자가 "ready" 상태이지만 "active" 상태가 아닌 세션은 비활성으로 간주됩니다. | \| private| boolean| 프라이빗 세션을 포함하려면 True입니다. 이 매개 변수는 자신의 세션을 쿼리하거나 서버 대 서버로 특정 사용자의 세션을 쿼리할 때만 사용됩니다. | \| visibility| string| 세션의 표시 상태입니다. 가능한 값은 **MultiplayerSessionVisibility**에 정의되어 있습니다. 이 매개 변수가 "open"으로 설정된 경우 쿼리에는 open 세션만 포함되어야 합니다. "private"로 설정된 경우 *private* 매개 변수를 true로 설정해야 합니다. | \| version| 32비트 부호 있는 정수| 포함되어야 하는 최대 세션 버전입니다. 예를 들어, 값 2는 주 세션 버전이 2 이하인 세션만 포함되어야 함을 지정합니다. 버전 번호는 요청의 계약 버전 mod 100 이하여야 합니다. | \| take| 32비트 부호 있는 정수| 검색할 최대 세션 수입니다. 이 숫자는 0에서 100 사이여야 합니다. | *private* 또는 *reservations* 중 하나를 true로 설정하려면 세션에 대한 서버 수준 액세스가 필요합니다. 또는 이러한 설정에는 호출자의 XUID 클레임이 URI의 XUID 필터와 일치해야 합니다. 그렇지 않으면 이러한 세션이 실제로 존재하는지 여부에 관계없이 HTTP/403 상태 코드가 반환됩니다. ## HTTP 상태 코드 서비스는 MPSD에 적용되는 HTTP 상태 코드를 반환합니다. ## 요청 본문 ```cpp theme={null} { "xuids": [ "1234", "5678" ] } ``` ## 응답 본문 이 메서드의 반환은 인라인으로 포함된 일부 세션 데이터가 있는 세션 참조의 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}/batch](https://docs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidbatch.md) ## Related topics - [/serviceconfigs/{scid}/batch](https://docs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidbatch.md) - [POST (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/batch)](https://docs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigscidsessiontemplatessessiontemplatenamebatchpost.md) - [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/batch](https://docs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigscidsessiontemplatessessiontemplatenamebatch.md) - [POST (/untrustedplatform/users/batch/scids/{scid}/data/{pathAndFileName},{type})](https://docs.xbox.com/ko/reference/live/rest/uri/storage/uri-untrustedplatformusersbatchscidssciddatapathandfilenametype-post.md) - [POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)](https://docs.xbox.com/ko/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype-post.md)