常見標頭和錯誤碼

資料傳送使用許多標準通訊協定，並且具有獨特性需求。 請保持一般標頭和一些錯誤代碼的最新參考資訊。

一般要求標頭

下表列出了受支援的常見請求標頭。若請求中包含未列於下表的常見標頭，IBM Cloud® Object Storage 將忽略該標頭；不過，某些請求可能會支援本文件中定義的額外標頭。

標頭 附註
授權 對於所有要求而言，是必要項目（OAuth2 bearer 記號）。
ibm-service-instance-id 對於建立或列出儲存區的要求，是必要項目。
Content-MD5 有效負載的 base64 編碼 128 位元二進位 MD5 雜湊，用來作為完整性檢查，以確保未在傳輸中變更有效負載。 必須對 MD5 雜湊的二進位輸出執行 base64 編碼，而不是採用十六進位表示。
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

自訂 meta 資料

使用 Object Storage 的優點是可以將鍵值組作為標頭傳送，以新增自訂 meta 資料。 這些標頭的格式為 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 如果物件具有轉移 meta 資料，並傳回轉移的層級及原始時間，則會包含此項目。
x-ibm-restored-copy-storage-class 如果物件處於 RestoreInProgress 或 Restored 狀態，並傳回儲存區的儲存空間類別，則會包含此項目。

有關 錯誤代碼 的清單，請參閱 API 文件