# 向表存储桶添加标签
<a name="table-bucket-tag-add"></a>



您可以向 Amazon S3 表存储桶添加标签并修改这些标签。有关为表存储桶添加标签的更多信息，请参阅[将标签与 S3 表存储桶结合使用](table-bucket-tagging.md)。

## 权限
<a name="table-bucket-tag-add-permissions"></a>

要向表存储桶添加标签，您必须具有以下权限：
+ `s3tables:TagResource`

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

如果您在尝试向表存储桶添加标签时遇到错误，可以执行以下操作：
+ 验证您是否具有向表存储桶添加标签所需的[权限](#table-bucket-tag-add-permissions)。
+ 如果您尝试添加以 AWS 保留前缀 `aws:` 开头的标签键，请更改标签键并重试。
+ 标签键是必需的。此外，请确保标签键和标签值不超过最大字符长度，并且不包含受限字符。有关更多信息，请参阅 [添加标签以进行成本分配或基于属性的访问权限控制（ABAC）](tagging.md)。

## Steps
<a name="table-bucket-tag-add-steps"></a>

您可以使用 Amazon S3 控制台、AWS 命令行界面（AWS CLI）、Amazon S3 表类数据存储服务 REST API 和 AWS SDK 向表存储桶添加标签。

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

使用 Amazon S3 控制台向表存储桶添加标签：

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

1. 在左侧导航窗格中，选择**表存储桶**。

1. 选择表存储桶名称。

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

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

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

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

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

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

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

有关 Amazon S3 REST API 支持向表存储桶添加标签的相关信息，请参阅《Amazon Simple Storage Service API 参考》**中的以下部分：
+ [TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_TagResource.html)

## 使用 AWS CLI
<a name="table-bucket-tag-add-cli"></a>

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

以下 CLI 示例说明如何使用 AWS CLI 向表存储桶添加标签。要使用该命令，请将*用户输入占位符* 替换为您自己的信息。

**请求**

```
aws --region us-west-2 \
s3tables tag-resource \
--resource-arn arn:aws::s3tables:us-west-2:111122223333:bucket/amzn-s3-demo-table-bucket \
--tags '{"Department":"Engineering"}'
```