Creating Resource Tags¶
Function¶
This API is used to create tags for resources of a specific type.
Constraints¶
A resource can have up to 20 tags.
This API is idempotent.
If a tag to be created has the same key as an existing tag, the tag will be created and overwrite the existing one.
URI¶
POST /v3/{project_id}/{resource_type}/{resource_id}/tags
Parameter | Mandatory | Type | Description |
---|---|---|---|
project_id | Yes | String | Project ID |
resource_id | Yes | String | Resource ID |
resource_type | Yes | String | Resource type.
|
Request Parameters¶
Parameter | Mandatory | Type | Description |
---|---|---|---|
key | No | String | Tag key. The value contain up to 128 characters (36 characters on the console), including uppercase letters, lowercase letters, digits, hyphens (-), underscores (_), and at signs (@). Minimum: 1 Maximum: 128 |
value | No | String | Tag value. The value contain up to 128 characters in API (43 characters on the console), including uppercase letters, lowercase letters, digits, hyphens (-), underscores (_), and at signs (@). Minimum: 0 Maximum: 128 |
Response Parameters¶
None
Example Requests¶
Creating tags for a resource
POST https://{erouter-endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/instance/3320166e-b937-40cc-a35c-02cd3f2b3ee2/tags
{
"tag" : {
"key" : "key1",
"value" : "value1"
}
}
Example Responses¶
None
Status Codes¶
Status Code | Description |
---|---|
204 | No Content |
Error Codes¶
See Error Codes.