HeadObject

Prev Next

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

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

リクエスト

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

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

リクエストヘッダ

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

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

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

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

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

リクエスト例

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

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

レスポンス

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

レスポンスヘッダ

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

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