为 Amazon Direct Connect 资源添加标签 - Amazon Direct Connect
标签限制使用CLI或处理标签 API
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

为 Amazon Direct Connect 资源添加标签

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

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

资源 ID 标签密钥 标签值
dxcon-11aa22bb 用途 生产
位置 阿姆斯特丹
dxvif-33cc44dd 用途 生产
dxcon-abcabcab 用途 备份
位置 法兰克福
dxvif-12312312 用途 备份

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

您可以使用 Amazon Direct Connect 控制台、、、或 Amazon Tools for Windows PowerShell，为 Amazon CLI以下 Amazon Direct Connect 资源添加标签 Amazon SDK。 Amazon Direct Connect API使用这些工具管理标签时，必须为资源指定 Amazon 资源名称 (ARN)。有关更多信息ARNs，请参阅中的 Amazon 资源名称 (ARNs) Amazon Web Services 一般参考。

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

标签限制

下面是适用于标签的规则和限制：

  • 每个资源的最大标签数：50

  • 最大密钥长度：128 个 Unicode 字符

  • 最大值长度：265 个 Unicode 字符

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

  • 该aws:前缀已保留供 Amazon 使用。当标签具有带 aws: 前缀的标签键时，您将无法编辑或删除标签的键或值。具有带 aws: 前缀的标签键的标签不计入每个资源的标签数限制。

  • 允许的字符包括可用 UTF -8 表示的字母、空格和数字，以及以下特殊字符：+-=。_:/@

  • 只有资源拥有者可以添加或删除标签。例如，如果有一个托管连接，合作伙伴将无法添加、删除或查看标签。

  • 成本分配标签仅支持连接、互连和。LAGs有关如何在成本管理中使用标签的信息，请参阅 Amazon Billing and Cost Management 用户指南中的使用成本分配标签。

使用CLI或处理标签 API

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

任务 API CLI
添加或覆盖一个或多个标签。 TagResource tag-resource
删除一个或多个标签。 UntagResource untag-resource
描述一个或多个标签。 DescribeTags describe-tags

示例

使用 tag-resource 命令标记连接 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 命令描述连接 dxcon-11aa22bb 标签。

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

使用 untag-resource 命令删除连接 dxcon-11aa22bb 中的标签。

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