向存储桶添加标签 - Amazon Simple Storage Service
权限错误故障排除Steps

向存储桶添加标签

您可以向 Amazon S3 存储桶添加标签并修改这些标签。在存储桶上使用标签时，除了标准 S3 API 请求费率之外，没有任何其他费用。有关更多信息，请参阅 Amazon S3 定价。有关为存储桶添加标签的更多信息，请参阅将标签与 S3 通用存储桶结合使用。

权限

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

  • s3:TagResource

错误故障排除

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

  • 确认您具有向存储桶添加标签所需的权限。

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

Steps

您可以使用 Amazon S3 控制台、AWS 命令行界面（AWS CLI）、Amazon S3 REST API 和 AWS 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

此示例说明如何使用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:::bucket/my-bucket")
                .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 --resource-arn arn:aws:s3:::amzn-s3-demo-bucket --region us-east-2 --account-id 444455556666 --tags '[{"Key":"mykey","Value":"myvalue"}]'