Batch Adding or Deleting Subnet Tags
Function
This API is used to add multiple tags to or delete multiple tags from a subnet at a time.
This API is idempotent.
If there are duplicate keys in the request body when you add tags, an error is reported.
During tag creation, duplicate keys are not allowed. If a key already exists in the database, its value will be overwritten by the new duplicate key.
During tag deletion, if some tags do not exist, the deletion is considered to be successful by default. The character set of the tags will not be checked. When you delete tags, the tag structure cannot be missing, and the key cannot be left blank or be an empty string.
URI
POST /v2.0/{project_id}/subnets/{subnet_id}/tags/action
Table 1 describes the parameters.
Parameter |
Mandatory |
Description |
---|---|---|
project_id |
Yes |
Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID. |
subnet_id |
Yes |
Specifies the subnet ID, which uniquely identifies the subnet. If you use the management console, the value of this parameter is the Network ID value. |
Request Parameters
Parameter |
Type |
Mandatory |
Description |
---|---|---|---|
tags |
Array of tag objects |
Yes |
Specifies the tag object list. For details, see Table 3. |
action |
String |
Yes |
Specifies the operation. Possible values are as follows:
|
Attribute |
Type |
Mandatory |
Description |
---|---|---|---|
key |
String |
Yes |
|
value |
String |
Yes |
|
Example Request
- Batch create two tags for a subnet.
POST https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/tags/action { "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
- Batch delete two tags for a subnet.
POST https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/tags/action { "action": "delete", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
Response Parameters
None
Example Response
None
Status Code
See Status Codes.
Error Code
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