View a markdown version of this page

为 S3 Files 资源添加标签 - Amazon Simple Storage Service

为 S3 Files 资源添加标签

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

标签限制

下面是适用于标签的基本限制:

  • 每个资源的标签数上限:50

  • 对于每个资源,每个标签键都必须是唯一的,每个标签键只能有一个值。

  • 最大键长度:128 个 Unicode 字符(采用 UTF-8 格式)

  • 最大值长度:256 个 Unicode 字符 (采用 UTF-8 格式)

  • 支持的字符包括:可以使用 UTF-8 表示的字母、数字和空格以及以下字符:+ - = . _ : / @

  • 标签键和值区分大小写。

  • aws: 前缀专门预留供 AWS 使用。如果某个标签具有带有此标签键,则您无法编辑该标签的键或值。具有 aws: 前缀的标签不计入每个资源的标签数限制。

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

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

您可以使用 S3 Files 控制台管理资源的标签。

  • 通过以下网址打开 Amazon S3 控制台:https://console.aws.amazon.com/s3/

  • 在页面顶部的导航栏中,确认您位于所需的 AWS 区域。

  • 在左侧导航窗格中,选择文件系统

  • 可以在创建资源时为资源指定标签,例如 S3 文件系统或接入点。或者,可以在创建标签后通过访问资源的属性来添加、修改或删除标签。

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

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

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