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

コンテナ詳細の表示およびオブジェクトのリスト

get

/v1/{account}/{container}

コンテナの詳細を表示し、コンテナ内のオブジェクトを名前でソートしてリストします。

リクエスト

パス・パラメータ
  • アカウントの一意の名前。 アカウントはプロジェクトまたはテナントとも呼ばれます。
  • コンテナの一意の名前。 コンテナ名は1から256文字の長さにする必要があり、任意の文字から開始でき、任意のパターンを含むことができます。 文字セットはUTF-8である必要があります。 スラッシュ(/)文字はコンテナとオブジェクト名を区切るため、コンテナ名に含めることはできません。 たとえば、/account/container/object。
問合せパラメータ
  • デリミタ値であり、コンテナにネストされているオブジェクト名を返します。
  • 文字列値xについて、marker値より小さいコンテナ名を返します。
  • レスポンスの形式。 有効な値は、json、xmlまたはplainです。 デフォルトはplainです。

    format=xmlまたはformat=json問合せパラメータをストレージ・アカウントURLに追加した場合、レスポンスはその形式でシリアル化された拡張コンテナ情報を表示します。

    format=plain問合せパラメータを追加した場合、レスポンスは改行で区切られたコンテナ名をリストします。

    デフォルト値: plain
    許容値: [ "json", "xml", "plain" ]
  • 最小値: 0
    整数値nについて、結果の数をnに限定します。
  • 文字列値xについて、marker値より大きいコンテナ名を返します。
  • 文字列値について、疑似パスにネストされているオブジェクト名を返します。 デリミタを/に設定し、末尾に/を付けてパスにprefixを設定することと同等です。
  • 接頭辞の値。 レスポンスで指定するアイテムはこの値で開始します。
ヘッダー・パラメータ
  • format問合せパラメータを使用するかわりに、このヘッダーをapplication/json、application/xmlまたはtext/xmlに設定します。
  • 認証トークン。
  • trueに設定した場合、Object Storageはすべてのレプリケーションに問い合せて最新のものを返します。 このヘッダーを省略した場合は、Object Storageは有効なレプリケーションを1つ見つけた後、早くレスポンスします。 このヘッダーをtrueに設定するとバックエンドにとっての費用が高くなるため、どうしても必要な場合のみ使用してください。
トップに戻る

レスポンス

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

200レスポンス

成功。 レスポンス本文にオブジェクトがリストされます。
ヘッダー
  • オブジェクトが受け入れる範囲のタイプ。
  • 最小値: 0
    名前のリストを含むレスポンス本文の長さ。
  • 名前のリストのMIMEタイプ。
  • トランザクションの日付と時刻。

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

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

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

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

  • 最小値: 0
    使用されている合計バイト数。
  • (オプション)クロス・オリジン・リクエストを発行できるオリジンのリスト。 リスト内のエントリはスペースで区切られています。
  • (オプション)実際のリクエスト・レスポンスでユーザー・エージェント(ブラウザなど)に公開されるヘッダーのリスト。 リスト内のエントリはスペースで区切られています。
  • 最小値: 0
    (オプション)オリジンが実行前の結果を保持する最大時間(秒単位)。
  • (オプション)一時URLの秘密キーの値。
  • (オプション)一時URLの2番目の秘密キーの値。 2番目のキーにより、同時に2つのアクティブなキーを持つことでキーを交代で使用できるようになります。
  • カスタム・コンテナ・メタデータ・アイテムであり、{name}はメタデータ・アイテムの名前です。 1つのX-Container-Meta-{name}レスポンス・ヘッダーが、各メタデータ・アイテム(各{name})に対して表示されます。
  • 最小値: 0
    オブジェクトの数。
  • 最小値: 0
    アカウント、コンテナまたはオブジェクトが現在のバージョンとして最初に作成されたUNIX Epochタイムスタンプ形式での日付と時刻。

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

  • このリクエストの一意のトランザクション識別子。 サービス・プロバイダに問題を報告するときに、この値が必要な場合があります。
  • 最小値: 0
    最小値: > true
    (オプション)アップロードされたオブジェクトが削除可能になるまで存在する必要がある日数。
本文 ()
ルート・スキーマ : schema
型: array
ソースの表示
ネストされたスキーマ: items
型: object
ソースの表示
  • 最小値: 0
    アカウントについてObject Storageに格納されている合計バイト数。
  • オブジェクトのコンテンツ・タイプ。
  • オブジェクトの内容のMD5チェックサム値。
  • オブジェクトが前回変更された日付と時刻。

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

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

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

  • コンテナの名前。

204レスポンス

成功。 レスポンス本文にオブジェクトが表示されません。 コンテナにオブジェクトがないか、marker、limitまたはend_marker問合せパラメータを使用して名前の長いリストをページングしているときにリストの最後に達しました。
ヘッダー
  • オブジェクトが受け入れる範囲のタイプ。
  • 最小値: 0
    名前のリストを含むレスポンス本文の長さ。
  • 名前のリストのMIMEタイプ。
  • トランザクションの日付と時刻。

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

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

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

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

  • 最小値: 0
    使用されている合計バイト数。
  • (オプション)クロス・オリジン・リクエストを発行できるオリジンのリスト。 リスト内のエントリはスペースで区切られています。
  • (オプション)実際のリクエスト・レスポンスでユーザー・エージェント(ブラウザなど)に公開されるヘッダーのリスト。 リスト内のエントリはスペースで区切られています。
  • 最小値: 0
    (オプション)オリジンが実行前の結果を保持する最大時間(秒単位)。
  • (オプション)一時URLの秘密キーの値。
  • (オプション)一時URLの2番目の秘密キーの値。 2番目のキーにより、同時に2つのアクティブなキーを持つことでキーを交代で使用できるようになります。
  • カスタム・コンテナ・メタデータ・アイテムであり、{name}はメタデータ・アイテムの名前です。 1つのX-Container-Meta-{name}レスポンス・ヘッダーが、各メタデータ・アイテム(各{name})に対して表示されます。
  • 最小値: 0
    オブジェクトの数。
  • 最小値: 0
    アカウント、コンテナまたはオブジェクトが現在のバージョンとして最初に作成されたUNIX Epochタイムスタンプ形式での日付と時刻。

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

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

401レスポンス

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

403レスポンス

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

404レスポンス

コンテナが存在しないか、作成されたばかりで3つのすべてのノード間でレプリケートされていません。
ヘッダー

416レスポンス

次を超える範囲を指定したGETリクエストに対して返されます。
  • 50の範囲
  • 3つの重なる範囲
  • 8つの非増加範囲
ヘッダー
トップに戻る

例

cURLコマンド

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

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

レスポンスのサンプル

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

HTTP/1.1 200 OK
X-Container-Object-Count: 5
X-Container-Write: myDomain.myservice.Storage_ReadWriteGroup
Accept-Ranges: bytes
X-Timestamp: 1434368768.60255
X-Container-Read: myDomain.myservice.Storage_ReadOnlyGroup,myDomain.myservice.Storage_ReadWriteGroup
X-Container-Bytes-Used: 325079334
X-Trans-Id: tx9b1fba66533046df9b11e-0056c582faga
Date: Thu, 18 Feb 2016 08:38:18 GMT
X-Storage-Class: Standard
X-Container-Meta-Policy-Georeplication: us2
X-Last-Modified-Timestamp: 1450251526.69885
Content-Type: text/plain;charset=utf-8
Content-Length: 235
newobj-aa
newobj-ab
newobj-ac
newobj-ad
newobj-ae
トップに戻る