標記 AWS Direct Connect 資源

標籤是資源擁有者指派給其資 AWS Direct Connect 源的標籤。每個標籤皆包含由您定義的一個金鑰與一個選用值。標籤可讓資源擁有者以不同的方式來分類您的 AWS Direct Connect 資源，例如，依目的或環境。當您有許多相同類型的資源時，這將會很有用，因為您可以依據先前指派的標籤，快速識別特定的資源。

例如，您在一個「區域」中有兩個 AWS Direct Connect 連接對，每個連接都位於不同的位置。連線 dxcon-11aa22bb 是服務生產流量的連線，與虛擬介面 dxvif-33cc44dd 相關聯。連線 dxcon-abcabcab 是備援 (備用) 連線，與虛擬介面 dxvif-12312312 相關聯。您可以選擇為這些連線和虛擬介面加上標籤，幫助您進行區分，如下所示：

資源 ID	標籤鍵	標籤值
dxcon-11aa22bb	用途	生產
	位置	阿姆斯特丹
dxvif-33cc44dd	用途	生產
dxcon-abcabcab	用途	備份
	位置	法蘭克福
dxvif-12312312	用途	備份

我們建議您為每種資源類型建立符合您需求的標籤金鑰。使用一致的標籤金鑰組可讓您更輕鬆管理您的 資源。標籤沒有任何語義意義， AWS Direct Connect 並嚴格解釋為字符串。此外，標籤不會自動指派給您的資源。您可以編輯標籤金鑰和值，並且可以隨時從資源移除標籤。您可以將標籤的值設為空白字串，但您無法將標籤的值設為 Null。若您將與現有標籤具有相同鍵的標籤新增到該資源，則新值會覆寫舊值。如果您刪除資源，也會刪除任何該資源的標籤。

您可以使用 AWS Direct Connect 主控台、、、或標記下列 AWS Direct Connect 資源 AWS SDK。 AWS Direct Connect API AWS CLI AWS Tools for Windows PowerShell使用這些工具管理標籤時，必須指定資源的 Amazon 資源名稱 (ARN)。如需有關的詳 Amazon 資訊 ARNs，請參閱 Amazon Web Services 一般參考. ARNs

資源	支援標籤	支援建立時加上標籤	支援標籤控制存取和資源分配	支援成本分配
連線	是	是	是	是
虛擬介面	是	是	是	否
連結彙總群組 (LAG)	是	是	是	是
互連	是	是	是	是
Direct Connect 閘道	否	否	否	否

標籤限制

標籤適用的規定和限制如下：

• 每個資源的標籤數上限：50

• 索引鍵長度上限：128 個 Unicode 字元

• 數值長度上限：265 個 Unicode 字元

• 標籤金鑰與值皆區分大小寫。

• 前aws:綴保留供 AWS 使用。如果標籤具有字首為 aws: 的標籤金鑰時，您無法編輯或刪除標籤的金鑰或值。具有字首為 aws: 的標籤金鑰的標籤，不會算在每個資源的標籤數限制內。

• 允許的字元為 UTF -8 中可表示的字母、空格和數字，加上下列特殊字元：+-=。_:/@

• 只有資源擁有者可以新增或移除標籤。例如，如果存在託管連線，則合作夥伴無法新增、移除或檢視這些標籤。

• 成本分配標籤僅支援連線、互連和LAGs。有關如何在成本管理中使用標籤的詳細資訊，請參閱使用 AWS 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