공통 헤더 및 오류 코드
데이터 전송은 많은 표준 프로토콜을 사용하며 고유한 요구사항을 갖습니다. 공통 헤더 및 일부 오류 코드에 대한 참조를 지속적으로 확인하십시오.
공통 요청 헤더
다음 표에는 지원되는 일반적인 요청 헤더가 설명되어 있습니다. IBM Cloud® Object Storage 은 요청의 일부로 전송된 경우, 아래에 나열되지 않은 일반적인 헤더는 모두 무시하지만, 일부 요청의 경우 본 문서에 정의된 추가 헤더를 지원할 수도 있습니다.
| 헤더 | 참고 |
|---|---|
| 권한 | 모든 요청에 대해 필수(OAuth2 bearer 토큰). |
ibm-service-instance-id |
버킷 작성 또는 나열 요청에 대해 필수. |
Content-MD5 |
페이로드의 base64 인코딩 128비트 2진 MD5 해시이며, 페이로드가 전송 중에 변경되지 않았는지 확인하기 위한 무결성 검사로 사용됩니다. base64 인코딩은 16진 표시가 아니라 MD5 해시의 2진 출력에서 수행되어야 합니다. |
x-amz-checksum-crc32 |
이 헤더는 개체의 Base64 인코딩된 32비트 CRC32 체크섬입니다. |
x-amz-checksum-crc32c |
이 헤더는 개체의 Base64 인코딩된 32비트 CRC32C 체크섬입니다. |
x-amz-checksum-crc64nvme |
이 헤더는 개체의 Base64 인코딩된 64비트 CRC64NVME 체크섬입니다. CRC64NVME 체크섬은 항상 전체 객체 체크섬입니다. |
x-amz-checksum-sha1 |
이 헤더는 개체의 Base64 인코딩된 160비트 SHA1 다이제스트입니다. |
x-amz-checksum-sha256 |
이 헤더는 개체의 Base64 인코딩된 256비트 SHA256 다이제스트입니다. |
x-amz-sdk-checksum-algorithm |
SDK를 사용할 때 오브젝트의 체크섬을 생성하는 데 사용되는 알고리즘을 나타냅니다. |
Expect |
100-continue 값은 페이로드를 전송하기 전에 헤더가 적합하다는 시스템의 수신확인을 대기합니다. |
host |
{bucket-name}.{endpoint}의 '가상 호스트' 구문 또는 엔드포인트입니다. 일반적으로 이 헤더는 자동으로 추가됩니다. 엔드포인트에 대한 자세한 정보는 엔드포인트 및 스토리지 위치를 참조하십시오. |
Cache-Control |
요청/응답 체인에 따라 캐싱 동작을 지정하는 데 사용할 수 있습니다. 자세한 정보는 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9 페이지를 참조하십시오. |
사용자 정의 메타데이터
Object Storage 사용의 이점은 키-값 쌍을 헤더로서 보내 사용자 정의 메타데이터를 추가하는 기능입니다. 이러한 헤더는 x-amz-meta-{KEY} 양식을 사용합니다. AWS S3 와 달리, IBM Cloud Object Storage 는 동일한 메타데이터 키를 가진 여러 헤더를 쉼표로 구분된 값 목록으로 결합한다는 점에 유의하십시오.
공통 응답 헤더
다음 표에서는 공통 응답 헤더를 설명합니다.
| 헤더 | 참고 |
|---|---|
Content-Length |
요청 본문의 길이(바이트)입니다. |
Connection |
연결이 열려 있는지 또는 닫혀 있는지를 표시합니다. |
Date |
요청의 시간소인입니다. |
ETag |
요청의 MD5 해시 값입니다. |
Server |
응답 서버의 이름입니다. |
X-Clv-Request-Id |
요청마다 생성된 고유 ID입니다. |
라이프사이클 응답 헤더
다음 표에서는 아카이브된 오브젝트의 응답 헤더를 설명합니다.
| 헤더 | 참고 |
|---|---|
x-amz-restore |
오브젝트가 복원되었거나 복원이 진행 중인 경우 포함됩니다. |
x-amz-storage-class |
아카이브 처리되었거나 일시적으로 복원된 경우, GLACIER 또는 ACCELERATED 를 반환합니다. |
x-ibm-archive-transition-time |
오브젝트가 아카이브 티어로 전이되도록 스케줄된 날짜 및 시간을 리턴합니다. |
x-ibm-transition |
오브젝트에 전이 메타데이터가 있고 전이의 원래 시간과 티어를 리턴하는 경우 포함됩니다. |
x-ibm-restored-copy-storage-class |
오브젝트가 RestoreInProgress 또는 Restored 상태이고 버킷의 스토리지 클래스를 리턴하는 경우에 포함됩니다. |
오류 코드 목록은 API 문서를 참조하십시오