标签由一组键值对组成，可以用于标记ECI实例。您可以使用标签来分组管理ECI实例，便于筛选和批量操作。
背景信息
如果您使用OpenAPI或者弹性容器实例控制台来管理使用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个字符，不能以 |
控制台
通过弹性容器实例售卖页创建ECI实例时，您可以在其他设置中添加标签。
查询ECI实例的标签
OpenAPI
调用DescribeContainerGroups接口查询ECI实例时，返回参数中，Tags字段即为该实例绑定的标签，其中Key为标签键，Value为标签值。更多信息，请参见DescribeContainerGroups。
控制台
在弹性容器实例控制台的容器组页面，找到目标实例，鼠标移动到对应的图标，即可查看该实例绑定的标签。
使用标签过滤ECI实例
为ECI实例添加标签后，您可以使用标签过滤ECI实例，包括筛选查看ECI实例，或者通过标签实现鉴权。
OpenAPI
调用DescribeContainerGroups接口查询ECI实例时，您可以传入Tag相关参数来筛选查询ECI实例。更多信息，请参见DescribeContainerGroups。
控制台
在弹性容器实例控制台的容器组页面，您可以通过标签来筛选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实例，您可以在容器组页面找到目标实例进行修改，以更新标签。
