Batch Deleting Tags from a Listener
Function
This API is used to batch delete tags from a listener.
Constraints
- A maximum of 10 tags can be added to a listener.
- This API is idempotent.
- Note the following when you delete tags:
- If the tag to be deleted does not exist, the deletion is considered successful by default.
- The value range of the tag character set is not verified.
- The tag structure body cannot be missing, and the key cannot be left blank or set to an empty string.
- The value of action must be delete.
URI
POST /v2.0/{project_id}/listeners/{listener_id}/tags/action
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Specifies the ID of the project where the tag is used. |
listener_id |
Yes |
String |
Specifies the ID of the listener from which a tag is to be deleted. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
Specifies the user token. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
tags |
Yes |
Array |
Specifies the tags. For details, see Table 4. |
action |
Yes |
String |
Specifies the operation identifier. The value can be:
|
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
key |
Yes |
String |
Specifies the tag name. The tag:
|
value |
Yes |
String |
Specifies the tag value. The value:
|
Response Parameters
None
Example Request
- Example request
POST https://{Endpoint}/v2.0/6a0de1c3-7d74-4f4a-b75e-e57135bd2b97/listeners/7add33ad-11dc-4ab9-a50f-419703f13163/tags/action { "action": "delete", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] }
Status Code
For details, 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