本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將標籤新增至目錄儲存貯體
<a name="directory-bucket-tag-add"></a>



您可以將標籤新增至 Amazon S3 目錄儲存貯體，並修改這些標籤。對於目錄儲存貯體使用標籤，除了標準的 S3 API 請求費率之外，不會收取額外費用。如需詳細資訊，請參閱 [Simple Storage Service (Amazon S3) 定價](https://docs.aws.amazon.com/s3/pricing/)。如需有關標記目錄儲存貯體的詳細資訊，請參閱 [搭配使用標籤和 S3 目錄儲存貯體](directory-buckets-tagging.md)。

## 許可
<a name="tag-add-permissions"></a>

若要將標籤新增至目錄儲存貯體，您必須具有下列權限：
+ `s3express:TagResource`

## 故障診斷錯誤
<a name="tag-add-troubleshooting"></a>

如果您在嘗試將標籤新增至目錄儲存貯體時遇到錯誤，您可以執行下列動作：
+ 確認您具備將標籤新增至目錄儲存貯體時所需的 [許可](#tag-add-permissions)。
+ 如果您嘗試新增以 AWS 預留字首 開頭的標籤金鑰`aws:`，請變更標籤金鑰，然後再試一次。

## 步驟
<a name="tag-add-steps"></a>

您可以使用 Amazon S3 主控台、 AWS 命令列界面 (AWS CLI)、Amazon S3 REST API 和 AWS SDKs。

## 使用 S3 主控台
<a name="directory-bucket-tag-add-console"></a>

使用 Amazon S3 主控台將標籤新增至目錄儲存貯體：

1. 從 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 登入 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇**目錄儲存貯體**。

1. 選擇儲存貯體名稱。

1. 選擇**屬性**索引標籤。

1. 捲動至**標籤**區段，選擇**新增標籤**。

1. **新增標籤**頁面隨即開啟。您最多可以輸入 50 個鍵值對。

1. 若您使用與現有標籤相同的標籤鍵名稱來新增標籤，新標籤值會覆寫現有標籤值。

1. 在此頁面上，您也可以編輯現有標籤的值。

1. 新增標籤後，選擇**儲存變更**。

## 使用 AWS SDKs
<a name="directory-bucket-tag-add-sdks"></a>

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

此範例示範如何使用 AWS SDK for Java 2.x將標籤新增至目錄儲存貯體。若要使用此命令，請以您自己的資訊取代{{使用者輸入預留位置}}。

```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;
import software.amazon.awssdk.services.s3control.model.TagResourceResponse;

public class TagResourceExample {
    public static void tagResourceExample() {
        S3ControlClient s3Control = S3ControlClient.builder().region(Region.{{US_WEST_2}}).build();

        TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                .resourceArn("arn:aws::s3express:{{us-west-2}}:111122223333:bucket/my-directory-bucket--{{usw2-az1}}--x-s3")
                .accountId("111122223333")
                .tags(Tag.builder().key("{{MyTagKey}}").value("{{MyTagValue}}").build())
                .build();

        TagResourceResponse response = s3Control.tagResource(tagResourceRequest);
        System.out.println("Status code (should be 204):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}
```

------

## 使用 REST API
<a name="directory-bucket-tag-add-api"></a>

如需有關 Amazon S3 REST API 對於將標籤新增至目錄儲存貯體的支援資訊，請參閱《Amazon Simple Storage Service API 參考》**中的以下區段：
+ [TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html)

## 使用 AWS CLI
<a name="directory-bucket-tag-add-cli"></a>

若要安裝 AWS CLI，請參閱《 [AWS 使用者指南》中的安裝 CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。 *AWS Command Line Interface *

下列 CLI 範例示範如何使用 AWS CLI將標籤新增至目錄儲存貯體。若要使用此命令，請以您自己的資訊取代{{使用者輸入預留位置}}。

**要求:**

```
aws s3control tag-resource \
--account-id {{111122223333}} \
--resource-arn arn:aws::s3express:{{us-east-1}}:{{444455556666}}:bucket/prefix--{{use1-az4}}--x-s3 \
--tags "Key={{mykey}},Value={{myvalue}}"
```

**回應：**

```
{
  "ResponseMetadata": {
      "RequestId": "EXAMPLE123456789",
      "HTTPStatusCode": 200,
      "HTTPHeaders": {
          "date": "Wed, 19 Jun 2025 10:30:00 GMT",
          "content-length": "0"
      },
      "RetryAttempts": 0
  }
}
```