# 为 S3 Files 资源添加标签
<a name="s3-files-tagging"></a>

为了有助于您管理 S3 Files 资源，可通过标签的形式为每个资源分配您自己的元数据。借助标签，您可以按照不同的方式（例如，按用途、所有者或环境）对 Amazon 资源进行分类。当您具有很多相同类型的资源时，这种分类会很有用，因为您可以根据分配给资源的标签快速识别特定的资源。可以为您账户中已存在的 S3 文件系统和接入点资源添加标签。本主题介绍标签并演示如何创建标签。

## 标签限制
<a name="s3-files-tagging-restrictions"></a>

下面是适用于标签的基本限制：
+ 每个资源的标签数上限：50
+ 对于每个资源，每个标签键都必须是唯一的，每个标签键只能有一个值。
+ 最大键长度：128 个 Unicode 字符（采用 UTF-8 格式）
+ 最大值长度：256 个 Unicode 字符 (采用 UTF-8 格式)
+ 支持的字符包括：可以使用 UTF-8 表示的字母、数字和空格以及以下字符：`+ - = . _ : / @`。
+ 标签键和值区分大小写。
+ `aws:` 前缀专门预留供 Amazon 使用。如果某个标签具有带有此标签键，则您无法编辑该标签的键或值。具有 `aws:` 前缀的标签不计入每个资源的标签数限制。

不能仅依据标签更新或删除资源，必须指定资源标识符。例如，要删除使用名为 `DeleteMe` 的标签键标记的文件系统，必须将 `DeleteFileSystem` 操作与文件系统的资源标识符（例如文件系统 ID）结合使用。

为公有或共享资源添加标签时，您分配的标签仅对您的 Amazon 账户可用。所有其它 Amazon 账户都无法访问这些标签。为了对共享资源进行基于标签的访问控制，每个 Amazon 账户必须分配自己的一组标签来控制对资源的访问。

## 使用 S3 控制台
<a name="s3-files-tagging-console"></a>

您可以使用 S3 Files 控制台管理资源的标签。
+ 通过以下网址打开 Amazon S3 控制台：[https://console.aws.amazon.com/s3/](https://console.amazonaws.cn/s3/)。
+ 在页面顶部的导航栏中，确认您位于所需的 Amazon 区域。
+ 在左侧导航窗格中，选择**文件系统**。
+ 可以在创建资源时为资源指定标签，例如 S3 文件系统或接入点。或者，可以在创建标签后通过访问资源的属性来添加、修改或删除标签。

## 使用 Amazon CLI
<a name="s3-files-tagging-cli"></a>

如果您使用的是 S3 Files API、Amazon CLI 或 Amazon SDK，则可以使用 `TagResource` S3 Files API 操作向现有资源应用标签。此外，某些资源创建操作让您可以在创建资源时为其指定标签，例如创建文件系统时。

下表列出了用于管理标签的 Amazon CLI 命令及等效的 S3 Files API 操作。


| CLI 命令 | 说明 | 等效的 API 操作 | 
| --- | --- | --- | 
| tag-resource | 添加新标签或更新现有标签 | TagResource | 
| list-tags-for-resource | 检索现有标签 | ListTagsForResource | 
| untag-resource | 删除现有标签 | UntagResource |