本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 標記 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_tw/directconnect/latest/UserGuide/using-tags.html)

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

您可以使用 Direct Connect 主控台、 Direct Connect API、 AWS Tools for Windows PowerShell、 或 AWS SDK AWS CLI來標記下列 Direct Connect 資源。當您使用這些工具來管理標籤時，您必須指定資源的 Amazon Resource Name (ARN)。如需 ARN 的詳細資訊，請參閱《Amazon Web Services 一般參考》**中的 [Amazon Resource Name (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
```