Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅
中国的 Amazon Web Services 服务入门
(PDF)。
向存储桶添加标签
您可以向 Amazon S3 存储桶添加标签并修改这些标签。在存储桶上使用标签时,除了标准 S3 API 请求费率之外,没有任何其他费用。有关更多信息,请参阅 Amazon S3 定价。有关为存储桶添加标签的更多信息,请参阅将标签与 S3 通用存储桶结合使用。
权限
要向存储桶添加标签,您必须具有以下权限:
错误故障排除
如果您在尝试向存储桶添加标签时遇到错误,可以执行以下操作:
Steps
您可以使用 Amazon S3 控制台、Amazon 命令行界面(Amazon CLI)、Amazon S3 REST API 和 Amazon SDK 向存储桶添加标签。
使用 Amazon S3 控制台向存储桶添加标签,请执行以下操作:
登录到 Amazon S3 控制台,网址为:https://console.aws.amazon.com/s3/。
在左侧导航窗格中,选择存储桶。
选择存储桶名称。
选择属性选项卡。
滚动到标签部分,然后选择添加新标签。
这会打开添加标签页面。最多可以输入 50 个标签键值对。
如果您添加的新标签与现有标签具有相同的键名称,则新标签的值将覆盖现有标签的值。
还可以在此页面上编辑现有标签的值。
添加标签后,选择保存更改。
- 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::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 参考》中的以下部分:
要安装 Amazon CLI,请参阅《Amazon Command Line Interface 用户指南》中的安装 Amazon CLI。
以下 CLI 示例说明如何使用 Amazon 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"}]'