All Products
Search
Document Center

:CreateTag

Last Updated:Dec 26, 2025

You can call the CreateTag operation to create a tag.

Debug

In OpenAPI Explorer, you can call this operation directly without having to calculate signatures. After a successful call, OpenAPI Explorer automatically generates SDK code examples.

Request parameters

Name

Type

Required

Example value

Description

TagName

String

Yes

vme

The name of the tag. Constraints: The name must be 1 to 50 characters in length and can contain letters, digits, and underscores (_).

Action

String

No

CreateTag

A system parameter. Set the value to CreateTag.

TagDescription

String

No

testdescription

The description of the tag.

Returned data

Name

Type

Example

Description

RequestId

String

10A1AD70-E48E-476D-98D9-39BD92193837

The ID of the request.

TagId

String

xxxx

The ID of the tag.

Examples

Request example

http(s)://dm.aliyuncs.com/?Action=CreateTag
&TagName=vme
&TagDescription=testdescription
&<Common request parameters>

Sample normal response

XML format

<CreateTagResponse>
      <RequestId>10A1AD70-E48E-476D-98D9-39BD92193837</RequestId>
      <TagId>xxxx</TagId>
</CreateTagResponse>

JSON format

{
        "RequestId":"10A1AD70-E48E-476D-98D9-39BD92193837",
        "TagId":"xxxx"
}

Error codes

For a list of error codes, visit the Error Center.