PutContainer
    • PDF

    PutContainer

    • PDF

    記事の要約

    Classic/VPC環境で利用できます。

    コンテナ(バケット)を作成します。

    参考

    Subaccountの場合、Subaccount専用の External API Gatewayを通じて使用できます。
    詳細は、SubAccountのPutContainer APIをご参照ください。

    リクエスト

    リクエスト形式を説明します。リクエスト形式は次の通りです。

    メソッドURI
    PUT/v1/AUTH_{project_id}/{container}

    リクエストヘッダ

    ヘッダの説明は次の通りです。

    フィールドタイプ必須の有無説明
    X-Auth-TokenStringRequired発行したトークン(Token)の値
    X-Container-ReadStringOptionalコンテナ(バケット)の READ ACL(アクセス権限)
    X-Container-WriteStringOptionalコンテナ(バケット)の WRITE ACL(アクセス権限)
    X-Container-Sync-KeyStringOptional使用しない
    X-Container-Sync-ToStringOptional使用しない
    X-Versions-LocationStringOptional使用しない
    X-History-LocationStringOptional使用しない
    X-Container-Meta-nameStringOptionalコンテナ(バケット)のメタデータ
    • ヘッダ名のname部分がメタデータのキーの役割を果たす
    • 追加、アップデート、削除が可能で、削除は空の値でリクエスト
    X-Container-Meta-Access-Control-Allow-OriginStringOptionalCORS設定
    • アクセス可能なソースドメイン
    X-Container-Meta-Access-Control-Max-AgeStringOptionalCORS設定(秒)
    • 結果をキャッシュできる最大時間
    X-Container-Meta-Access-Control-Expose-HeadersStringOptionalCORS設定
    • 公開はされないが、アクセスを許可するヘッダ
    X-Container-Meta-Quota-BytesStringOptionalコンテナ(バケット)の容量制限値
    X-Container-Meta-Quota-CountStringOptionalコンテナ(バケット)のオブジェクト数の制限値
    X-Container-Meta-Temp-URL-KeyStringOptionaltemporary URLのための Secret Key値
    X-Container-Meta-Temp-URL-Key-2StringOptionaltemporary URLのための2番目の Secret Key値

    リクエストパスパラメータ

    パラメータの説明は次の通りです。

    フィールドタイプ必須の有無説明
    project_idStringRequiredプロジェクト ID
    containerStringRequired作成するコンテナ(バケット)の名前

    リクエスト例

    リクエストのサンプルコードは次の通りです。

    コンテナ(バケット)の作成リクエスト

    コンテナ(バケット)を作成するリクエストのサンプルコードは次の通りです。

    curl -X PUT "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}" 
    -H "X-Auth-Token: $token"
    

    メタデータを含むコンテナ(バケット)の作成リクエスト

    メタデータを含むコンテナ(バケット)を作成するリクエストのサンプルコードは次の通りです。

    curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}" 
    -H "X-Auth-Token: $token"
    -H "X-Container-Meta-{name}: $container-metadata-string"
    

    ACLを含むコンテナ(バケット)の作成リクエスト

    ACLを含むコンテナ(バケット)を作成するリクエストのサンプルコードは次の通りです。

    curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}" 
    -H "X-Auth-Token: $token"
    -H "X-Container-Read: .r:*
    

    レスポンス

    レスポンス形式を説明します。

    レスポンスヘッダ

    Archive Storage APIで共通して使用されるレスポンスヘッダの詳細は、Archive Storageの共通レスポンスヘッダをご参照ください。

    レスポンスステータスコード

    レスポンスステータスコードの説明は次の通りです。

    HTTPステータスコードコードメッセージ説明
    200-OKリクエスト成功
    204-No ContentContent-Typeがplainで、リクエストに該当する内容がない場合に発生
    403-Not Foundコンテナ(バケット)が存在しない場合に発生

    レスポンス例

    レスポンスのサンプルコードは次の通りです。

    コンテナの作成をリクエストした場合のレスポンス

    コンテナの作成をリクエストした場合、レスポンスのサンプルコードは次の通りです。

    HTTP/1.1 201 Created
    Content-Length: 0
    Content-Type: text/html; charset=UTF-8
    X-Trans-Id: txa8b5404ac864437293727-005b9878d1
    X-Openstack-Request-Id: txa8b5404ac864437293727-005b9878d1
    Date: Wed, 12 Sep 2018 02:24:17 GMT
    

    メタデータを含むコンテナの作成をリクエストした場合のレスポンス

    メタデータを含むコンテナの作成をリクエストした場合、レスポンスのサンプルコードは次の通りです。

    HTTP/1.1 201 Created
    Content-Length: 0
    Content-Type: text/html; charset=UTF-8
    X-Trans-Id: tx8282719a30554e2b8e0c7-005b987946
    X-Openstack-Request-Id: tx8282719a30554e2b8e0c7-005b987946
    Date: Wed, 12 Sep 2018 02:26:14 GMT
    

    ACLを含むコンテナの作成をリクエストした場合のレスポンス

    ACLを含むコンテナの作成をリクエストした場合、レスポンスのサンプルコードは次の通りです。

    HTTP/1.1 201 Created
    Content-Length: 0
    Content-Type: text/html; charset=UTF-8
    X-Trans-Id: tx691a8ed48a3f4152ae904-005b98799c
    X-Openstack-Request-Id: tx691a8ed48a3f4152ae904-005b98799c
    Date: Wed, 12 Sep 2018 02:27:41 GMT
    

    この記事は役に立ちましたか?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.