向接入点添加标签

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

权限

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

• s3:TagResource

错误故障排除

如果在尝试向接入点添加标签时遇到错误，可以执行以下操作：

• 验证您是否具备向接入点添加标签所需的权限。

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

步数

可以使用 Amazon S3 控制台、AWS 命令行界面（AWS CLI）、Amazon S3 REST API 和 AWS SDK 向接入点添加标签。

使用 S3 控制台

要使用 Amazon S3 控制台向接入点添加标签：

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

2. 在左侧导航窗格中，选择接入点（通用存储桶）。

3. 请选择接入点名称。

4. 选择属性选项卡。

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

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

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

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

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

使用 AWS SDK

SDK for Java 2.x

此示例说明如何使用AWS 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);

使用 REST API

有关 Amazon S3 REST API 支持向接入点添加标签的信息，请参阅《Amazon Simple Storage Service API Reference》中的以下部分：

• TagResource

使用 AWS CLI

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

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