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

コンテナ・メタデータの作成、更新または削除

post

/v1/{account}/{container}

コンテナのカスタム・メタデータを作成、更新または削除します。

リクエスト

パス・パラメータ
  • アカウントの一意の名前。 アカウントはプロジェクトまたはテナントとも呼ばれます。
  • コンテナの一意の名前。 コンテナ名は1から256文字の長さにする必要があり、任意の文字から開始でき、任意のパターンを含むことができます。 文字セットはUTF-8である必要があります。 スラッシュ(/)文字はコンテナとオブジェクト名を区切るため、コンテナ名に含めることはできません。 たとえば、/account/container/object。
ヘッダー・パラメータ
  • 認証トークン。
  • クロス・オリジン・リクエストを発行できるオリジンのリスト。 リスト内のエントリはスペースで区切られています。
  • 実際のリクエスト・レスポンスでユーザー・エージェント(ブラウザなど)に公開されるヘッダーのリスト。 リスト内のエントリはスペースで区切られています。
  • 最小値: 0
    オリジンが実行前の結果を保持する最大時間(秒単位)。
  • 最小値: 0
    コンテナの最大サイズを設定します(バイト)。 通常、この値は管理者によって設定されます。 オブジェクトPUT操作がこの割当て制限値を超える場合、413レスポンス(request entity too large)を返します。
  • 最小値: 0
    コンテナの最大オブジェクト数を設定します。 通常、この値は管理者によって設定されます。 オブジェクトPUT操作がこの割当て制限値を超える場合、413レスポンス(request entity too large)を返します。
  • 一時URLの秘密キーの値。
  • 一時URLの2番目の秘密キーの値。 2番目のキーにより、同時に2つのアクティブなキーを持つことでキーを交代で使用できるようになります。
  • コンテナ・メタデータであり、{name}はメタデータ・アイテムの名前です。 追加または更新する各メタデータ・アイテム(各{name})に対してX-Container-Meta-{name}ヘッダーを指定する必要があります。
  • 読取りアクセス権を付与するコンテナ・アクセス制御リスト(ACL)を設定します。 コンテナACLは、任意のObject Storageクラスタ上で利用でき、クラスタではなくコンテナによって有効化されます。 コンテナ読取りACLを設定するには: 
    $ curl -X {PUT|POST} -i -H 'X-Auth-Token: TOKEN' -H \
    'X-Container-Read: ACL' STORAGE_URL/CONTAINER
    コマンドで、次のようにX-Container-ReadヘッダーにACLを指定します。
    • .r:*-すべてのリファラ。
    • .r:example.com,swift.example.com-カンマ区切りのリファラのリスト。
    • .rlistings-コンテナ・リスト・アクセス。
  • 書込みアクセス権を付与するACLを設定します。
  • メタデータX-Container-Meta-{name}を削除します。ここで、{name}はメタデータ・アイテムの名前です。 ヘッダーの値は無視されます。
  • {name}という名前のメタデータ・アイテムを削除します。 たとえば、X-Remove-Container-ReadはX-Container-Readメタデータ・アイテムを削除します。
  • 最小値: 1
    PUTまたはPOSTで上書きまたは削除できるようになるまでに、オブジェクトがアップロードされた後にコンテナに存在する必要がある最小日数。
トップに戻る

レスポンス

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

204レスポンス

成功
ヘッダー
  • 最小値: 0
    最大値: 0
    この値はゼロ(0)です。
  • トランザクションの日付と時刻。

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

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

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

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

  • 最小値: 0
    アカウント、コンテナまたはオブジェクトが現在のバージョンとして最初に作成されたUNIX Epochタイムスタンプ形式での日付と時刻。

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

  • このリクエストの一意のトランザクション識別子。 サービス・プロバイダに問題を報告するときに、この値が必要な場合があります。

400レスポンス

失敗 X-Worm-Expiration-Daysヘッダーの値が無効です。 0より大きい有効な整数である必要があります。 このエラーは、コンテナにX-Worm-Expiration-Daysメタデータがすでに指定されている場合、またはコンテナにオブジェクトがすでに存在する場合にも発生します。
ヘッダー
  • 最小値: 1
    この値はレスポンス本文のエラー・テキストの長さです。
  • この値はレスポンス本文のエラー・テキストのMIMEタイプです。
  • トランザクションの日付と時刻。

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

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

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

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

  • このリクエストの一意のトランザクション識別子。 サービス・プロバイダに問題を報告するときに、この値が必要な場合があります。

401レスポンス

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

404レスポンス

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

413レスポンス

最大コンテナ・サイズまたはコンテナごとの最大オブジェクト数を超過しました
ヘッダー
トップに戻る

例

cURLコマンド

次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、事前定義されたロールStorage_ReadWriteGroupおよびカスタム・ロールmyCustomRoleを持つすべてのユーザーに、FirstContainerというコンテナに対する書込みアクセス権を付与する方法を示しています。

cURLの詳細は、「cURLの使用」を参照してください。 

curl -v -X POST \
     -H "X-Auth-Token: AUTH_tkb4fdf39c92e9f62cca9b7c196f8b6e6b" \
     -H "X-Container-Write:myDomain.myservice.Storage_ReadWriteGroup,myDomain.myCustomRole" \
     https://foo.storage.oraclecloud.com/v1/myservice-bar/FirstContainer

レスポンスのサンプル

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

HTTP/1.1 204 No Content
Date: Fri, 06 Mar 2015 11:19:21 GMT
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txbf2c736d57494bf88e76a-0054f98d39
Content-Language: en

  • 読み取りアクセスを提供する方法やコンテナのクォータを設定する方法の例については、「Oracle Cloud Infrastructure Object Storage Classicの使用」の「コンテナ・メタデータの設定」を参照してください。

  • CORSヘッダーの設定方法の例については、「Oracle Cloud Infrastructure Object Storage Classicの使用」の「コンテナのCORSの有効化」を参照してください。

トップに戻る