共通するヘッダーおよびエラー・コード

データ転送は多くの標準プロトコルを使用し、固有の要件を持ちます。 共通するヘッダーおよび一部のエラー・コードについては、最新の情報を参照してください。

共通する要求ヘッダー

以下の表は、サポートされている一般的なリクエストヘッダーについて説明したものです。 IBM Cloud® Object Storage は、リクエストの一部として送信された場合、以下に記載されていない一般的なヘッダーをすべて無視しますが、一部のリクエストでは、本書で定義されている追加のヘッダーがサポートされる場合があります。

ヘッダー 注
許可 すべての要求で必須 です (OAuth2 bearer トークン)。
ibm-service-instance-id バケットを作成またはリストする要求では必須です。
Content-MD5 ペイロードの Base64 エンコード 128 ビットのバイナリー MD5 ハッシュ。ペイロードが転送中に変更されなかったことを確認するための保全性検査として使用されます。 Base64 エンコードは、16 進表記ではなく、MD5 ハッシュのバイナリー出力に対して実行されなければなりません。
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 を参照してください。

カスタム・メタデータ

オブジェクト・ストレージを使用する利点の 1 つは、キーと値のペアをヘッダーとして送信することによってカスタム・メタデータを追加できることです。 これらのヘッダーの形式は 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ドキュメントを参照してください