將標籤新增至目錄儲存貯體的存取點 - Amazon 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::s3:region:111122223333:accesspoint/my-access-point/*")
                .accountId("111122223333")
                .tags(Tag.builder().key("key1").value("value1").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:region:444455556666:bucket/prefix--use1-az4--x-s3 \
--tags "Key=key1,Value=value1"

回應：

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