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

向接入点添加标签

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

权限

要向接入点添加标签，您必须具有以下权限：

  • s3: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 向接入点添加标签。要使用该命令，请将用户输入占位符 替换为您自己的信息。

TagResourceRequest tagResourceRequest = TagResourceRequest.builder().resourceArn(arn:aws::s3:region:111122223333:accesspoint/my-access-point/*)
.accountId(111122223333)
.tags(List.of(Tag.builder().key("key1").value("value1").build(),
Tag.builder().key("key2").value("value2").build()))
.build();
awss3Control.tagResource(tagResourceRequest);

有关 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::s3:region:111122223333:accesspoint/my-access-point/* \
--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
  }
}