將標籤新增至目錄儲存貯體 - 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 SDKs。

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

  1. 登入 Amazon S3 主控台，網址為 https：//https://console.aws.amazon.com/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 使用者指南》中的安裝 CLI。 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
  }
}