All Products
Search
Document Center

:CreateTag

Last Updated:Oct 29, 2025

The CreateTag operation creates a tag.

Debug

You can call this operation directly in OpenAPI Explorer. This eliminates the need to calculate signatures. After a successful call, OpenAPI Explorer automatically generates sample SDK code.

Request parameters

Name

Type

Required

Example

Description

TagName

String

Yes

vme

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

Action

String

No

CreateTag

A required parameter. Set the value to CreateTag.

TagDescription

String

No

testdescription

The tag description.

Response data

Name

Type

Example

Description

RequestId

String

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

The request ID.

TagId

String

xxxx

The tag ID.

Examples

Request example

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

Response examples

Sample response in XML format

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

Sample response in JSON format

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

Error codes

For a list of error codes, see the API Error Center.