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

# GET (/json/users/xuid({xuid})/scids/{scid}/data/{path})

> GET (/json/users/xuid({xuid})/scids/{scid}/data/{path})

# GET (/json/users/xuid({xuid})/scids/{scid}/data/{path})

指定されたパスのファイル情報を一覧表示します。
これらの URI のドメインは `titlestorage.xboxlive.com` です。

* [URI パラメーター](#ID4EX)
* [オプションのクエリ文字列パラメーター](#ID4ECB)
* [認可](#ID4EUC)
* [必須リクエスト ヘッダー](#ID4EBD)
* [リクエスト本文](#ID4EKE)
* [HTTP ステータス コード](#ID4EXE)
* [レスポンス本文](#ID4EKCAC)

## URI パラメーター

| パラメーター | 型 | 説明 |
| - | - | - |
| xuid | unsigned 64-bit integer | リクエストを行うプレイヤーの XBOX ユーザー ID (XUID)。 |
| scid | guid | 検索するサービス構成の ID。 |
| path | string | 返されるデータ項目へのパス。一致するすべてのディレクトリとサブディレクトリが返されます。有効な文字は、英大文字 (A-Z)、英小文字 (a-z)、数字 (0-9)、アンダースコア (\_)、スラッシュ (/) です。空でも構いません。最大長は 256 です。 |

## オプションのクエリ文字列パラメーター

\| パラメーター | 型 | 説明 |
\| --- | --- | --- | --- | --- | --- |
\| skipItems| int| コレクション内で N+1 の項目から返します。つまり、N 個の項目をスキップします。|
\| continuationToken| string| 指定された継続トークンから項目を返します。両方が指定された場合、continuationToken パラメーターは skipItems より優先されます。言い換えると、continuationToken パラメーターが存在する場合、skipItems パラメーターは無視されます。|
\| maxItems| int| コレクションから返す項目の最大数。skipItems および continuationToken と組み合わせて、項目の範囲を返すことができます。maxItems が存在しない場合、サービスは既定値を提供する場合があります。また、結果の最後のページがまだ返されていない場合でも、maxItems より少ない数を返す場合があります。 |

## 認可

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

## 必須リクエスト ヘッダー

\| ヘッダー | 値 | 説明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| 1| API コントラクト バージョン。|
\| Authorization| XBL3.0 x=\[hash];\[token]| STS 認証トークン。STSTokenString は、認証リクエストによって返されるトークンに置き換えられます。STS トークンの取得および認可ヘッダーの作成についての詳細は、Authenticating and Authorizing XBOX LIVE Services Requests を参照してください。|

## リクエスト本文

このリクエストの本文にはオブジェクトを送信しません。

## 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 秒後)。|

## レスポンス本文

呼び出しが成功した場合、サービスは [TitleBlob](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-titleblob) オブジェクトの配列を返します。

### サンプル レスポンス

```cpp theme={null}
{
"blobs":
[
    {
        "fileName":"foo\bar\blob.txt,json",
        "clientFileTime":"2012-01-01T01:02:03.1234567Z",
        "displayName":"Friendly Name",
        "size":12,
        "etag":"0x8CEB3E4F8F3A5BF"
    },
    {
        "fileName":"foo\bar\blob2.txt,json",
        "displayName":"Blob 2",
        "size":4,
        "etag":"0x8CEB3FE57F1A142"
    },
    {
        "fileName":"foo\jsonblob.txt,json",
        "size":15,
        "etag":"0x8CEB40152B4A6F8"
    }
],
"pagingInfo":
    {
        "continuationToken":"54",
    }
}
         
```

## 関連項目

##### 親

[/json/users/xuid({xuid})/scids/{scid}/data/{path}](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/storage/uri-jsonusersxuidscidssciddatapath)

##### リファレンス  [TitleBlob (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-titleblob)

[PagingInfo (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-paginginfo)


## Related topics

- [XblTitleStorageDownloadBlobAsync](https://devdocs.xbox.com/es/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)
- [XblTitleStorageGetBlobMetadataAsync](https://devdocs.xbox.com/ja-jp/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragegetblobmetadataasync.md)