PostContainer
    • PDF

    PostContainer

    • PDF

    記事の要約

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

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

    リクエスト

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

    メソッドURI
    POST/{containerName}

    リクエストヘッダ

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

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

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

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

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

    リクエスト例

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

    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}"
    

    レスポンス

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

    レスポンスヘッダ

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

    フィールドタイプ必須の有無説明
    ServerString-レスポンスサーバ
    DateString-リクエストのレスポンスタイム(UTC)
    ConnectionString-クライアントとサーバ間の TCP接続状態
    X-Storage-PolicyInteger-コンテナのストレージポリシーの値
    X-TimestampInteger-コンテナが作成された時刻(Unix Timestamp)
    X-Container-Bytes-UsedInteger-コンテナが使用中の容量
    X-Trans-IdString-リクエストのトランザクション ID
    X-Openstack-Request-IdString-リクエストのトランザクション ID
    • X-Trans-Idと同じ
    X-Container-Object-CountInteger-コンテナに保存されているオブジェクト数
    X-Container-Meta-Access-Control-Allow-OriginString-CORS設定
    • 入力されたアクセス可能なドメイン
    Referrer-PolicyString-HTTP Referrerヘッダの処理方式
    x-ncp-apigw-response-originString-レスポンスの原本の出典
    x-ncp-trace-idString-トランザクショントレース用 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
    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.