PostContainer

Prev Next

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

コンテナ(バケット)にメタデータを設定したり、変更したりします。

リクエスト

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

メソッド URI
POST /{containerName}

リクエストヘッダ

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

フィールド タイプ 必須の有無 説明
x-ncp-apigw-timestamp String Required タイムスタンプの値
  • 1970年1月1日 00:00:00協定世界時(UTC)からの経過時間をミリ秒で表したもの
  • API Gatewayサーバとの時間差が5分以上の場合は有効ではないリクエストとみなす
x-ncp-iam-access-key String Required NAVERクラウドプラットフォームで発行された API Keyまたは Sub Accountで発行された Access Key
x-ncp-apigw-signature-v2 String Required Bodyを Access Key IDとマッピングする Secret Keyで暗号化した署名
  • HMACの暗号化アルゴリズムは HmacSHA256を使用
x-ncp-region_code String Required コンテナのリージョンコード
  • <例> 韓国: KR | シンガポール: SGN
X-Container-Meta-Access-Control-Allow-Origin String Optional CORS設定
  • アクセス可能なソースドメイン
X-Container-Meta-Access-Control-Max-Age String Optional CORS設定
  • 結果をキャッシュできる最大時間(秒)
X-Container-Meta-Access-Control-Expose-Headers String Optional CORS設定
  • 公開はされないが、アクセスを許可するヘッダ

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

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

フィールド タイプ 必須の有無 説明
containerName String Required 設定または変更するコンテナ(バケット)の名前

リクエスト例

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

curl -X POST "https://archivestorage.apigw.ntruss.com/swift/v1/{containerName}" -H "accept: application/json" -H "X-Container-Meta-Access-Control-Allow-Origin: http://localhost" -H "x-ncp-region-code: {regionCode}"
-H "x-ncp-iam-access-key: {AccessKey} "
-H "x-ncp-apigw-timestamp: {current timestamp}"
-H "x-ncp-apigw-signature-v2: {generated signature}"

レスポンス

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

レスポンスヘッダ

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

フィールド タイプ 必須の有無 説明
Server String - レスポンスサーバ
Date String - リクエストのレスポンスタイム(UTC)
Connection String - クライアントとサーバ間の TCP接続状態
X-Storage-Policy Integer - コンテナのストレージポリシーの値
X-Timestamp Integer - コンテナが作成された時刻(Unix Timestamp)
X-Container-Bytes-Used Integer - コンテナが使用中の容量
X-Trans-Id String - リクエストのトランザクション ID
X-Openstack-Request-Id String - リクエストのトランザクション ID
  • X-Trans-Idと同じ
X-Container-Object-Count Integer - コンテナに保存されているオブジェクト数
X-Container-Meta-Access-Control-Allow-Origin String - CORS設定
  • 入力されたアクセス可能なドメイン
Referrer-Policy String - HTTP Referrerヘッダの処理方式
x-ncp-apigw-response-origin String - レスポンスの原本の出典
x-ncp-trace-id String - トランザクショントレース用 ID

レスポンス例

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

HTTP/1.1 204 No Content
Server: nginx
Date: Tue, 16 Apr 2024 01:56:58 GMT
Connection: keep-alive
X-Storage-Policy: standard00
X-Timestamp: 1711960998.26335
X-Container-Bytes-Used: 0
X-Openstack-Request-Id: txf770951820a44a91bc450-00661de4f8
X-Container-Object-Count: 0
X-Container-Meta-Access-Control-Allow-Origin: http://localhost
X-Trans-Id: txf770951820a44a91bc450-00661de4f8
Referrer-Policy: unsafe-url
x-ncp-trace-id: 6cd9l6lj66d356cchgc4rjcc1o
x-ncp-apigw-response-origin: ENDPOINT