PostContainer

印刷する
共有
PDF

記事の要約

この要約は役に立ちましたか?

ご意見ありがとうございます

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

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

What's Next

HeadContainer

リクエスト
レスポンス

タグ

Archive Storage