機械翻訳について
  1. Oracle Cloud Infrastructure Object Storage Classicのアーカイブ・ストレージ用REST API
  2. タスク
  3. オブジェクト

オブジェクト・メタデータの表示

head

/v1/{account}/{container}/{object}

オブジェクト・メタデータを表示します。

リクエスト

パス・パラメータ
  • アカウントの一意の名前。 アカウントはプロジェクトまたはテナントとも呼ばれます。
  • コンテナの一意の名前。 コンテナ名は1から256文字の長さにする必要があり、任意の文字から開始でき、任意のパターンを含むことができます。 文字セットはUTF-8である必要があります。 スラッシュ(/)文字はコンテナとオブジェクト名を区切るため、コンテナ名に含めることはできません。 たとえば、/account/container/object。
  • オブジェクトの一意の名前。
問合せパラメータ
  • 最小値: 0
    一時URLの署名の有効期限が切れるUNIX Epochタイムスタンプ形式での日付と時刻。

    たとえば、1440619048はMon, Wed, 26 Aug 2015 19:57:28 GMTと同等です。

  • 一時URLとともに使用して、許可されるHTTPメソッド、有効期限日、オブジェクトへのフル・パス、および一時URLの秘密キーを定義するHMAC-SHA1暗号署名付きリクエストに署名します。
ヘッダー・パラメータ
  • 認証トークン。 temp_url_sigおよびtemp_url_expiresが存在する場合は指定されません。 それ以外の場合は、このヘッダーを省略すると、アカウント所有者がアクセス制御リスト(ACL)を通じてアクセスを許可していない限り、リクエストは失敗します。
  • trueに設定した場合、Object Storageはすべてのレプリケーションに問い合せて最新のものを返します。 このヘッダーを省略した場合は、Object Storageは有効なレプリケーションを1つ見つけた後、早くレスポンスします。 このヘッダーをtrueに設定するとバックエンドにとっての費用が高くなるため、どうしても必要な場合のみ使用してください。
トップに戻る

レスポンス

サポートされているメディア・タイプ

200レスポンス

成功
ヘッダー
  • (オプション)設定した場合、ブラウザの上書き動作を指定します。 たとえば、このヘッダーは、このファイルを表示する(デフォルト)のではなく、ブラウザがダウンロード・プログラムを使用してこのファイルを保存することを指定します。

    設定していない場合、このヘッダーはこの操作で返されません。

  • (オプション)設定した場合、Content-Encodingメタデータの値。

    設定していない場合、操作はこのヘッダーを返しません。

  • 最小値: 0
    HEAD操作は内容を返しません。 Content-Lengthヘッダー値は、レスポンス本文のサイズではなく、オブジェクトのサイズです(バイト)。
  • オブジェクトのMIMEタイプ。
  • トランザクションの日付と時刻。

    日付と時刻のスタンプ形式はISO 8601です。

    CCYY-MM-DDThh:mm:ss±hh:mm
    たとえば、2015-08-27T09:49:58-05:00のようになります。

    ±hh:mm値(含まれている場合)は、UTCからのオフセットとしてのタイム・ゾーンです。 前述の例では、オフセット値は-05:00です。

    null値はトークンの有効期限が切れないことを示します。

  • 5 GBより小さいオブジェクトの場合、この値はオブジェクトの内容のMD5チェックサムです。 値は引用符で囲まれません。

    マニフェスト・オブジェクトの場合、この値は、マニフェスト内の各セグメントのMD5チェックサムとETagの連結文字列のMD5チェックサムであり、ダウンロードされた内容のMD5チェックサムではありません。 また、値は二重引用文字で囲まれます。

    レスポンスを受信したときにレスポンス本文のMD5チェックサムを計算し、その値をETagヘッダー内の値と比較することをお薦めします。 それらが異なる場合は、内容が破損しているため操作を再試行してください。

  • オブジェクトが作成された、またはそのメタデータが変更された日付と時刻。

    日付と時刻のスタンプ形式はISO 8601です。

    CCYY-MM-DDThh:mm:ss±hh:mm
    たとえば、2015-08-27T09:49:58-05:00のようになります。

    ±hh:mm値(含まれている場合)は、UTCからのオフセットとしてのタイム・ゾーンです。 前述の例では、オフセット値は-05:00です。

  • リストア済オブジェクトの有効期限が切れることがスケジュールされている時刻。 このヘッダーは、完全にリストアされたオブジェクトに対してのみ返されることに注意してください。
  • アーカイブ済オブジェクトの状態
    許容値: [ "Archived", "Restored", "InProgress" ]
  • ステータスがArchivedまたはInProgressの場合、追跡URLが指定されます。

    URLは、http://{storage_url}/v1/{account}/{container}?jobs&jobId={restore_jobid}の形式です。

  • 最小値: 0
    (オプション)設定した場合、システムがオブジェクトを削除するUNIX Epochタイムスタンプ形式での日付と時刻。

    たとえば、1440619048はMon, Wed, 26 Aug 2015 19:57:28 GMTと同等です。

    設定していない場合、この操作はこのヘッダーを返しません。

  • (オプション)設定した場合、これは動的ラージ・オブジェクトのマニフェスト・オブジェクトです。 値は、形式container/prefixのセグメント・オブジェクトのコンテナおよびオブジェクト名接頭辞です。
  • カスタム・オブジェクト・メタデータ・アイテムであり、{name}はメタデータ・アイテムの名前です。

    1つのX-Object-Meta-{name}レスポンス・ヘッダーが、各メタデータ{name}アイテムに対して表示されます。

  • このオブジェクトが静的ラージ・オブジェクトのマニフェスト・オブジェクトの場合、Trueに設定します。
  • 最小値: 0
    アカウント、コンテナまたはオブジェクトが現在のバージョンとして最初に作成されたUNIX Epochタイムスタンプ形式での日付と時刻。

    たとえば、1440619048はMon, Wed, 26 Aug 2015 19:57:28 GMTと同等です。

  • このリクエストの一意のトランザクションID。 サービス・プロバイダに問題を報告するときに、この値が必要な場合があります。
  • 最小値: 0
    (オプション)アップロードされたオブジェクトが削除可能になるまで存在する必要があるEpoch時間。 値は現在のEpoch時間より大きくなります。

401レスポンス

リクエストに認証トークンが含まれていないか、リクエストで指定した認証トークンが無効です。 期限切れになっている可能性があります。 認証トークンは30分後に失効します。
ヘッダー

403レスポンス

禁止。 考えられる原因:
  • Oracle Cloud My Servicesでサービスにデータ・センターが選択されていません。
  • リクエストが誤ったデータ・センターに送信されました。 たとえば、サービスのデータ・センターはChicago (us2)ですが、リクエストはAshburn (us6)データ・センターに対応するURLに送信されました。
  • 指定されたコンテナに対して操作を実行するために必要な権限がありません。 たとえば、ユーザーに割り当てられたロールや、リクエストに指定されたコンテナのアクセス権定義が変更される場合があります。
  • 指定した操作は、アーカイブ済オブジェクトまたはストレージ・クラスがArchiveのコンテナに対して許可されていません
  • 期限切れになっていないオブジェクトをPUT、POSTまたはDELETEしようとするか、既存のコンテナ・レベルWORMポリシーを更新しようとして、コンテナまたはオブジェクト・レベルWORMポリシーに違反しています。
ヘッダー

404レスポンス

オブジェクトが存在しないか、作成されたばかりで3つのすべてのノード間でレプリケートされていません。
ヘッダー
トップに戻る

例

cURLコマンド

次の例は、cURLを使用してRESTリソースにHEADリクエストを送信することにより、Oracle Cloud Infrastructure Object Storage Classic内のアカウントのコンテナ内のオブジェクトに関する情報を取得する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。 

curl -v -X HEAD \
     -H "X-Auth-Token: AUTH_tkb4fdf39c92e9f62cca9b7c196f8b6e6b" \
     https://foo.storage.oraclecloud.com/v1/myservice-bar/FirstContainer/myObject

レスポンスのサンプル

次に、このコマンドのレスポンスのサンプルを示します。

HTTP/1.1 200 OK
Accept-Ranges: bytes
Last-Modified: Wed, 16 Dec 2015 08:14:17 GMT
Etag: f1c9645dbc14efddc7d8a322685f26eb
X-Timestamp: 1450253656.45313
Date: Thu, 28 Jan 2016 08:56:32 GMT
Content-Length: 10485760
Content-Type: application/octet-stream;charset=UTF-8
X-Trans-Id: tx23a1084b8c674fdeae8d4-0054f982ac
X-Last-Modified-Timestamp: 1450253656.45313
トップに戻る