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

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

您可以將標籤新增至目錄儲存貯體的 Amazon S3 Access Points，並修改這些標籤。如需其他資訊，請參閱 搭配使用標籤與目錄儲存貯體的 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::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 Command Line Interface 使用者指南》中的安裝 AWS CLI。

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