All Products
Search
Document Center

Resource Management:TagResources

Last Updated:Aug 28, 2026

Adds tags to resource groups or the members in a resource directory.

Operation description

This topic provides an example on how to call the API operation to add the tag k1:v1 to the resource group with an ID of rg-aekz6bre2uq****.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

ResourceId

array

Yes

The ID of a resource group or member.

string

No

The ID of a resource group or member.

You can specify a maximum of 50 IDs.

rg-aekz6bre2uq****

Tag

array<object>

Yes

The tags.

object

No

The tags.

Key

string

No

A tag key.

A tag key can be a maximum of 128 characters in length. It cannot contain http:// or https:// and cannot start with acs: or aliyun.

k1

Value

string

No

A tag value.

A tag value can be a maximum of 128 characters in length. It cannot contain http:// or https:// and cannot start with acs:.

v1

ResourceType

string

No

The type of the objects to which you want to add tags. Valid values:

  • ResourceGroup : resource group. This is the default value.

  • Account: member.

Note

This parameter is required if you add tags to members in a resource directory.

ResourceGroup

For more information about common request parameters, see Common parameters.

Response elements

Element

Type

Description

Example

object

RequestId

string

The ID of the request.

E7747EDF-EDDC-5B38-9B6A-6392B9C92B1C

Examples

Success response

JSON format

{
  "RequestId": "E7747EDF-EDDC-5B38-9B6A-6392B9C92B1C"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.