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

# 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)、アンダースコア (*)、ピリオド (.)、ハイフン (-) です。ファイル名を空にすること、ピリオドで終わらせること、または 2 つ連続するピリオドを含めることはできません。 |

## 認可

リクエストには、有効な XBOX LIVE 認可ヘッダーを含める必要があります。呼び出し元がこのリソースへのアクセスを許可されていない場合、サービスは 403 Forbidden レスポンスを返します。ヘッダーが無効または欠落している場合、サービスは 401 Unauthorized レスポンスを返します。

## リクエスト本文

\| プロパティ | 型 | 説明 |
\| --- | --- | --- | --- | --- | --- |
\| xuids| array of unsigned 64-bit integers| ファイルをダウンロードする対象の XUID のリスト。|

### サンプル リクエスト

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

## HTTP ステータス コード

サービスは、このリソースに対してこのメソッドで行われたリクエストへの応答として、このセクション内のいずれかのステータス コードを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、[標準 HTTP ステータス コード](https://devdocs.xbox.com/ja-jp/reference/live/rest/additional/httpstatuscodes) を参照してください。

\| コード | 理由 | 説明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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 で見つかったリソースの特定のバージョンに Web サーバーによって割り当てられた不透明な識別子です。その 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://devdocs.xbox.com/ja-jp/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype)


## Related topics

- [XblTitleStorageBlobMetadata](https://devdocs.xbox.com/reference/live/xsapi-c/title_storage_c/structs/xbltitlestorageblobmetadata.md)
- [XGameSaveFiles API overview](https://devdocs.xbox.com/build/core-features/common/game-save/xgamesavefiles.md)
- [XblTitleStorageDownloadBlobAsync](https://devdocs.xbox.com/es/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)