Adding Tags for a DB Instance
Function
This API is used to add user tags to a specified DB instance. Before calling this API:
- Learn how to authenticate this API.
- Obtain the required region and endpoint.
URI
POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/tags
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID of a tenant in a region. For details about how to obtain the project ID, see Obtaining a Project ID. |
instance_id |
Yes |
String |
Instance ID. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
tags |
Yes |
Array of objects |
User tags to be added. For details, see Table 3. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
key |
Yes |
String |
Tag key.
NOTE:
A tag key can contain up to 128 characters. Only letters, digits, spaces, and special characters (_.:=+-@) are allowed. It cannot start with _sys_ or a space, and cannot end with a space. |
value |
Yes |
String |
Tag value.
NOTE:
A tag value can contain up to 255 characters. Only letters, digits, spaces, and special characters (_.:/=+-@) are allowed. |
Response Parameters
Parameter |
Type |
Description |
---|---|---|
instance_id |
String |
Instance ID. |
instance_name |
String |
Instance name. |
Example Request
POST https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/tags { "tags": [{ "key":"1", "value":"2" }] }
Example Response
{ "instance_id": "dsfae23fsfdsae3435in01", "instance_name": "Gauss-a87h" }
Status Code
- Normal
- Abnormal
For details, see Status Codes.
Error Code
For details, see Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot