HeadContainer
    • PDF

    HeadContainer

    • PDF

    記事の要約

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

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

    参考

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

    リクエスト

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

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

    リクエストヘッダ

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

    フィールドタイプ必須の有無説明
    X-Auth-TokenStringRequired発行したトークン(Token)の値
    X-NewestBooleanOptional最新のコピー情報でレスポンスするかどうかを設定
    • true | false
      • true: すべてのコピーに対してクエリを行い、最新のコピー情報でレスポンス
    • ヘッダが省略された場合、レスポンスが最も早い情報でレスポンス

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

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

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

    リクエスト例

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

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

    レスポンス

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

    レスポンスヘッダ

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

    フィールドタイプ必須の有無説明
    Content-TypeString-レスポンス結果の MIMEタイプ
    Content-LengthString-レスポンス結果の長さ(Byte)
    X-Container-Object-CountInteger-コンテナ(バケット)のオブジェクトの総数
    X-Container-Bytes-UsedInteger-コンテナ(バケット)が使用する全容量(Byte)
    X-TimestampInteger-コンテナ(バケット)が作成された時刻(UNIX timestamp)
    X-Container-ReadString-コンテナ(バケット)の READ ACL(アクセス権限)
    X-Container-WriteString-コンテナ(バケット)の WRITE ACL(アクセス権限)
    Last-ModifiedString-コンテナ(バケット)の最終更新時間(UTC)
    Accept-RangesString-コンテナ(バケット)が対応する範囲タイプ
    X-Storage-PolicyString-コンテナ(バケット)の Storage Policy値
    X-Trans-IdString-リクエストのトランザクション ID
    X-Openstack-Request-IdString-リクエストのトランザクション ID
    • X-Trans-Idと同じ
    X-Container-Meta-nameString-コンテナ(バケット)のメタデータ
    • ヘッダ名のname部分がメタデータのキーの役割を果たす
    X-Container-Meta-Quota-CountString-コンテナ(バケット)のオブジェクト数の制限値
    X-Container-Meta-Quota-BytesString-コンテナ(バケット)の容量制限値
    X-Container-Meta-Access-Control-Allow-OriginString-CORS設定
    • 入力されたアクセス可能なドメイン
    X-Container-Meta-Access-Control-Max-AgeString-CORS設定
    • 入力された結果キャッシュの最大時間(秒)
    X-Container-Meta-Access-Control-Expose-HeadersString-CORS設定
    • 入力されたアクセス許可ヘッダ
    X-Container-Meta-Temp-URL-KeyString-Temporary URLのための Secret Key値
    X-Container-Meta-Temp-URL-Key-2String-Temporary URLのための2番目の Secret Key値
    X-Container-Sync-KeyString-使用しない
    X-Container-Sync-ToString-使用しない
    X-Versions-LocationString-使用しない
    X-History-LocationString-使用しない
    DateString-リクエストのレスポンスタイム(UTC)

    レスポンス例

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

    HTTP/1.1 204 No Content
    Content-Length: 0
    X-Container-Object-Count: 3
    X-Timestamp: 1536631895.01856
    Accept-Ranges: bytes
    Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
    X-Container-Bytes-Used: 630036
    Content-Type: text/plain; charset=utf-8
    X-Trans-Id: tx51f8478e8e924403851a4-005b988014
    X-Openstack-Request-Id: tx51f8478e8e924403851a4-005b988014
    Date: Wed, 12 Sep 2018 02:55:16 GMT
    

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

    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.