> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 | 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://docs.xbox.com/ko/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 | 요청이 제한되었습니다. client-retry 값(예: 5초)을 초 단위로 지정한 후 요청을 다시 시도하세요.|

## 응답 본문

호출이 성공하면 서비스는 [TitleBlob](https://docs.xbox.com/ko/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://docs.xbox.com/ko/reference/live/rest/uri/storage/uri-trustedplatformusersxuidscidssciddatapath.md)

##### 참조  [TitleBlob (JSON)](https://docs.xbox.com/ko/reference/live/rest/json/json-titleblob.md)

[PagingInfo (JSON)](https://docs.xbox.com/ko/reference/live/rest/json/json-paginginfo.md)


## Related topics

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