標籤由一組索引值對組成，可以用於標記ECI執行個體。您可以使用標籤來分組管理ECI執行個體，便於篩選和大量操作。
背景資訊
如果您使用OpenAPI或者Elastic Container Instance控制台來管理使用ECI，您可以使用標籤來標記有相同管理或者業務需求的ECI執行個體，便於後續進行篩選和操作。
使用標籤時，請注意以下限制：
標籤都由一對索引值對組成，資源的任一標籤鍵必須唯一，不能重複。
不同地區的標籤資訊不互連。
每個ECI執行個體最多可以綁定20個標籤。
不支援單獨刪除標籤。
說明刪除標籤對應的ECI執行個體時，標籤會隨之一起刪除。
建立帶標籤的ECI執行個體
OpenAPI
調用CreateContainerGroup介面建立ECI執行個體時，您可以通過Tag參數來設定標籤。相關參數說明如下表所示。更多資訊，請參見CreateContainerGroup。
名稱 | 類型 | 樣本值 | 描述 |
Tag.N.Key | String | version | 標籤鍵。N的取值範圍為：1~20。 如果傳入該值，則不允許為空白字串，且不允許重複。最多支援64個字元，不能以 |
Tag.N.Value | String | 2.0 | 標籤值。N的取值範圍為：1~20。 如果傳入該值，可以為空白字串。最多支援128個字元，不能以 |
控制台
通過Elastic Container Instance售賣頁建立ECI執行個體時，您可以在其他設定中添加標籤。
查詢ECI執行個體的標籤
OpenAPI
調用DescribeContainerGroups介面查詢ECI執行個體時，返回參數中，Tags欄位即為該執行個體綁定的標籤，其中Key為標籤鍵，Value為標籤值。更多資訊，請參見DescribeContainerGroups。
控制台
在Elastic Container Instance控制台的容器組頁面，找到目標執行個體，滑鼠移動到對應的表徵圖，即可查看該執行個體綁定的標籤。
使用標籤過濾ECI執行個體
為ECI執行個體添加標籤後，您可以使用標籤過濾ECI執行個體，包括篩選查看ECI執行個體，或者通過標籤實現鑒權。
OpenAPI
調用DescribeContainerGroups介面查詢ECI執行個體時，您可以傳入Tag相關參數來篩選查詢ECI執行個體。更多資訊，請參見DescribeContainerGroups。
控制台
在Elastic Container Instance控制台的容器組頁面，您可以通過標籤來篩選ECI執行個體。
如果您使用阿里雲RAM使用者管理ECI資源，支援通過標籤實現鑒權，實現只允許RAM使用者操作帶有特定標籤的ECI資源。更多資訊，請參見通過標籤實現RAM使用者鑒權。
更新ECI執行個體的標籤
更新標籤前，您可以先查詢ECI執行個體已綁定哪些標籤。更新時，僅支援更新已有的標籤，或者新增標籤。不支援刪除標籤（即減少標籤個數）。
OpenAPI
調用UpdateContainerGroup介面更新ECI執行個體時，您可以傳入新的Tag相關參數來更新標籤。相關參數說明如下表所示。更多資訊，請參見UpdateContainerGroup。
名稱 | 類型 | 樣本值 | 描述 |
Tag.N.Key | String | version | 標籤鍵。N的取值範圍為：1~20。 如果傳入該值，則不允許為空白字串，且不允許重複。最多支援64個字元，不能以 |
Tag.N.Value | String | 2.0 | 標籤值。N的取值範圍為：1~20。 如果傳入該值，可以為空白字串。最多支援128個字元，不能以 |
控制台
對於已建立的ECI執行個體，您可以在容器組頁面找到目標執行個體進行修改，以更新標籤。
