HeadObject
    • PDF

    HeadObject

    • PDF

    記事の要約

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

    保存されているオブジェクトのメタデータを照会します。

    リクエスト

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

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

    リクエストヘッダ

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

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

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

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

    フィールドタイプ必須の有無説明
    project_idStringRequiredプロジェクト ID
    containerStringRequired対象のオブジェクトが保存されるコンテナの名前
    objectStringRequired対象オブジェクトの名前

    リクエスト例

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

    curl -L -I 'https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
    -H 'X-Auth-Token: {token}' \
    -H 'X-Newest: true'
    

    レスポンス

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

    レスポンスヘッダ

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

    フィールドタイプ必須の有無説明
    Content-TypeString-レスポンス結果の MIMEタイプ
    Content-LengthString-レスポンス結果の長さ(Byte)
    X-Object-Meta-{name}String-オブジェクトのメタデータ
    • {name}部分がメタデータのキー
    • ヘッダの値がメタデータの値
    Cache-ControlString-リクエストとレスポンスのキャッシュルール
    ETagString-ETagヘッダの値
    Last-ModifiedString-オブジェクトの最終更新時間(UTC)
    X-TimestampString-リクエストのレスポンスタイム(Unix Timestamp)
    Content-DispositionString-ブラウザのレスポンス処理方式
    Content-EncodingString-オブジェクトのエンコード方式
    X-Delete-AtInteger-オブジェクトの自動削除を有効化する場合、削除予定時刻(Unix Timestamp)
    X-Object-ManifestString-大容量オブジェクト(SLO)の場合、レスポンス
    • パートの保存パスを表示
    X-Static-Large-ObjectBoolean-大容量オブジェクト(SLO)かどうか
    • true | false
      • true: このオブジェクトは大容量オブジェクトのマニフェスト
    Accept-RangesString-クライアントの一部範囲のリクエストをサーバは受け入れるかどうか
    X-Trans-IdString-リクエストのトランザクション ID
    X-Openstack-Request-IdString-リクエストのトランザクション ID
    • X-Trans-Idと同じ
    DateString-リクエストのレスポンスタイム(UTC)

    レスポンスステータスコード

    レスポンスステータスコードの説明は次の通りです。

    HTTPステータスコードコードメッセージ説明
    200-OKリクエスト成功

    レスポンス例

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

    HTTP/1.1 200 OK
    Content-Length: 10485760
    Accept-Ranges: bytes
    Last-Modified: Mon, 17 Sep 2018 07:43:40 GMT
    Etag: f1c9645dbc14efddc7d8a322685f26eb
    X-Timestamp: 1537170219.48936
    Content-Type: application/x-www-form-urlencoded
    X-Trans-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
    X-Openstack-Request-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
    Date: Mon, 17 Sep 2018 08:49:21 GMT
    

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

    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.