本文へジャンプします。

ニフクラ ユーザーガイド

本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/object-storage-service/api/HeadObject.htmへ移行しました。 今後は新ページをご参照ください。

HeadObject

処理概要

オブジェクトのメタデータを表示します。

リクエストURL

HEAD /{Bucket}/{Object}

指定するパラメーター

ヘッダーパラメーター
パラメーター 説明 必須
x-amz-content-sha256 string ペイロード全体の計算されたSHA256チェックサム
x-amz-date string リクエスト側で生成した現在日時
Authorization string リクエスト認証に用いる文字列
x-amz-server-side-encryption-customer-algorithm string

オブジェクト暗号化時に使用するアルゴリズムを指定します。
指定可能な値はAES256だけです。


値: AES256
x-amz-server-side-encryption-customer-key string

オブジェクト暗号化時に使用する暗号鍵のbase64エンコード済み文字列を指定します。
暗号鍵はテキスト/バイナリ問わず256ビットの長さであることが必要です。
【Linuxでの指定文字列作成コマンド例】
echo -n <暗号鍵> | openssl enc -base64


x-amz-server-side-encryption-customer-key-MD5 string

暗号鍵の128-bit MD5ダイジェストのbase64エンコード済み文字列を指定します。
送信した暗号鍵の整合性確認に使用します。
【Linuxでの指定文字列作成コマンド例】
echo -n <暗号鍵> | openssl dgst -md5 -binary | openssl enc -base64


Consistency-Control string

リクエスト認証に用いる文字列
指定できる整合性レベルは次のとおりです。
- available
※この指定がない場合には、バケットの整合性レベルとなります。
※整合性レベルの詳細については機能説明書の「整合性レベル」を参照してください。


パスパラメーター
パラメーター 説明 必須
Bucket string バケット名
Object string オブジェクト名
クエリパラメーター
パラメーター 説明 必須
versionId string

バージョンID
バージョニング設定が有効なバケット内の特定バージョンのオブジェクトを削除する場合は必須


partNumber string

UploadPartコマンドの分割Upload時に指定したオブジェクトの番号
CompleteMultipartUploadコマンドの完了後に利用できます。


応答フィールド

レスポンスヘッダー
フィールド (項目) 説明
Date string トランザクションが実行された日時
Content-Type string MIME仕様で定義されているコンテントの形式
Content-Length string レスポンスボディのバイト数
Connection string 持続接続の状態を表示します。
x-amz-request-id string

このリクエストに付与されるID
トラブルについて問い合わせる際に利用されます。


x-amz-id-2 string

このリクエストに対する処理ID
トラブルについて問い合わせる際に利用されます。


x-ntap-sg-trace-id string

このリクエストに対する処理ID
トラブルについて問い合わせる際に利用されます。


ETag string 格納されているオブジェクトのハッシュ値
x-amz-server-side-encryption string オブジェクトが暗号化キーを使用して保存されている場合に使用されている暗号化アルゴリズム
Last-Modified string オブジェクトの作成日と時間またはメタデータが変更された日と時間
x-amz-expiration string

オブジェクトに設定された有効期限
オブジェクトが格納されているバケットに、バケットライフサイクルポリシーを設定している場合に表示されます。


x-amz-version-id string オブジェクトのバージョンID
Accept-Ranges string リクエストの応答サイズの形式
X-Fcx-Endpoint-Request string APIエンドポイントとしてリクエストを受け付けたことを示す番号
x-amz-mp-parts-count string

オブジェクトの分割数
リクエストパラメータでpartNumberを指定した場合に表示されます。


リクエストサンプル

    HEAD /general-bucket/object_data_1 HTTP/1.1
User-Agent: curl/7.29.0
Host: jp-east-1.storage.api.nifcloud.com
Accept: */*
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20190604T063816Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20190604/jp-east-1/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=501ba5f5c8225ecc6ae1c4d44831d4be6273442650c162d3279eb7c9d452ec75

  

応答サンプル

    HTTP/1.1 200 OK
Date: Tue, 04 Jun 2019 06:38:17 GMT
Content-Type: binary/octet-stream
Content-Length: 252864
Connection: keep-alive
x-amz-request-id: 913628700
x-amz-id-2: 12174498
x-ntap-sg-trace-id: 73152f4eaaf82d49
ETag: "0acd0dd3a9121a41ed274bbfb11365cc"
x-amz-server-side-encryption: AES256
Last-Modified: Tue, 04 Jun 2019 06:10:59 GMT
Accept-Ranges: bytes
X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.management.jp-east-1.local-28857-859372-1_200

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

推奨画面サイズ 1024×768 以上