All Products
Search
Document Center

Use tags to manage elastic container instances

Last Updated: Jul 08, 2021

Each tag is a key-value pair and can be used to mark elastic container instances. You can use tags to manage elastic container instances by group to perform searches and batch operations with ease.

Background information

If you use or manage elastic container instances by calling API operations or by using the Elastic Container Instance console, you can use tags to group instances that share the same management or business requirements for easy search and operations.

When you use tags, take note of the following limits:

  • Each tag consists of a tag key and a tag value. The tag key must be unique.

  • Tag information cannot be shared across regions.

  • Up to 20 tags can be added to a single elastic container instance.

  • Tags cannot be separately deleted.

    Note

    When an elastic container instance is deleted, the tags added to the instance are also deleted.

Create an elastic container instance that has tags

Call an API operation

When you call the CreateContainerGroup operation to create an elastic container instance, you can use the tag-related parameters to specify tags. The following table describes the parameters. For more information, see CreateContainerGroup.

Parameter

Type

Example

Description

Tag.N.Key

String

version

The key of tag N. Valid values of N: 1 to 20.

The tag key cannot be an empty string and must be unique. It can be up to 64 characters in length and cannot start with acs: or aliyun. It cannot contain http:// or https://.

Tag.N.Value

String

2.0

The value of tag N. Valid values of N: 1 to 20.

The tag value can be an empty string. It can be up to 128 characters in length. It cannot start with acs: or contain http:// or https://.

Use the console

When you create elastic container instances on the instance buy page in the Elastic Container Instance console, you can add tags to the instances in the Other Settings step, as shown in the following figure.

Add Tag

Query the tags of an elastic container instance

Call an API operation

When you call the DescribeContainerGroups operation to query elastic container instances, the Tags response parameters indicate the tags of the instances. The Key response parameter indicates the tag key, and the Value response parameter indicates the tag value. For more information, see DescribeContainerGroups.

Use the console

Go to the Elastic Container Instance page in the Elastic Container Instance console. Find the instance whose tags you want to query and move the pointer over the icon in the Tag column to view the tags of the instance, as shown in the following figure.

View tags

Use tags to filter elastic container instances

After you add tags to elastic container instances, you can use the tags to search for or authenticate to the instances.

Call an API operation

When you call the DescribeContainerGroups operation to query elastic container instances, you can use the tag-related parameters to filter instances. For more information, see DescribeContainerGroups.

Use the console

On the Elastic Container Instance page in the Elastic Container Instance console, you can use tags to filter elastic container instances.

Filter instances by tag
Note

If you use a Resource Access Management (RAM) user to manage Elastic Container Instance resources, you can use tags to limit users to perform operations only on resources that have specific tags. For more information, see Authenticate RAM users based on tags.

Update the tags of an elastic container instance

Before you update tags for an elastic container instance, you can first query the tags that are added to the instance. When you update tags for an elastic container instance, you can only update the existing tags or add new tags. Tags cannot be deleted from elastic container instances and the number of tags on each elastic container instance cannot be reduced.

Call an API operation

When you call the UpdateContainerGroup operation to update an elastic container instance, you can use the tag-related parameters to update tags. The following table describes the parameters. For more information, see UpdateContainerGroup.

Parameter

Type

Example

Description

Tag.N.Key

String

version

The key of tag N. Valid values of N: 1 to 20.

The tag key cannot be an empty string and must be unique. It can be up to 64 characters in length and cannot start with acs: or aliyun. It cannot contain http:// or https://.

Tag.N.Value

String

2.0

The value of tag N. Valid values of N: 1 to 20.

The tag value can be an empty string. It can be up to 128 characters in length. It cannot start with acs: or contain http:// or https://.

Use the console

On the Elastic Container Instance page in the Elastic Container Instance console, you can select a created instance and update its tags, as shown in the following figure.

Update tags