

# 检索目录存储桶的对象元数据
<a name="directory-buckets-objects-HeadObjectExamples"></a>

以下 AWS SDK 和 AWS CLI 示例显示如何使用 `HeadObject` 和 `GetObjectAttributes` API 操作从 Amazon S3 目录存储桶中的对象检索元数据，而不返回对象本身。

## 使用 AWS SDK
<a name="directory-bucket-copy-sdks"></a>

------
#### [ SDK for Java 2.x ]

**Example**  

```
public static void headObject(S3Client s3Client, String bucketName, String objectKey) {
     try {
         HeadObjectRequest headObjectRequest = HeadObjectRequest
                 .builder()
                 .bucket(bucketName)
                 .key(objectKey)
                 .build();
         HeadObjectResponse response = s3Client.headObject(headObjectRequest);
         System.out.format("Amazon S3 object: \"%s\" found in bucket: \"%s\" with ETag: \"%s\"", objectKey, bucketName, response.eTag());
     }
     catch (S3Exception e) {
         System.err.println(e.awsErrorDetails().errorMessage());
```

------

## 使用 AWS CLI
<a name="directory-head-object-cli"></a>

以下 `head-object` 示例命令显示您如何使用 AWS CLI 从对象检索元数据。要运行此命令，请将 `user input placeholders` 替换为您自己的信息。

```
aws s3api head-object --bucket bucket-base-name--zone-id--x-s3 --key KEY_NAME
```

有关更多信息，请参阅《AWS CLI Command Reference》**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-object.html)。

以下 `get-object-attributes` 示例命令显示您如何使用 AWS CLI 从对象检索元数据。要运行此命令，请将 `user input placeholders` 替换为您自己的信息。

```
aws s3api get-object-attributes --bucket bucket-base-name--zone-id--x-s3 --key KEY_NAME --object-attributes "StorageClass" "ETag" "ObjectSize"
```

有关更多信息，请参阅《AWS CLI Command Reference》**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object-attributes.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object-attributes.html)。