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

# 标记 AWS Direct Connect 资源
<a name="using-tags"></a>

标签是资源拥有者分配给其 Direct Connect 资源的签条。每个标签都包含定义的一个键和一个可选值。标签可让资源拥有者按不同方式（例如，按用途或环境）对 Direct Connect 资源进行分类。这在您拥有许多同类型资源时很有用 - 您可以根据分配给资源的标签快速识别特定资源。

例如，在一个区域中有两个 Direct Connect 连接，每个连接处于不同的位置。连接 `dxcon-11aa22bb` 是服务生产流量的连接，与虚拟接口 `dxvif-33cc44dd` 相关联。连接 `dxcon-abcabcab` 是冗余（备份）连接，与虚拟接口 `dxvif-12312312` 相关联。您可以选择用以下方式为连接和虚拟接口添加标签来进行区分：

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/directconnect/latest/UserGuide/using-tags.html)

我们建议您针对每类资源设计一组标签，以满足您的需要。使用一组连续的标签键，管理资源时会更加轻松。标签对Direct Connect没有任何语义意义，应严格按字符串进行解析。同时，标签不会自动分配至您的资源。您可以修改标签的密钥和值，还可以随时删除资源的标签。您可以将标签的值设为空的字符串，但是不能将其设为空值。如果您添加的标签的值与该实例上现有标签的值相同，新的值就会覆盖旧值。如果删除资源，资源的所有标签也会被删除。

您可以使用 Direct Connect 控制台、Direct Connect API、AWS CLI、AWS Tools for Windows PowerShell 或 AWS SDK 标记以下 Direct Connect 资源。当您使用这些工具管理标签时，您必须为资源指定 Amazon 资源名称 (ARN)。有关 ARN 的更多信息，请参阅《Amazon Web Services 一般参考》**中的 [Amazon 资源名称（ARN）](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)。


| 资源 | 支持标签 | 支持在创建时标记 | 支持通过标签控制访问和资源分配 | 支持成本分配 | 
| --- | --- | --- | --- | --- | 
| 连接 |  支持 | 是 | 是 | 是 | 
| 虚拟接口 | 支持 | 是 | 是 | 否 | 
| 链接聚合组 (LAG) | 支持 | 是 | 是 | 是 | 
| 互连 | 支持 | 是 | 是 | 是 | 
| Direct Connect 网关 | 支持 | 是 | 是 | 否 | 

## 标签限制
<a name="using-tags-restrictions"></a>

下面是适用于标签的规则和限制：
+ 每个资源的最大标签数：50
+ 最大密钥长度：128 个 Unicode 字符
+ 最大值长度：265 个 Unicode 字符
+ 标签键和值区分大小写。
+ `aws:` 前缀专门预留供 AWS 使用。当标签具有带 `aws:` 前缀的标签键时，您将无法编辑或删除标签的键或值。具有带 `aws:` 前缀的标签键的标签不计入每个资源的标签数限制。
+ 允许使用的字符包括可用 UTF-8 格式表示的字母、空格和数字，以及以下特殊字符：\$1 - = . \$1 : / @
+ 只有资源拥有者可以添加或删除标签。例如，如果有一个托管连接，合作伙伴将无法添加、删除或查看标签。
+ 仅对于连接、互连和 LAG 才支持成本分配标签。有关如何在成本管理中使用标签的信息，请参阅《AWS 账单与成本管理 用户指南》**中的[使用成本分配标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。

## 通过 CLI 或 API 使用标签
<a name="working-with-tags"></a>

使用以下命令添加、更新、列出和删除资源标签。


| 任务 | API | CLI | 
| --- | --- | --- | 
| 添加或覆盖一个或多个标签。 |  [TagResource](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_TagResource.html) | [ - tag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/tag-resource.html) | 
| 删除一个或多个标签。 |  [UntagResource](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_UntagResource.html) | [ - untag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/untag-resource.html) | 
| 描述一个或多个标签。 | [DescribeTags](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_DescribeTags.html) | [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/directconnect/describe-tags.html) | 

### 示例
<a name="working-with-tags-examples"></a>

使用 [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/tag-resource.html) 命令标记连接 `dxcon-11aa22bb`。

```
aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tags "key=Purpose,value=Production"
```

使用 [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/directconnect/describe-tags.html) 命令描述连接 `dxcon-11aa22bb` 标签。

```
aws directconnect describe-tags --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb
```

使用 [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/untag-resource.html) 命令删除连接 `dxcon-11aa22bb` 中的标签。

```
aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tag-keys Purpose
```