Batch Restarting or Deleting Instances¶

Function¶

This API is used to restart or delete instances in batches.

When an instance is being restarted, message retrieval and creation requests of the client will be rejected.

Deleting an instance will delete the data in the instance without any backup. Exercise caution when performing this operation.

URI¶

POST /v2/{project_id}/instances/action

**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.

Request Parameters¶

**Table 2** Request body parameters¶
Parameter	Mandatory	Type	Description
instances	No	Array of strings	List of instance IDs.
action	Yes	String	Operation to be performed on instances. The value can be restart or delete.
all_failure	No	String	Value kafka indicates all Kafka instances that fail to be created are to be deleted.

Response Parameters¶

Status code: 200

**Table 3** Response body parameters¶
Parameter	Type	Description
results	Array of results objects	Result of instance modification.

**Table 4** results¶
Parameter	Type	Description
result	String	Operation result. success: The operation succeeded. failed: The operation failed.
instance	String	Instance ID.

Example Requests¶

Restarting instances in batches.

POST https://{endpoint}/v2/{project_id}/instances/action

{
  "action" : "restart",
  "instances" : [ "54602a9d-5e22-4239-9123-77e350df4a34", "7166cdea-dbad-4d79-9610-7163e6f8b640" ]
}

Deleting instances in batches.

POST https://{endpoint}/v2/{project_id}/instances/action

{
  "action" : "delete",
  "instances" : [ "54602a9d-5e22-4239-9123-77e350df4a34", "7166cdea-dbad-4d79-9610-7163e6f8b640" ]
}

Deleting all instances that fail to be created.

POST https://{endpoint}/v2/{project_id}/instances/action

{
  "action" : "delete",
  "all_failure" : "kafka"
}

Example Responses¶

Status code: 200

The instances are restarted or deleted successfully.

{
  "results" : [ {
    "result" : "success",
    "instance" : "019cacb7-4ff0-4d3c-9f33-f5f7b7fdc0e6"
  } ]
}

Status Codes¶

Status Code	Description
200	The instances are restarted or deleted successfully.
204	All Kafka instances that fail to be created are deleted successfully.

Error Codes¶

See Error Codes.

last updated: 2024-12-10 15:16 UTC - commit: ef506946dc65402760f4eb57bfda5ee36d4df62f