Adding Tags to a DeH in Batches
Function
- This API is used to add tags to a specified DeH in batches.
- Tag Management Service (TMS) uses this API to batch add tags to a DeH.
Constraint
- A DeH allows a maximum of 10 tags.
- This API is idempotent.
During tag creation, if a tag exists (both the key and value are the same as those of an existing tag), the tag is successfully processed by default.
- A new tag will overwrite the original one if their keys are the same and values are different.
URI
POST /v1.0/{project_id}/dedicated-host-tags/{dedicated_host_id}/tags/action
Table 1 describes the parameters.
Parameter |
Type |
Mandatory |
Description |
---|---|---|---|
project_id |
String |
Yes |
Specifies the project ID. For details about how to obtain the project ID, see Obtaining a Project ID. |
dedicated_host_id |
String |
Yes |
Specifies the DeH ID. You can obtain the value from the DeH console or using the API in Querying DeHs. |
Request
Parameter |
Type |
Mandatory |
Description |
---|---|---|---|
tags |
Array of objects |
Yes |
Specifies the tag list. For details, see Table 3. |
action |
String |
Yes |
Specifies the operation. Only lowercase letters are supported. For example, create indicates the creation operation. |
Parameter |
Type |
Mandatory |
Description |
---|---|---|---|
key |
String |
Yes |
Specifies the tag key.
|
value |
String |
Yes |
Specifies the tag value.
|
Response
N/A
Example Request
POST https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-host-tags/74259164-e63a-4ad9-9c77-a1bd2c9aa187/tags/action { "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] }
Example Response
N/A
Status Code
See Status 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