Deleting CTS Resource Tags in Batches
Function
This API is used to delete CTS resource tags in batches.
API Calling
For details, see Calling APIs.
URI
DELETE /v3/{project_id}/{resource_type}/{resource_id}/tags/delete
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
project_id |
Yes |
String |
Project ID. For details, see Obtaining an Account ID and Project ID. |
|
resource_type |
Yes |
String |
Resource type of CTS. Only cts-tracker is supported. Value: |
|
resource_id |
Yes |
String |
Resource ID. |
Request Parameters
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
tags |
No |
Array of Tags objects |
Tag list. |
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
key |
No |
String |
Tag key, which can contain a maximum of 128 Unicode characters. A tag value can contain letters, digits, spaces, and special characters _.:=+-@. It cannot start or end with a space, or start with _sys_. |
|
value |
No |
String |
Tag value, which can contain a maximum of 255 Unicode characters. If value is specified, tags are deleted by key and value. If value is not specified, tags are deleted by key. Each tag value can contain letters, digits, spaces, and special characters _.:/=+-@. It cannot start or end with a space. |
Response Parameters
Status code: 401
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. Format: CTS.XXX. |
|
error_msg |
String |
Error message. |
Status code: 403
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. Format: CTS.XXX. |
|
error_msg |
String |
Error message. |
Status code: 404
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. Format: CTS.XXX. |
|
error_msg |
String |
Error message. |
Status code: 500
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. Format: CTS.XXX. |
|
error_msg |
String |
Error message. |
Status code: 503
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. Format: CTS.XXX. |
|
error_msg |
String |
Error message. |
Example Request
Deleting tracker tags in batches
DELETE https://{endpoint}/v3/{project_id}/{resource_type}/{resource_id}/tags/delete
{
"tags" : [ {
"key" : "111",
"value" : "33"
} ]
}
Example Response
None.
Status Codes
|
Status Code |
Description |
|---|---|
|
204 |
The deletion is successful. |
|
401 |
The request is rejected due to authentication failure. |
|
403 |
The server understood the request but refused to authorize it. |
|
404 |
The requested resource does not exist. |
|
500 |
Failed to complete the request because of an internal service error. |
|
503 |
The requested service is invalid. The client should not repeat the request without modifications. |
Error Codes
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.