HeadContainer
    • PDF

    HeadContainer

    • PDF

    記事の要約

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

    コンテナ(バケット)のメタデータを照会します。

    リクエスト

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

    メソッドURI
    HEAD/{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

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

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

    フィールドタイプ必須の有無説明
    containerNameStringRequired照会するコンテナ(バケット)の名前

    リクエスト例

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

    curl -X HEAD "https://archivestorage.apigw.ntruss.com/swift/v1/{containerName}" -H "accept: application/json" -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-コンテナ(バケット)の Storage Policy値
    X-TimestampInteger-コンテナ(バケット)が作成された時刻(Unix Timestamp)
    X-Container-Bytes-UsedInteger-コンテナ(バケット)が使用する全容量(Byte)
    X-Trans-IdString-リクエストのトランザクション ID
    X-Openstack-Request-IdString-リクエストのトランザクション ID
    • X-Trans-Idと同じ
    X-Container-Object-CountInteger-コンテナ(バケット)のオブジェクトの総数
    Referrer-PolicyString-HTTP Referrerヘッダの処理方式
    x-ncp-apigw-response-originString-レスポンスの原本の出典
    x-ncp-trace-idString-トランザクショントレース用 ID

    レスポンス例

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

    HTTP/1.1 200 OK
    Server: nginx
    Date: Mon, 15 Apr 2024 23:43:11 GMT
    Connection: keep-alive
    X-Storage-Policy: standard00
    X-Timestamp: 1711960998.26335
    X-Container-Bytes-Used: 16969
    X-Openstack-Request-Id: tx4b43dc3e46d2471daaafb-00661dbb8f
    X-Container-Object-Count: 2
    X-Trans-Id: tx4b43dc3e46d2471daaafb-00661dbb8f
    Referrer-Policy: unsafe-url
    x-ncp-trace-id: 6cd9l6lj66d356cchgc4rjcc1o
    x-ncp-apigw-response-origin: ENDPOINT
    

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

    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.