> ## 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 (/untrustedplatform/users/xuid({xuid})/scids/{scid}/data/{path})

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

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

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

* [URI パラメーター](#ID4EX)
* [省略可能なクエリ文字列パラメーター](#ID4ECB)
* [認可](#ID4EWC)
* [必須要求ヘッダー](#ID4EDD)
* [要求本文](#ID4EME)
* [HTTP 状態コード](#ID4EZE)
* [応答本文](#ID4EMCAC)

## URI パラメーター

| パラメーター | 型 | 説明 |
| - | - | - |
| xuid | 符号なし 64 ビット整数 | 要求を行うプレイヤーの 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 パラメーターが優先されます。つまり、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 トークンを取得して認可ヘッダーを作成する詳細については、「XBOX LIVE サービス要求の認証と認可」を参照してください。 |

## 要求本文

この要求の本文にはオブジェクトは送信されません。

## HTTP 状態コード

サービスは、このリソースに対してこのメソッドを使用して行われた要求への応答として、このセクションのいずれかの状態コードを返します。XBOX Live サービスで使用される標準 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,binary",
        "clientFileTime":"2012-01-01T01:02:03.1234567Z",
        "displayName":"Friendly Name",
        "size":12,
        "etag":"0x8CEB3E4F8F3A5BF"
    },
    {
        "fileName":"foo\bar\blob2.txt,binary",
        "displayName":"Blob 2",
        "size":4,
        "etag":"0x8CEB3FE57F1A142"
    },
    {
        "fileName":"foo\jsonblob.txt,json",
        "size":15,
        "etag":"0x8CEB40152B4A6F8"
    }
],
"pagingInfo":
    {
        "continuationToken":"54",
    }
}
         
```

## 関連項目

##### 親

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

##### リファレンス  [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/es/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragegetblobmetadataasync.md)