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

# 在 Amazon Connect 中將標籤新增至資源
<a name="tagging"></a>

*標籤*是一個自訂中繼資料標籤，您可將其新增到資源，以便輕鬆識別、組織和搜尋資源。標籤由兩個單獨的部分組成：標籤金鑰和標籤值。這被稱為一個 *key:value* 對。

*標籤金鑰*通常表示較大的分類，而標籤值則表示該分類的子集。例如，您可以有*標籤金鑰 = 顏色*和*標籤值 = 藍色*，這將產生 key:value 對 `Color:Blue`。您可以將標籤的值設為空字串，但您無法將標籤的值設為 Null。忽略標籤值基本上等同於使用空字串。



標籤金鑰最長可包含 128 個字元；標籤值最長可包含 256 個字元，兩者都區分大小寫。如需詳細資訊，請參閱：
+  [Amazon Connect TagResource](https://docs.aws.amazon.com/connect/latest/APIReference/API_TagResource.html)
+  [Amazon Connect Customer Profiles TagResource](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_TagResource.html) 
+  [Amazon Connect Voice ID TagResource](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_TagResource.html)：您可以將標籤新增至 Voice ID 網域。
+  [Amazon AppIntegrations TagResource](https://docs.aws.amazon.com/appintegrations/latest/APIReference/API_TagResource.html) 

Amazon Connect 服務每個資源最多支援 50 個標籤。對於特定資源，每個標籤金鑰必須是唯一的，且只有一個值。

**注意**  
您的標籤不能以 開頭，`aws:`因為 AWS 會保留此字首給系統產生的標籤。您無法新增、修改或刪除 `aws:*` 標籤，而且它們不計入每個資源的標籤數限制。

下表說明可使用 AWS CLI 或 AWS SDK 標記的 Amazon Connect 資源。


**Amazon Connect 資源的標記支援**  

| 資源 | 支援使用 Connect Customer 管理網站進行標記 | 支援使用 CLI/SDK 標記 | 支援在建立時標記 | 
| --- | --- | --- | --- | 
| 客服人員 | 是 | 是 | 是 | 
| 客服人員群組 | 否 | 是 | 是 | 
| 客服人員層級 | 否 | 否 | 是 | 
| 客服人員狀態 | 否 | 是 | 是 | 
| 案例 | 是 | 是 | 是 | 
| 聯絡 | 否 | 否 | 否 | 
| 聯絡評估 | 否 | 是 | 是 | 
| 電子郵件位址 | 是 | 是 | 是 | 
| 聯絡表單 | 是 | 是 | 是 | 
| 流程 | 是 | 是 | 是 | 
| 流程模組 | 是 | 是 | 是 | 
| 操作時數 | 是 | 是 | 是 | 
| 執行個體 | 是 | 是 | 是 | 
| 整合關聯 | 否 | 是 | 是 | 
| 傳出活動 | 否 | 是 | 是 | 
| 電話號碼 | 否 | 是 | 是 | 
| 提示 | 是 | 是 | 是 | 
| 佇列客服人員 | 否 | 否 | 是 | 
| 佇列 | 是 | 是 | 是 | 
| 快速連接 | 否 | 是 | 是 | 
| 轉接設定檔 | 是 | 是 | 是 | 
| 安全性設定檔 | 是 | 是 | 是 | 
| 標籤範本 | 否 | 否 | 是 | 
| 流量分佈群組 | 否 | 是 | 是 | 
| 轉移目的地 | 否 | 是 | 是 | 
| 使用案例 | 否 | 是 | 是 | 
| 詞彙 | 否 | 是 | 是 | 

若要進一步了解標記，包括最佳實務，請參閱《 *AWS 一般參考*》中的[標記 AWS 資源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)。

## 只有在刪除 Amazon Connect 執行個體時，才會移除標籤中繼資料
<a name="tag-retention"></a>

即使刪除資源，Amazon Connect 仍會保留資源的標籤中繼資料。只要 Amazon Connect 執行個體處於作用中狀態，中繼資料就會繼續保留。

此設計支援歷史報告和存取控制 (TBAC) 使用案例。具體而言，Amazon Connect 會針對歷史指標使用標籤型存取控制。如果在刪除資源時立即移除標籤，則先前無法存取這些資源的使用者可能會無意中存取涉及這些資源的歷史指標。保留標籤可確保存取權限隨時不變。

只有刪除整個 Amazon Connect 執行個體之後，標籤才會移除，此時歷史資料存取將不再適用。

## 標籤型存取控制
<a name="tagging-access-control"></a>

若要使用標籤來控制 AWS 對帳戶中資源的存取，您需要在 IAM 政策的條件元素中提供標籤資訊。例如，若要根據您指派給 Voice ID 網域的標籤來控制對 Voice ID 網域的存取，請使用 `aws:ResourceTag/key-name` 條件金鑰來指定哪個標籤：鍵值配對必須附加至網域，以允許其執行指定動作。

如需 Amazon Connect 主控台中標籤型存取控制的詳細資訊，請參閱 [在 Amazon Connect 中套用標籤型存取控制](tag-based-access-control.md)。

如需 IAM 中標籤型存取控制的詳細資訊，請參閱《*IAM 使用者指南*》中的[使用標籤控制對 AWS 資源的存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)