Help Center/ Distributed Message Service for Kafka/ API Reference (Paris Region)/ Out-of-Date APIs/ API V1/ APIs for Managing Instances/ Deleting Topics in a Kafka Instance in Batches
Updated on 2023-08-29 GMT+08:00
View PDF
Share

Deleting Topics in a Kafka Instance in Batches

This API is out-of-date and may not be maintained in the future. Please use the API described in Batch Deleting Topics of a Kafka Instance.

Function

This API is used to delete topics in a Kafka instance in batches.

URI

POST /v1.0/{project_id}/instances/{instance_id}/topics/delete

Table 1 describes the parameter.

Table 1 Parameters

Parameter

Type

Mandatory

Description

project_id

String

Yes

Indicates the ID of a project.

instance_id

String

Yes

Indicates the instance ID.

Request

Request parameters

Table 2 describes the parameter.

Table 2 Request parameter

Parameter

Type

Mandatory

Description

topics

Array

Yes

Indicates the list of topics to be deleted.

Example request

POST https://{dms_endpoint}/v1.0/{project_id}/instances/{instance_id}/topics/delete
{
  "topics" : ["hah", "aabb"]
 }

Response

Response parameters

Table 3 describes the parameter.

Table 3 Response parameters

Parameter

Type

Description

topics

Array

Indicates the list of topics.
Table 4 topics parameter description

Parameter

Type

Description

id

String

Indicates the topic name.

success

Boolean

Indicates whether the topics are deleted.

Example response

{
  "topics" : [{
      "id" : "haha",
      "success" : true
    }, {
      "id" : "aabb",
      "success" : true
    }
  ]
}

Status Code

Table 5 describes the status code of successful operations. For details about other status codes, see Status Code.

Table 5 Status code

Status Code

Description

200

The topics are successfully deleted.