Help Center/ Distributed Message Service for Kafka/ API Reference (Ally Region)/ APIs V2 (Recommended)/ Managing Lifecycle/ Deleting an Instance
Updated on 2025-12-29 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Deleting an Instance

Function

This API is used to delete an instance to release all the resources occupied by it.

Note: Instances will be permanently deleted by calling this API. If you want to move them to the recycle bin, use Batch Restarting or Deleting Instances.

URI

DELETE /v2/{project_id}/instances/{instance_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details about how to obtain it, see Obtaining a Project ID.

instance_id

Yes

String

Instance ID.

Request Parameters

None

Response Parameters

Status code: 204

The specified instance is deleted successfully.

None

Example Requests

Deleting an instance

DELETE https://{endpoint}/v2/{project_id}/instances/{instance_id}

Example Responses

None

Status Codes

Status Code

Description

204

The specified instance is deleted successfully.

Error Codes

See Error Codes.

Parent topic: Managing Lifecycle