为 Amazon Direct Connect 资源添加标签 - Amazon Direct Connect
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 Direct Connect API、Amazon CLI、Amazon Tools for Windows PowerShell 或 Amazon SDK 标记以下 Amazon Direct Connect 资源。当您使用这些工具管理标签时,您必须为资源指定 Amazon 资源名称 (ARN)。有关 ARN 的更多信息,请参阅《Amazon Web Services 一般参考》中的 Amazon 资源名称(ARN)

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

标签限制

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

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

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

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

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

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

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

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

  • 仅对于连接、互连和 LAG 才支持成本分配标签。有关如何在成本管理中使用标签的信息,请参阅《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