Adds tags to one or more resources.
Try it now
Test
RAM authorization
Request syntax
POST /tags HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| body |
object |
No |
The request body. |
|
| resourceType |
string |
Yes |
The resource type. |
Service |
| resourceId |
array |
Yes |
A list of resource IDs. |
|
|
string |
No |
A resource ID. |
test |
|
| tag |
array |
No |
The tags. You can attach a maximum of 20 tags. |
|
| Tag |
No |
A tag. |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| requestId |
string |
The request ID. |
3B311FD9-A60B-55E0-A896-A0C73********* |
Examples
Success response
JSON format
{
"requestId": "3B311FD9-A60B-55E0-A896-A0C73*********"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParameter.ResourceId | The ResourceId parameter is invalid. | |
| 400 | InvalidResourceId.NotFound | The specified ResourceIds are not found in our records. | |
| 400 | NumberExceed.ResourceIds | The maximum number of ResourceIds is exceeded. | |
| 400 | InvalidParameter.RegionId | The RegionId parameter is invalid. | |
| 400 | InvalidParameter.ResourceType | The ResourceType parameter is invalid. | |
| 400 | MissingParameter.ResourceIds | You must specify ResourceId.N. | |
| 400 | MissingParameter.ResourceType | You must specify ResourceType. | |
| 400 | MissingParameter.Tags | You must specify Tags. | |
| 400 | MissingParameter.TagKey | You must specify Tag.N.Key. | |
| 400 | MissingParameter.TagValue | You must specify Tag.N.Value. | |
| 400 | InvalidParameter.TagKey | The Tag.N.Key parameter is invalid. | |
| 400 | InvalidParameter.TagValue | The Tag.N.Value parameter is invalid. | |
| 400 | NumberExceed.Tags | The maximum number of Tags is exceeded. | |
| 400 | QuotaExceed.TagsPerResource | The maximum number of tags for each resource is exceeded. | |
| 400 | Duplicate.TagKey | The Tag.N.Key contains duplicate keys. | |
| 500 | InvalidOperation.ConcurrentModification | The resource is modified concurrently. | |
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 403 | NoPermission | The operator is not permission for this operate |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.