> ## 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 (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)

> POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)

# POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)

동일한 파일 이름으로 여러 사용자로부터 여러 파일을 다운로드합니다. 다운로드할 파일은 요청의 URI에 의해 결정됩니다. 요청의 본문에는 파일을 다운로드할 사용자의 XUID 목록이 포함됩니다. 응답의 본문은 다중 파트 MIME 메시지이며, 각 파트는 특정 사용자의 파일을 자체 헤더 집합과 함께 나타냅니다. 응답의 파트는 성공과 실패가 혼합될 수 있습니다.
이 URI의 도메인은 `titlestorage.xboxlive.com`입니다.

* [URI 매개 변수](#ID4EX)
* [권한 부여](#ID4ECB)
* [요청 본문](#ID4EPB)
* [HTTP 상태 코드](#ID4E3C)
* [필수 응답 헤더](#ID4EPAAC)
* [선택적 응답 헤더](#ID4ESBAC)
* [응답 본문](#ID4E3CAC)

## URI 매개 변수

| 매개 변수 | 유형 | 설명 |
| - | - | - |
| scid | guid | 조회할 서비스 구성의 ID입니다. |
| pathAndFileName | string | 액세스할 항목의 경로 및 파일 이름입니다. 경로 부분(마지막 슬래시 포함까지)의 유효한 문자에는 대문자(A-Z), 소문자(a-z), 숫자(0-9), 밑줄(*), 슬래시(/)가 포함됩니다. 경로 부분은 비어 있을 수 있습니다. 파일 이름 부분(마지막 슬래시 이후의 모든 것)의 유효한 문자에는 대문자(A-Z), 소문자(a-z), 숫자(0-9), 밑줄(*), 마침표(.), 하이픈(-)이 포함됩니다. 파일 이름은 비어 있거나 마침표로 끝나거나 두 개의 연속된 마침표를 포함할 수 없습니다. |

## 권한 부여

요청에는 유효한 XBOX LIVE 권한 부여 헤더가 포함되어야 합니다. 호출자가 이 리소스에 액세스할 수 없는 경우 서비스는 403 Forbidden 응답을 반환합니다. 헤더가 유효하지 않거나 누락된 경우 서비스는 401 Unauthorized 응답을 반환합니다.

## 요청 본문

\| 속성| 유형| 설명|
\| --- | --- | --- | --- | --- | --- |
\| xuids| unsigned 64-bit integer의 배열| 파일을 다운로드할 XUID 목록입니다.|

### 샘플 요청

```cpp theme={null}
{
    "xuids" : 
    [
      12345,
      45678,
      78901
    ]
}
      
```

## HTTP 상태 코드

서비스는 이 리소스에 대해 이 메서드로 만든 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용하는 표준 HTTP 상태 코드의 전체 목록은 [표준 HTTP 상태 코드](https://docs.xbox.com/ko/reference/live/rest/additional/httpstatuscodes.md)를 참조하세요.

\| 코드| 이유 문구| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK | 요청이 성공했습니다.|
\| 201| Created | 엔터티가 생성되었습니다.|
\| 400| Bad Request | 서비스가 잘못된 형식의 요청을 이해할 수 없습니다. 일반적으로 잘못된 매개 변수입니다.|
\| 401| Unauthorized | 요청에 사용자 인증이 필요합니다.|
\| 403| Forbidden | 사용자 또는 서비스에 대해 요청이 허용되지 않습니다.|
\| 404| Not Found | 지정된 리소스를 찾을 수 없습니다.|
\| 406| Not Acceptable | 리소스 버전이 지원되지 않습니다.|
\| 408| Request Timeout | 요청을 완료하는 데 시간이 너무 오래 걸렸습니다.|
\| 500| Internal Server Error | 서버가 요청을 이행하지 못하게 하는 예기치 않은 상태를 발견했습니다.|
\| 503| Service Unavailable | 요청이 제한되었습니다. client-retry 값(예: 5초)을 초 단위로 지정한 후 요청을 다시 시도하세요.|

## 필수 응답 헤더

\| 헤더| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Disposition| 파트의 내용을 설명합니다. 헤더의 "name" 및 "filename" 부분은 이 파일이 속한 사용자의 XUID입니다.|
\| HttpStatusCode| 이 특정 파일 검색과 관련된 HTTP 상태 코드입니다.|

## 선택적 응답 헤더

\| 헤더| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| ETag| ETag는 웹 서버가 URL에서 찾은 리소스의 특정 버전에 할당한 불투명한 식별자입니다. 해당 URL의 리소스 콘텐츠가 변경되면 새롭고 다른 ETag가 할당됩니다.|
\| Content-Type| 파일이 성공적으로 검색된 경우, 이것은 파일의 Content-Type입니다.|
\| Content-Range| 파일이 성공적으로 검색되었으며 부분 다운로드인 경우, 이것은 응답에 포함된 파일의 바이트 범위입니다. |

## 응답 본문

호출이 성공하면 서비스는 요청된 파일의 내용을 다중 파트 응답으로 반환합니다.

### 샘플 응답

```cpp theme={null}
HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: multipart/form-data; boundary=c0a9fd75-d036-4294-8b7b-85fea15a31bb

228
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="123"; filename="123"
HttpStatusCode: 200
ETag: 0x8CF327717411C31
Content-Type: application/octet-stream

asdf123
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="456"; filename="456"
HttpStatusCode: 200
ETag: 0x8CF32771E954BB8
Content-Type: application/octet-stream

asdf456
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="789"; filename="789"
HttpStatusCode: 404


--c0a9fd75-d036-4294-8b7b-85fea15a31bb--

0

```

## 참고 항목

##### 부모

[/json/users/batch/scids/{scid}/data/{pathAndFileName},json](https://docs.xbox.com/ko/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype.md)


## Related topics

- [/json/users/batch/scids/{scid}/data/{pathAndFileName},json](https://docs.xbox.com/ko/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype.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 (/trustedplatform/users/batch/scids/{scid}/data/{pathAndFileName},{type})](https://docs.xbox.com/ko/reference/live/rest/uri/storage/uri-trustedplatformusersbatchscidssciddatapathandfilenametype-post.md)
- [/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json](https://docs.xbox.com/ko/reference/live/rest/uri/storage/uri-jsonusersxuidscidssciddatapathandfilenametype.md)
- [/untrustedplatform/users/batch/scids/{scid}/data/{pathAndFileName},{type}](https://docs.xbox.com/ko/reference/live/rest/uri/storage/uri-untrustedplatformusersbatchscidssciddatapathandfilenametype.md)