- APIs
- Subnet Tag Management
- Batch Creating or Deleting Subnet Tags
Batch Creating 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.
Name | Mandatory | Description |
---|---|---|
project_id | Yes | Specifies the 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.