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

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

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

列出指定路径下的文件信息。
这些 URI 的域为 `titlestorage.xboxlive.com`。

* [URI 参数](#ID4EX)
* [可选的查询字符串参数](#ID4ECB)
* [授权](#ID4EWC)
* [必需的请求标头](#ID4EDD)
* [请求正文](#ID4EME)
* [HTTP 状态代码](#ID4EZE)
* [响应正文](#ID4EMCAC)

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| xuid | 64 位无符号整数 | 发出请求的玩家的 XBOX User 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 令牌和创建授权标头的更多信息,请参见 Authenticating and Authorizing XBOX LIVE Services Requests。 |

## 请求正文

此请求的正文中不发送任何对象。

## HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的某个状态代码。有关与 XBOX Live 服务一同使用的标准 HTTP 状态代码的完整列表,请参见 [标准 HTTP 状态代码](https://devdocs.xbox.com/zh-CN/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 | 请求已被限流,请在客户端重试值(以秒为单位,例如 5 秒后)之后再次发送请求。 |

## 响应正文

如果调用成功,该服务将返回 [TitleBlob](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-titleblob.md) 对象的数组。

### 响应示例

```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",
    }
}
         
```

## 另请参阅

##### 父主题

[/trustedplatform/users/xuid({xuid})/scids/{scid}/data/{path}](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-trustedplatformusersxuidscidssciddatapath.md)

##### 参考资料  [TitleBlob (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-titleblob.md)

[PagingInfo (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-paginginfo.md)


## Related topics

- [/trustedplatform/users/xuid({xuid})/scids/{scid}/data/{path}](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-trustedplatformusersxuidscidssciddatapath.md)
- [GET (/trustedplatform/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},{type})](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-trustedplatformusersxuidscidssciddatapathandfilenametype-get.md)
- [/trustedplatform/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},{type}](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-trustedplatformusersxuidscidssciddatapathandfilenametype.md)
- [DELETE (/trustedplatform/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},{type})](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-trustedplatformusersxuidscidssciddatapathandfilenametype-delete.md)
- [PUT (/trustedplatform/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},{type})](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-trustedplatformusersxuidscidssciddatapathandfilenametype-put.md)