本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
给您的 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 控制台，则可以在创建新资源时对其应用标签，或随时在相关资源页面上使用 Tags (标签) 选项卡对现有资源应用标签。
如果您使用的是 Amazon Batch API、Amazon CLI 或 Amazon 开发工具包，则可以使用相关 API 操作上的 tags 参数对新资源应用标签，或使用 TagResource API 操作对现有资源应用标签。有关更多信息，请参阅TagResource。
某些资源创建操作允许您在创建资源时为其指定标签。如果无法在资源创建期间应用标签，资源创建过程失败。这可确保对于您希望在创建时标记的资源，要么使用指定的标签创建，要么完全不创建。如果您在创建时标记资源，则无需在资源创建后运行自定义标记脚本。
下表描述了可以标记的 Amazon Batch 资源以及可在创建时标记的资源。
Amazon Batch 资源标记支持 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 资源 | 支持标签 | 支持标签传播 | 支持在创建时添加标签 (Amazon Batch API、Amazon CLI、Amazon 开发工具包) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Amazon Batch计算环境 |
是 |
没有。 计算环境标签不传播到任何其他资源。资源的标签在 CreateComputeEnvironmentAPI 操作中传递的 ComputeResources 对象的标签成员中指定。 |
是 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Amazon Batch 个作业 |
是 |
没有。 标签不传播到阵列或多节点parallel (MNP) 作业的子任务。 |
是 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Amazon Batch工作定义 |
是 |
否。 |
是 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Amazon Batch作业队列 |
是 |
否。 |
是 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Amazon Batch调度策略 |
是 |
否。 |
是 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
标签限制
下面是适用于标签的基本限制：
-
每个资源的标签数上限 – 50
-
对于每个资源，每个标签键都必须是唯一的，每个标签键只能有一个值。
-
最大键长度 – 128 个 Unicode 字符（采用 UTF-8 格式）
-
最大值长度 – 256 个 Unicode 字符 (采用 UTF-8 格式)
-
如果您的标记方案针对多个 Amazon 服务和资源使用，请记得其它服务可能对允许使用的字符有限制。通常允许使用的字符包括可用 UTF-8 格式表示的字母、数字和空格，以及以下字符：+ - = . _ : / @。
-
标签键和值区分大小写。
-
请不要使用
aws:、AWS:或此类拼写的任意大小写组合作为键或值的前缀，因为它将保留以供 Amazon 使用。您无法编辑或删除带此前缀的标签键或值。具有此前缀的标签不计入您的 tags-per-resource 限制。
通过控制台使用标签
通过使用Amazon Batch，您可以管理与新的或现有的计算环境、任务、作业定义和作业队列相关的标签。
在创建时为单个资源添加标签
在创建Amazon Batch计算环境、作业、作业定义、作业队列和调度策略时，可以向它们添加标签。
为单个资源添加和删除标签
Amazon Batch 允许您直接从资源的页面中添加或删除与集群相关的标签。
添加或删除单个资源上的标签
-
通过 https://console.aws.amazon.com/batch/
打开Amazon Batch主机。 -
从导航栏中，选择要使用的区域。
-
在导航窗格中，选择资源类型 (例如，Job 队列)。
-
选择特定资源，然后选择编辑标签。
-
根据需要添加或删除标签。
-
添加标签 — 在列表末尾的空文本框中指定键和值。
-
要删除标签 — 选择，选择标签旁边的
按钮。
-
-
对要添加或删除的每个标签重复此过程，然后选择 Ed tag（标签），然后选择编辑标签。
通过 CLI 或 API 使用标签
使用以下 Amazon CLI 命令或 Amazon Batch API 操作来添加、更新、列出和删除资源的标签。
Amazon Batch 资源标记支持 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 任务 | API 操作 | Amazon CLI | Amazon Tools for Windows PowerShell | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
添加或覆盖一个或多个标签。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
删除一个或多个标签。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 列出资源的标签 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
以下示例说明如何使用 Amazon CLI 标记或取消标记资源。
示例 1：标记现有资源
以下命令标记现有资源。
aws batch tag-resource --resource-arnresource_ARN--tagsteam=devs
示例 2：取消标记现有资源
以下命令删除现有资源的标签。
aws batch untag-resource --resource-arnresource_ARN--tag-keystag_key
示例 3：列出资源的标签
以下命令列出与现有资源关联的标签。
aws batch list-tags-for-resource --resource-arnresource_ARN
某些资源创建操作允许您在创建资源时指定标签。以下操作支持在创建时进行标记。
| 任务 | API 操作 | Amazon CLI | Amazon Tools for Windows PowerShell |
|---|---|---|---|
|
创建计算环境 |
|||
|
创建作业队列 |
|||
|
创建计划策略 |
|||
|
注册作业定义 |
|||
|
提交任务 |