get-object-attributes

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

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

参考

Sub Accountユーザーがこのコマンドを実行するには、View/GetObject、View/GetObjectAttributesアクションの権限が必要です。特定のバージョン(--version-id)を照会する場合、View/GetObjectVersionと View/GetObjectVersionAttributesアクションの権限が必要です。

構文

get-object-attributes構文は次の通りです。

aws s3api get-object-attributes \
    --bucket <bucket> \
    --key <key> \
    --object-attributes <object-attributes> \
    [--version-id <version-id>] \
    [--max-parts <max-parts>] \
    [--part-number-marker <part-number-marker>] \
    [--sse-customer-algorithm <sse-customer-algorithm>] \
    [--sse-customer-key <sse-customer-key>] \
    [--sse-customer-key-md5 <sse-customer-key-md5>] \
    --endpoint-url <endpoint-url>

オプション

get-object-attributesの実行時に指定できるオプションについて説明します。

必須オプション

get-object-attributesの必須オプションです。

オプション	タイプ	必須の有無	説明
`--bucket`	String	Required	バケット名
`--key`	String	Required	オブジェクト名
`--object-attributes`	List	Required	オブジェクトの属性リスト `ETag` \| `Checksum` \| `ObjectParts` \| `StorageClass` \| `ObjectSize`

任意オプション

get-object-attributesの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--version-id`	String	Optional	オブジェクトバージョン ID
`--max-parts`	Integer	Optional	出力に含めるパートの最大数 `0`~`2147483647` (デフォルト: `1000`)
`--part-number-marker`	Integer	Optional	パート照会を開始する基準となるパート番号 `0`~`2147483647`
`--sse-customer-algorithm`	String	Optional	ユーザー暗号化アルゴリズム (AES256)
`--sse-customer-key`	String	Optional	ユーザー提供の暗号化キー
`--sse-customer-key-md5`	String	Optional	ユーザー提供暗号化キーの MD5

共通オプション

awsコマンドで共通して使用するオプションについては、Ncloud Storageのオプションをご参照ください。

例

オブジェクト属性の照会リクエストが成功すると、リクエストした属性情報とバージョン情報が返されます。

コマンド

コマンドの例は次の通りです。

aws s3api get-object-attributes --bucket my-test-bucket \
    --key img/image.png \
    --object-attributes ETag ObjectSize StorageClass \
    --endpoint-url=https://kr.ncloudstorage.com

出力

出力の例は次の通りです。

{
    "LastModified": "Fri, 04 Sep 2026 06:19:10 GMT",
    "ETag": "7cb4883d8f0eede455af0738a2d83b4b",
    "StorageClass": "STANDARD",
    "ObjectSize": 40960
}