向目录存储桶添加标签 - Amazon Simple Storage Service
权限错误故障排除步数
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

向目录存储桶添加标签

您可以向 Amazon S3 目录存储桶添加标签并修改这些标签。在超过标准 S3 API 请求速率的目录存储桶上使用标签无需额外付费。有关更多信息，请参阅 Amazon S3 定价。有关为目录存储桶添加标签的更多信息，请参阅将标签与 S3 目录存储桶结合使用。

权限

要向目录存储桶添加标签，您必须具有以下权限：

  • s3express:TagResource

错误故障排除

如果您在尝试向目录存储桶添加标签时遇到错误，可以执行以下操作：

  • 验证您是否具备向目录存储桶添加标签所需的权限。

  • 如果您尝试添加以 Amazon 保留前缀 aws: 开头的标签键，请更改标签键并重试。

步数

您可以使用 Amazon S3 控制台、Amazon 命令行界面（Amazon CLI）、Amazon S3 REST API 和 Amazon SDK 向目录存储桶添加标签。

使用 Amazon S3 控制台向目录存储桶添加标签：

  1. 登录到 Amazon S3 控制台，网址为：https://console.aws.amazon.com/s3/。

  2. 在左侧导航窗格中，选择目录存储桶。

  3. 选择存储桶名称。

  4. 选择属性选项卡。

  5. 滚动到标签部分，然后选择添加新标签。

  6. 这会打开添加标签页面。最多可以输入 50 个标签键值对。

  7. 如果您添加的新标签与现有标签具有相同的键名称，则新标签的值将覆盖现有标签的值。

  8. 还可以在此页面上编辑现有标签的值。

  9. 添加标签后，选择保存更改。

SDK for Java 2.x

此示例显示如何使用Amazon 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 Reference》中的以下部分：

要安装 Amazon CLI，请参阅《Amazon Command Line Interface 用户指南》中的安装 Amazon CLI。

以下 CLI 示例显示如何使用 Amazon 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
  }
}