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

<a id="ID4EX" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| xuid | 不帶正負號的 64 位元整數 | 提出要求之玩家的 XBOX 使用者識別碼 (XUID)。 |
| scid | guid | 要查閱之服務設定的識別碼。 |
| path | 字串 | 要傳回之資料項目的路徑。所有相符的目錄和子目錄都會傳回。有效字元包括大寫字母 (A-Z)、小寫字母 (a-z)、數字 (0-9)、底線 (\_) 和正斜線 (/)。可以是空的。長度上限為 256。 |

<a id="ID4ECB" />

## 選擇性查詢字串參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- | --- | --- |
\| skipItems| int| 從集合中的第 N+1 個項目開始傳回項目，例如，略過 N 個項目。|
\| continuationToken| 字串| 從指定的接續權杖開始傳回項目。如果同時提供 continuationToken 參數和 skipItems，則 continuationToken 參數優先。換句話說，如果有 continuationToken 參數，則會忽略 skipItems 參數。|
\| maxItems| int| 要從集合傳回的項目數目上限，可與 skipItems 和 continuationToken 結合以傳回某個範圍的項目。如果沒有 maxItems，服務可能會提供預設值，而且即使尚未傳回最後一頁結果，也可能傳回少於 maxItems 的項目。 |

<a id="ID4EWC" />

## 授權

要求必須包含有效的 XBOX LIVE 授權標頭。如果不允許呼叫者存取此資源，服務將傳回 403 Forbidden 回應。如果標頭無效或遺漏，服務將傳回 401 Unauthorized 回應。

<a id="ID4EDD" />

## 必要的要求標頭

\| 標頭| 值| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| 1| API 合約版本。|
\| Authorization| XBL3.0 x=\[hash];\[token]| STS 驗證權杖。STSTokenString 會由驗證要求所傳回的權杖取代。如需擷取 STS 權杖及建立授權標頭的詳細資訊，請參閱「驗證和授權 XBOX LIVE 服務要求」。|

<a id="ID4EME" />

## 要求本文

此要求的本文中不會傳送任何物件。

<a id="ID4EZE" />

## HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼，以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單，請參閱[標準 HTTP 狀態碼](/zh-TW/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 秒後) 再次嘗試要求。|

<a id="ID4EMCAC" />

## 回應本文

如果呼叫成功，服務將傳回 [TitleBlob](/zh-TW/reference/live/rest/json/json-titleblob) 物件的陣列。

<a id="ID4E1CAC" />

### 範例回應

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

<a id="ID4EGDAC" />

## 另請參閱

<a id="ID4EIDAC" />

##### 上層

[/trustedplatform/users/xuid({xuid})/scids/{scid}/data/{path}](/zh-TW/reference/live/rest/uri/storage/uri-trustedplatformusersxuidscidssciddatapath)

<a id="ID4EUDAC" />

##### 參考  [TitleBlob (JSON)](/zh-TW/reference/live/rest/json/json-titleblob)

[PagingInfo (JSON)](/zh-TW/reference/live/rest/json/json-paginginfo)


## Related topics

- [XblTitleStorageGetQuotaAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragegetquotaasync.md)
- [XblTitleStorageDownloadBlobAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)