# 向接入点添加标签
<a name="access-points-tag-add"></a>



可以向 Amazon S3 接入点添加标签并修改这些标签。在超过标准 S3 API 请求速率的接入点上使用标签无需额外付费。有关更多信息，请参阅 [Amazon S3 定价](https://docs.amazonaws.cn/s3/pricing/)。有关为接入点添加标签的更多信息，请参阅[将标签与通用存储桶的 S3 接入点结合使用](access-points-tagging.md)。

## 权限
<a name="access-points-tag-add-permissions"></a>

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

## 错误故障排除
<a name="access-points-tag-add-troubleshooting"></a>

如果在尝试向接入点添加标签时遇到错误，可以执行以下操作：
+ 验证您是否具备向接入点添加标签所需的[权限](#access-points-tag-add-permissions)。
+ 如果您尝试添加以 Amazon 保留前缀 `aws:` 开头的标签键，请更改标签键并重试。

## Steps
<a name="access-points-tag-add-steps"></a>

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

## 使用 S3 控制台
<a name="access-points-tag-add-console"></a>

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

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

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

1. 请选择接入点名称。

1. 选择**属性**选项卡。

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

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

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

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

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

## 使用 Amazon SDK
<a name="access-points-tag-add-sdks"></a>

------
#### [ 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);
```

------

## 使用 REST API
<a name="access-points-tag-add-api"></a>

有关 Amazon S3 REST API 支持向接入点添加标签的信息，请参阅《Amazon Simple Storage Service API Reference》**中的以下部分：
+ [TagResource](https://docs.amazonaws.cn/AmazonS3/latest/API/API_control_TagResource.html)

## 使用 Amazon CLI
<a name="access-points-tag-add-cli"></a>

要安装 Amazon CLI，请参阅《Amazon Command Line Interface 用户指南》**中的[安装 Amazon CLI](https://docs.amazonaws.cn/cli/latest/userguide/getting-started-install.html)。

以下 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
  }
}
```