标记 AWS Batch 资源 - AWS Batch
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

标记 AWS Batch 资源

为了帮助您管理 AWS Batch 资源,您可通过标签。本主题介绍标签并说明如何创建标签。

有关标签的基本知识

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

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

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

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

您可以使用 AWS 管理控制台、AWS CLI 和 AWS Batch API 对标签进行处理。

如果您使用的是 AWS Identity and Access Management (IAM),则可以控制 AWS 账户中的哪个用户拥有创建、修改或删除标签的权限。

给您的 资源加标签

您可以标记新的或现有的 AWS Batch 计算环境、作业、作业定义和任务队列。

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

如果您使用的是 AWS Batch API、AWS CLI 或 AWS 开发工具包,则可以使用tags参数或现有资源使用TagResourceAPI 操作。有关更多信息,请参阅 TagResource

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

下表描述了可以标记的 AWS Batch 资源以及可在创建时标记的资源。

AWS Batch 资源标记支持
资源 支持标签 支持标签传播 支持在创建时添加标签(AWS Batch API、AWS CLI、AWS 开发工具包)

AWS Batch 计算环境

否。 计算环境标签不传播到任何其他资源。资源的标签是在传递到CreateComputeEnvironmentAPI 操作。

AWS Batch 作业

否。 标签不传播到阵列或多节点并行 (MNP) 作业的子作业。

AWS Batch 作业定义

否。

AWS Batch 作业队列

否。

标签限制

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

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

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

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

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

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

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

  • 请勿使用aws:AWS:,或任何大写或小写组合(例如,键或值的前缀),因为它将保留以供 AWS 使用。您无法编辑或删除带此前缀的标签键或值。具有此前缀的标签不计入每个资源的标签数限制。

通过控制台使用标签

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

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

您可以在创建 AWS Batch 计算环境、作业、作业定义和作业队列时将标签添加到这些标签。

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

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

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

  1. 打开 AWS Batch 控制台,网址为https://console.aws.amazon.com/batch/

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

  3. 在导航窗格中,选择资源类型(例如,作业队列)。

  4. 选择特定资源,然后选择编辑标签

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

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

    • 要删除标签,请选择 按钮旁边的标签。

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

通过 CLI 或 API 使用标签

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

AWS Batch 资源标记支持
任务 API 操作 AWS CLI 适用于 Windows PowerShell 的 AWS 工具

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

TagResource

tag-resource

添加批量资源标签

删除一个或多个标签。

UntagResource

untag-resource

移除批量资源标签

列出资源的标签

ListTagsForResource

list-tags-for-resource

Get Batch 资源标签

以下示例说明如何使用 AWS 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

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

任务 API 操作 AWS CLI 适用于 Windows PowerShell 的 AWS 工具
创建计算环境 CreateComputeEnvironment 创建计算环境 New-Batch 计算环境
创建作业队列 CreateJobQueue 创建作业队列 New-Batch Job 队列
注册作业定义 RegisterJobDefinition 寄存器作业定义 寄存器 BatJobDefinition
提交作业 SubmitJob 提交作业 提交 Batch