对Amazon Batch资源加标签 - Amazon Batch
有关标签的基本知识对资源加标签标签限制通过控制台使用标签通过 CLI 或 API 使用标签
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

对Amazon Batch资源加标签

为了帮助管理Amazon Batch资源，可通过标签的形式为每个资源分配元数据。本主题介绍标签并演示如何创建标签。

有关标签的基本知识

标签是为Amazon资源分配的标记。每个标签都包含定义的一个键 和一个可选值。

标签允许按用途、所有者或环境等对Amazon资源进行分类。在具有相同类型的许多资源时，可以根据分配给资源的标签快速识别具体的资源。例如，可以为Amazon Batch服务定义一组标签，以帮助跟踪每个服务的拥有者和堆栈级别。我们建议为每个资源类型设计一组一致的标签键。

标签不会自动分配至资源。添加标签后，可以编辑标签键和值，还可以随时删除资源的标签。如果删除资源，资源的所有标签也会被删除。

标签对Amazon Batch没有任何语义意义，应严格按字符串进行解析。可以将标签的值设为空的字符串，但是不能将其设为空值。如果添加的标签的键与该资源上现有标签的键相同，新值就会覆盖旧值。

可以使用Amazon Web Services Management Console、Amazon CLI和Amazon Batch API 处理标签。

如果使用的是Amazon Identity and Access Management (IAM)，则可以控制Amazon账户中的哪些用户拥有创建、编辑或删除标签的权限。

对资源加标签

可以对新的或现有的Amazon Batch计算环境、作业、作业定义、作业队列和计划策略加标签。

如果使用的是Amazon Batch控制台，则可以在创建新资源时对其应用标签，或随时在相关资源页面上使用标签选项卡对现有资源应用标签。

如果使用的是Amazon Batch API、Amazon CLI或Amazon开发工具包，则可以使用相关 API 操作上的tags参数对新资源应用标签，或使用TagResource API 操作对现有资源应用标签。有关更多信息，请参阅 TagResource。

某些资源创建操作允许在创建资源时为其指定标签。如果无法在资源创建期间应用标签，资源创建过程失败。这可确保对于要在创建时加标签的资源，要么使用指定的标签创建，要么完全不创建。如果在创建时对资源加标签，则无需在资源创建后运行自定义对脚本加标签。

下表描述了可以加标签的Amazon Batch资源以及可在创建时加标签的资源。

给Amazon Batch资源加标签支持
资源 支持标签 支持标签传播 支持在创建时添加标签（Amazon BatchAPI、Amazon CLI、AmazonSDK）

Amazon Batch计算环境

是

不是。计算环境标签不传播到任何其他资源。资源的标签在 CreateComputeEnvironment API 操作中传递的 computeResources 对象的标签成员中指定。

是

Amazon Batch 个作业

是

是

是

Amazon Batch 个作业定义

是

否

是

Amazon Batch 个作业队列

是

否

是
Amazon Batch 个计划策略

是

否

是

标签限制

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

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

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

  • 最大键长度 – 128 个 Unicode 字符（采用 UTF-8 格式）

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

  • 如果标签方案针对多个Amazon服务和资源使用，请记得其它服务可能对允许使用的字符有限制。通常允许使用的字符包括可用 UTF-8 格式表示的字母、数字和空格，以及以下字符：+ - = . _ : / @。

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

  • 请不要使用aws:、AWS:或此类拼写的任意大小写组合作为键或值的前缀，因为它将保留以供Amazon使用。无法编辑或删除带此前缀的标签键或值。具有此前缀的标签不计入每个资源的标签数限制。

通过控制台使用标签

可以使用Amazon Batch控制台管理与新的或现有的计算环境、任务、作业定义和作业队列关联的标签。

在创建时为单个资源添加标签

可以在创建Amazon Batch计算环境、作业、作业定义、作业队列和计划策略时为它们添加标签。

为单个资源添加和删除标签

Amazon Batch允许直接从资源的页面中添加或删除与集群相关的标签。

添加或删除单个资源上的标签

  1. 打开Amazon Batch控制台，地址：https://console.aws.amazon.com/batch/。

  2. 从导航栏中，选择要使用的区域。

  3. 在导航窗格中，选择资源类型（例如，作业队列）。

  4. 选择一项具体资源，然后选择编辑标签。

  5. 根据需要添加或删除标签。

    • 添加标签 — 在列表末尾的空白文本框中指定键和值。

    • 要删除标签 — 选择标签旁边的 Delete icon 按钮。

  6. 为要添加或删除的每个标签重复此过程，然后选择编辑标签以完成操作。

通过 CLI 或 API 使用标签

使用以下Amazon CLI命令或Amazon Batch API 操作来添加、更新、列出和删除资源的标签。

给Amazon Batch资源加标签支持
任务 API 操作 Amazon CLI Amazon Tools for Windows PowerShell

添加或覆盖一个或多个标签。

TagResource

tag-resource

Add-BATResourceTag

删除一个或多个标签。

UntagResource

untag-resource

Remove-BATResourceTag
列出资源的标签

ListTagsForResource

list-tags-for-resource

Get-BATResourceTag

以下示例说明如何使用Amazon CLI给资源加标签或取消标签。

示例 1：对现有资源加标签

以下命令对现有资源加标签。

aws batch tag-resource --resource-arn resource_ARN --tags team=devs
示例 2：对现有资源取消标签

以下命令删除现有资源的标签。

aws batch untag-resource --resource-arn resource_ARN --tag-keys tag_key
示例 3：列出资源的标签

以下命令列出与现有资源关联的标签。

aws batch list-tags-for-resource --resource-arn resource_ARN

某些资源创建操作允许在创建资源时指定标签。以下操作支持在创建时加标签。