Adding Tags to a Specified Cluster
Function
This API is used to add tags to a specified cluster.
A cluster has a maximum of 20 tags. This API is idempotent. If a tag to be created has the same key as an existing tag, the tag will overwrite the existing one.
URI
- Format
POST /v1.1/{project_id}/clusters/{cluster_id}/tags
- Parameter description
Table 1 URI parameters Parameter
Mandatory
Type
Description
project_id
Yes
String
Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
cluster_id
Yes
String
Cluster ID For details about how to obtain the cluster ID, see Obtaining the MRS Cluster Information.
Request Parameters
Parameter | Mandatory | Type | Description |
---|---|---|---|
tag | Yes | Tag object | The cluster tag. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
key | Yes | String | Key. A tag key cannot contain special characters (=*<>\,|/) or start or end with a space. |
value | Yes | String | Tag value. A tag value cannot contain special characters (=*<>\,|/) or start or end with a space. |
Response Parameters
None
Example Request
Add a tag to a specified cluster.
{"tag":{"key":"DEV","value":"DEV1"}}
Example response
None
Status Codes
Table 4 describes the status code.
Status Code | Description |
---|---|
204 | The operation is successful. |
Error Codes
See Error Codes.
- Function
- URI
- Request Parameters
- Response Parameters
- Example Request
- Example response
- Status Codes
- Error Codes