將標籤新增至目錄儲存貯體 - Amazon Simple Storage Service
許可故障診斷錯誤步驟

將標籤新增至目錄儲存貯體

您可以將標籤新增至 Amazon S3 目錄儲存貯體，並修改這些標籤。對於目錄儲存貯體使用標籤，除了標準的 S3 API 請求費率之外，不會收取額外費用。如需詳細資訊，請參閱 Simple Storage Service (Amazon S3) 定價。如需有關標記目錄儲存貯體的詳細資訊，請參閱 搭配使用標籤和 S3 目錄儲存貯體。

許可

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

  • s3express:TagResource

故障診斷錯誤

如果您在嘗試將標籤新增至目錄儲存貯體時遇到錯誤，您可以執行下列動作：

  • 確認您具備將標籤新增至目錄儲存貯體時所需的 許可。

  • 如果您嘗試新增以 AWS 預留字首 aws: 開頭的標籤鍵，請變更標籤鍵，然後再試一次。

步驟

您可以透過使用 Amazon S3 主控台、AWS 命令列介面 (AWS CLI)、Amazon S3 REST API 和 AWS SDK，將標籤新增至目錄儲存貯體。

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

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

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

  3. 選擇儲存貯體名稱。

  4. 選擇屬性索引標籤。

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

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

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

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

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

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());
    }
}

如需有關 Amazon S3 REST API 對於將標籤新增至目錄儲存貯體的支援資訊，請參閱《Amazon Simple Storage Service API 參考》中的以下區段：

若要安裝 AWS CLI，請參閱《AWS Command Line Interface 使用者指南》中的安裝 AWS CLI。

下列 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
  }
}