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

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

为 AWS Direct Connect 资源添加标签

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

例如,在一个区域中有两个 AWS Direct Connect 连接,每个连接处于不同的位置。连接 dxcon-11aa22bb 是提供生产流量的连接,与虚拟接口相关联 dxvif-33cc44dd。连接 dxcon-abcabcab 是冗余(备份)连接,与虚拟接口关联 dxvif-12312312。您可以选择将连接和虚拟接口标记为以下标记,以帮助区分它们:

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

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

您可以使用 AWS Direct Connect 控制台、AWS Direct Connect API、AWS CLI、适用于 Windows PowerShell 的 AWS 工具 或 AWS 开发工具包标记以下 AWS Direct Connect 资源。当您使用这些工具管理标签时,您必须为资源指定 Amazon 资源名称 (ARN)。有关ARN的更多信息,请参阅 Amazon资源名称(ARN)和AWS服务命名空间Amazon Web Services 一般参考.

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

标签限制

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

  • 每个资源的最大标记数: 50

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

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

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

  • aws: 前缀是专为 AWS 使用预留的。当标签具有带 aws: 前缀的标签键时,您将无法编辑或删除标签的键或值。具有带 aws: 前缀的标签键的标签不计入每个资源的标签数限制。

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

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

  • 仅对于连接、互连和 LAG 才支持成本分配标签。有关如何使用标签进行成本管理的信息,请参阅 使用成本分配标记 AWS Billing and Cost Management 用户指南.

通过 CLI 或 API 使用标签

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

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

Examples

使用 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