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

> GET (/global/scids/{scid}/data/{path})

# GET (/global/scids/{scid}/data/{path})

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

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

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| 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/zh-CN/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 | 请求已被限流，请在客户端重试值（以秒为单位，例如 5 秒后）之后重试请求。|

## 响应正文

如果调用成功，服务将返回一个 [TitleBlob](https://devdocs.xbox.com/zh-CN/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",
    }
}
         
```

## 另请参阅

##### 上级

[/global/scids/{scid}/data/{path}](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-globalscidssciddatapath)

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

[PagingInfo (JSON)](https://devdocs.xbox.com/zh-CN/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)