GET (/global/scids/{scid}/data/{pathAndFileName},{type})

파일을 다운로드합니다. 이 URI의 도메인은 titlestorage.xboxlive.com입니다.

• URI 매개 변수
• 권한 부여
• 선택적 쿼리 문자열 매개 변수
• 필수 요청 헤더
• 선택적 요청 헤더
• 요청 본문
• HTTP 상태 코드
• 응답 헤더
• 응답 본문

​

URI 매개 변수

​

권한 부여

요청에는 유효한 XBOX LIVE 권한 부여 헤더가 포함되어야 합니다. 호출자가 이 리소스에 액세스할 수 없는 경우 서비스는 403 Forbidden 응답을 반환합니다. 헤더가 유효하지 않거나 누락된 경우 서비스는 401 Unauthorized 응답을 반환합니다.

​

선택적 쿼리 문자열 매개 변수

Blob 유형에 따라 다릅니다. 이진 Blob은 쿼리 매개 변수를 지원하지 않습니다. | 매개 변수| 유형| 설명| | --- | --- | --- | --- | --- | --- | | select| string| type이 json인 경우에만 사용할 수 있습니다. 이 매개 변수에 의해 결정된 JSON의 특정 속성/값만 응답에 포함되도록 지정합니다. 하위 속성을 지정하려면 “점”(.)을, 배열 인덱스를 지정하려면 대괄호(’[‘와 ’]‘)를 사용합니다. 예를 들어 “array1[4].prop2”는 “array1” 배열의 인덱스 4에 있는 “prop2” 속성을 지정합니다.| | customSelector| string| config 유형 파일용입니다. 포함할 사용자 지정 가상 노드를 나타냅니다. config 유형 파일에 대한 자세한 내용은 Title Storage를 참조하세요.|

​

필수 요청 헤더

| 헤더| 값| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| 1| API 계약 버전입니다.| | Authorization| XBL3.0 x=[hash];[token]| STS 인증 토큰입니다. STSTokenString은 인증 요청에서 반환된 토큰으로 대체됩니다. STS 토큰 검색 및 권한 부여 헤더 생성에 대한 자세한 내용은 Authenticating and Authorizing XBOX LIVE Services Requests를 참조하세요.|

​

선택적 요청 헤더

| 헤더| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | If-Match| 작업을 완료하기 위해 기존 항목과 일치해야 하는 ETag를 지정합니다.| | If-None-Match| 작업을 완료하기 위해 기존 항목과 일치하지 않아야 하는 ETag를 지정합니다.| | Range| 다운로드할 바이트 범위를 지정합니다. 표준 HTTP Range 헤더 형식을 따릅니다.|

​

요청 본문

이 요청의 본문에는 어떠한 개체도 전송되지 않습니다.

​

HTTP 상태 코드

서비스는 이 리소스에 대해 이 메서드로 만든 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용하는 표준 HTTP 상태 코드의 전체 목록은 표준 HTTP 상태 코드를 참조하세요. | 코드| 이유 문구| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 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초)을 초 단위로 지정한 후 요청을 다시 시도하세요.|

​

응답 헤더

| 헤더| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | ETag| ETag는 웹 서버가 URL에서 찾은 리소스의 특정 버전에 할당한 불투명한 식별자입니다. 해당 URL의 리소스 콘텐츠가 변경되면 새롭고 다른 ETag가 할당됩니다.| | Content-Range| 부분 다운로드인 경우 이 헤더는 다운로드된 바이트 범위를 지정합니다.|

​

응답 본문

호출이 성공하면 서비스는 파일 내용을 반환합니다.

​

참고 항목

​

부모

/global/scids//data/,

​

참조 TitleBlob (JSON)