本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 标签
**重要**
该 AWS OpsWorks Stacks 服务于 2024 年 5 月 26 日终止，新客户和现有客户均已禁用。我们强烈建议客户尽快将其工作负载迁移到其他解决方案。如果您对迁移有疑问，请通过 re [AWS : Post 或通过 Pre](https://repost.aws/) mium Su [AWS pp](https://aws.amazon.com/support) ort 与 AWS 支持 团队联系。
标签可以帮助您对 Chef 11.10、Chef 12 和 Chef 12.2 堆栈中的资源进行分组，并跟踪在 [AWS 账单与成本管理](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html) 中使用这些资源的成本。
您可以在堆栈和层级别应用标签。当您创建一个标签后，您将对标记的结构范围内的每个资源应用该标签。例如，如果您向某个层应用标签，该标签将应用于层中的每个实例、Amazon EBS 卷（不包括根）或 Elastic Load Balancing 负载均衡器。标签当前不能应用于实例的根，或默认的 EBS 卷。
标签是您分配给堆栈或堆栈中图层的键值对。 OpsWorks 创建标签后，打开 Billing and Cost Management 控制台以激活用户定义的标签。有关如何激活标签并使用它们来跟踪和管理 OpsWorks 堆栈资源成本的更多信息，请参阅《B *illing and Cost Management 用户指南》中的[使用成本分配标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)[和激活用户定义](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activating-tags.html)的成*本分配标签。
标签的工作方式类似于 OpsWorks Stacks 中的自定义属性。您应用于堆栈的标签将由该堆栈中的每个层继承。在图层级别，您可以覆盖继承标签的值（但不能覆盖密钥名称），并添加新的特定于图层的标签。 OpsWorks 将生成的标签集应用于图层中的所有资源。当您创建新资源或将现有资源分配到某个层时，该层中的新资源将用相同的标签集进行标记。
**Topics**
+ [在堆栈级别设置标签](#w2ab1c14c63c15)
+ [在层级别设置标签](#w2ab1c14c63c17)
+ [使用管理标签 AWS CLI](#w2ab1c14c63c19)
+ [标签限制](#w2ab1c14c63c21)
## 在堆栈级别设置标签
在堆栈级别，您可以通过在堆栈主页上选择 **Tags** 来添加和管理标签。
![\[Tags section with icon and description for applying tags to stack resources.\]](http://docs.aws.amazon.com/zh_cn/opsworks/latest/userguide/images/stack_tags.png)
在 **Tags** 页面上，将标签添加为键值对。以下屏幕截图显示了一些示例标签。您可以通过选择键值对右侧的红色 **X** 来删除标签。
![\[Tags interface showing key-value pairs for Organization and Staging, with options to add or delete tags.\]](http://docs.aws.amazon.com/zh_cn/opsworks/latest/userguide/images/stack_tags_add.png)
## 在层级别设置标签
在层级别，通过选择 **Tags** 选项卡来设置标签。您可以在 **Layers (层)** 主页以及每个层的主页上找到此选项卡。
![\[List of layers including ELB, HAProxy, Rails, PHP, Node.js, and MySQL with configuration options.\]](http://docs.aws.amazon.com/zh_cn/opsworks/latest/userguide/images/layers_tags.png)
在层级别更改或添加标签时，请注意，已在父堆栈级别添加的标签将由该层及其资源继承。虽然您可以更改继承标签的值，但无法更改键名称或删除继承标签。可在堆栈设置中更改键名称或删除从父堆栈继承的标签。以下屏幕截图显示了从堆栈级别继承的标签示例。继承标签将灰显。
![\[Tags interface showing inherited and editable fields for Organization and Staging keys.\]](http://docs.aws.amazon.com/zh_cn/opsworks/latest/userguide/images/layer_inherited_tags.png)
有关向堆栈添加标签的更多信息，请参阅[创建新堆栈](workingstacks-creating.md)。有关向层添加标签的更多信息，请参阅[编辑图 OpsWorks 层的配置](workinglayers-basics-edit.md)。
## 使用管理标签 AWS CLI
您还可以使用 AWS CLI 命令在堆栈和图层级别添加和移除标签。有关下载和安装的更多信息 AWS CLI，请参阅[安装 AWS 命令行界面](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。请记住，如果要标记的堆栈不在默认区域内，则将 `--region` 参数添加到您的命令中。图层当前 ARNs 未出现在中 AWS 管理控制台。要获取层的 ARN，请运行 [describe-layers](https://docs.aws.amazon.com/cli/latest/reference/opsworks/describe-layers.html) 命令。
**要添加标签，请使用 AWS CLI**
+ **在 AWS CLI 命令提示符处，键入以下命令，替换*stack\$1or\$1layer\$1ARN*并指定您的键值对标签，然后按 Enter。**使用反斜杠转义双引号。
```
aws opsworks tag-resource --resource-arn stack_or_layer_ARN --tags "{\"key\":\"value\",\"key\":\"value\"}"
```
示例如下：
```
aws opsworks tag-resource --resource-arn arn:aws:opsworks:us-east-2:800000000003:stack/500b99c0-ec00-4cgg-8a0d-1000000jjd1b --tags "{\"Stage\":\"Production\",\"Organization\":\"Mobile\"}"
```
**要移除标签，请使用 AWS CLI**
+ 在 AWS CLI 命令提示符处，键入以下内容，然后**按 Enter**。
```
aws opsworks untag-resource --resource-arn stack_or_layer_ARN --tag-keys "[\"key\",\"key\"]"
```
要删除标签，您只需指定要删除的标签的键即可。示例如下：
```
aws opsworks untag-resource --resource-arn arn:aws:opsworks:us-east-2:800000000003:stack/500b99c0-ec00-4cgg-8a0d-1000000jjd1b --tag-keys "[\"Stage\",\"Organization\"]"
```
**注意**
您无法从层中删除继承的标签 (在父堆栈级别添加的标签)；应该从堆栈中删除继承的标签。
## 标签限制
创建标签时，请注意以下限制。
+ OpsWorks 堆栈将堆栈和层级的用户定义标签数量限制为 40 个，包括继承自父级的用户定义标签。这就留下了 10 个可用插槽，用于存放前置的`opsworks:`默认标签以及由其他 AWS 进程设置的标签。一个资源上最多允许 50 个标签，包括由创建的用户定义和默认标签 AWS。
+ 标签键不得以 **aws:**、**opsworks:** 或 **rds:** 开头。请勿使用**name**或**Name**作为标签密钥，因为**Name**该密钥由 OpsWorks Stacks 保留。
+ 一个键最多可包含 127 个字符，并且只能包含 Unicode 字母、数字或分隔符，或以下特殊字符：`+ - = . _ : / `。
+ 一个值最多可包含 255 个字符，并且只能包含 Unicode 字母、数字或分隔符，或以下特殊字符：`+ - = . _ : / `。