Help Center/ Cloud Trace Service/ API Reference (Ally Region)/ APIs/ Tracker Management/ Deleting a Tracker
Updated on 2026-01-04 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Deleting a Tracker

Function

This API is used to delete trackers. Only data trackers can be deleted. Deleting a tracker has no impact on the collected traces. When you enable CTS again, you can still view those traces.

Calling Method

For details, see Calling APIs.

URI

DELETE /v3/{project_id}/trackers

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details, see Obtaining an Account ID and Project ID.
Table 2 Query Parameters

Parameter

Mandatory

Type

Description

tracker_name

No

String

Tracker name.

If this parameter is not specified, all data trackers of a tenant will be deleted.

tracker_type

No

String

Tracker type.

Only data trackers can be deleted. The default value is data.

Request Parameters

None

Response Parameters

Status code: 204

The tracker is deleted.

Status code: 400

Table 3 Response body parameters

Parameter

Type

Description

error_code

String

Error code. Format: CTS.XXX.

error_msg

String

Error message.

Status code: 401

Table 4 Response body parameters

Parameter

Type

Description

error_code

String

Error code. Format: CTS.XXX.

error_msg

String

Error message.

Status code: 403

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Error code. Format: CTS.XXX.

error_msg

String

Error message.

Status code: 404

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Error code. Format: CTS.XXX.

error_msg

String

Error message.

Status code: 500

Table 7 Response body parameters

Parameter

Type

Description

error_code

String

Error code. Format: CTS.XXX.

error_msg

String

Error message.

Status code: 503

Table 8 Response body parameters

Parameter

Type

Description

error_code

String

Error code. Format: CTS.XXX.

error_msg

String

Error message.

Example Requests

DELETE https://{endpoint}/v3/{project_id}/trackers?tracker_name=data-tracker-name

Example Responses

None

Status Codes

Status Code

Description

204

The tracker is deleted.

400

The server failed to process the request.

401

The request is rejected due to authentication failure.

403

The server understood the request but refused to authorize it.

404

The server failed to find the requested resource or some trackers failed to be deleted.

500

The server has received the request but encountered an internal error, or some trackers failed to be deleted.

503

The requested service is unavailable. The client should not repeat the request without modifications.

Error Codes

See Error Codes.

Parent topic: Tracker Management