ヘッドオブジェクト - Object Storage Service - Alibaba Cloud ドキュメントセンター

head-object コマンドは、オブジェクトのメタデータをクエリするために使用されます。

注記

このコマンドを実行しても、オブジェクトのコンテンツはレスポンスで返されません。

権限

デフォルトでは、Alibaba Cloud アカウントは、アカウント内のリソースに対するフルアクセス権限を持っています。一方、RAM ユーザーと Alibaba Cloud アカウントに関連付けられている RAM ロールは、最初は権限を持っていません。 RAM ユーザーまたはロールを使用してリソースを管理するには、RAM ポリシーまたはバケットポリシーを介して必要な権限を付与する必要があります。

API	アクション	説明
HeadObject	`oss:GetObject`	オブジェクトのメタデータをクエリします。

コマンド構文

ossutil api head-object --bucket value --key value [flags]

パラメーター	タイプ	説明
--bucket	string	バケットの名前。
--key	string	オブジェクトのフルパス。
--if-match	string	リクエストで指定された ETag 値がオブジェクトの ETag 値と一致する場合、200 OK とオブジェクトのメタデータが返されます。一致しない場合は、412 precondition failed が返されます。
--if-modified-since	string	指定された時間がオブジェクトの最終更新時刻より前の場合、オブジェクトのメタデータと 200 OK が返されます。それ以外の場合は、304 Not Modified が返されます。
--if-none-match	string	入力された ETag がオブジェクトの ETag と一致しない場合、オブジェクトのメタデータと 200 OK が返されます。それ以外の場合は、304 Not Modified が返されます。
--if-unmodified-since	string	指定された時間がオブジェクトの最終更新時刻以降の場合、オブジェクトのメタデータと 200 OK が返されます。それ以外の場合は、412 Precondition Failed が返されます。
--version-id	string	オブジェクトのバージョン ID。

説明

head-object コマンドは、HeadObject 操作に対応します。 HeadObject 操作のパラメーターの詳細については、「HeadObject」をご参照ください。
サポートされているグローバルコマンドラインオプションの詳細については、「コマンドラインオプション」をご参照ください。

例

exampleobject のメタデータをクエリします。

ossutil api head-object --bucket examplebucket --key exampleobject

exampleobject のメタデータをクエリし、JSON 形式で出力を表示します。
```
ossutil api head-object --bucket examplebucket --key exampleobject --output-format json
```
バージョン ID が 123 の exampleobject のメタデータをクエリします。
```
ossutil api head-object --bucket examplebucket --key exampleobject --version-id 123
```

ETag 値が 123 である exampleobject のメタデータをクエリします。

ossutil api head-object --bucket examplebucket --key exampleobject --if-match 123

実際の変更時間が「Thu, 11 Jul 2024 06:36:31 GMT」より前のexampleobject のメタデータをクエリします。
```
ossutil api head-object --bucket examplebucket --key exampleobject --if-modified-since "Thu, 11 Jul 2024 06:36:31 GMT"
```