全部产品
Search
文档中心

使用标签管理ECI实例

更新时间: 2021-09-10

标签由一组键值对组成,可以用于标记ECI实例。您可以使用标签来分组管理ECI实例,便于筛选和批量操作。

背景信息

如果您使用OpenAPI或者弹性容器实例控制台来管理使用ECI,您可以使用标签来标记有相同管理或者业务需求的ECI实例,便于后续进行筛选和操作。

使用标签时,请注意以下限制:

  • 标签都由一对键值对组成,资源的任一标签键必须唯一,不能重复。

  • 不同地域的标签信息不互通。

  • 每个ECI实例最多可以绑定20个标签。

  • 不支持单独删除标签。

    说明

    删除标签对应的ECI实例时,标签会随之一起删除。

创建带标签的ECI实例

OpenAPI方式

调用CreateContainerGroup接口创建ECI实例时,您可以通过Tag参数来设置标签。相关参数说明如下表所示。更多信息,请参见CreateContainerGroup

名称

类型

示例值

描述

Tag.N.Key

String

version

标签键。N的取值范围为:1~20。

如果传入该值,则不允许为空字符串,且不允许重复。最多支持64个字符,不能以aliyunacs:开头,不能包含http://或者https://

Tag.N.Value

String

2.0

标签值。N的取值范围为:1~20。

如果传入该值,可以为空字符串。最多支持128个字符,不能以acs:开头,不能包含http://或者https://

控制台方式

通过弹性容器实例售卖页创建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个字符,不能以aliyunacs:开头,不能包含http://或者https://

Tag.N.Value

String

2.0

标签值。N的取值范围为:1~20。

如果传入该值,可以为空字符串。最多支持128个字符,不能以acs:开头,不能包含http://或者https://

控制台方式

对于已创建的ECI实例,您可以在容器组页面找到目标实例进行修改,以更新标签。如下图所示。

更新标签