# 批量重启、删除实例
![](https://support.huaweicloud.com/api-kafka/public_sys-resources/note_3.0-zh-cn.png)
当前页面API为历史版本API，未来可能停止维护。请使用[批量重启或删除实例](https://support.huaweicloud.com/api-kafka/BatchRestartOrDeleteInstances.html)。
#### 功能介绍
批量重启或删除实例。
在实例重启过程中，客户端的生产与消费消息等请求会被拒绝。
实例删除后，实例中原有的数据将被删除，且没有备份，请谨慎操作。
#### URI
POST /v1.0/{project_id}/instances/action
参数说明见[表1]。
 表1参数说明 
| 参数         | 类型     | 必选 | 说明    |
|:---|:---|:---|:---|
| project_id | String | 是  | 项目ID。 |
   
#### 请求消息
**请求参数**
参数说明见[表2]。
 表2参数说明 
| 参数         | 类型     | 必选 | 说明                              |
|:---|:---|:---|:---|
| action     | String | 是  | 对实例的操作：restart、delete           |
| instances  | Array  | 否  | 实例的ID列表。                        |
| allFailure | String | 否  | 参数值为kafka，表示删除租户所有创建失败的Kafka实例。 |
   
**请求示例**
批量重启实例
```
POST https://{dms_endpoint}/v1.0/{project_id}/instances/action
{ 
    "action" : "restart", 
    "instances" : ["54602a9d-5e22-4239-9123-77e350df4a34", "7166cdea-dbad-4d79-9610-7163e6f8b640"] 
}
```
批量删除实例
```
POST https://{dms_endpoint}/v1.0/{project_id}/instances/action
{ 
    "action" : "delete", 
    "instances" : ["54602a9d-5e22-4239-9123-77e350df4a34", "7166cdea-dbad-4d79-9610-7163e6f8b640"] 
}
```
删除所有创建失败的实例
```
POST https://{dms_endpoint}/v1.0/{project_id}/instances/action
{ 
    "action" : "delete", 
    "allFailure" : "kafka"
}
```
#### 响应消息
**响应参数**
当参数action为delete，allFailure值为kafka时，响应返回为空表示删除成功。参数说明见[表3]。
 表3参数说明 
| 参数      | 类型    | 说明       |
|:---|:---|:---|
| results | Array | 修改实例的结果。 |
   
表4results参数说明 
| 参数       | 类型     | 说明                   |
|:---|:---|:---|
| instance | String | 实例ID。                |
| result   | String | 操作结果：success、failed。 |
   
**响应示例**
```
{ 
    "results": [ 
        { 
            "result": "success", 
            "instance": "afc90a2a-a02c-4cba-94d5-58dfa9ad1e0d" 
        }, 
        { 
            "result": "success", 
            "instance": "67fc5f8d-3986-4f02-bb75-4075a23112de" 
        } 
    ] 
}
```
#### 状态码
操作成功的状态码如[表5]所示，其他响应见[状态码](https://support.huaweicloud.com/api-kafka/kafka-api-0034672261.html)。
 表5状态码 
| 状态码 | 描述          |
|:---|:---|
| 200 | 重启或者删除实例成功。 |
| 204 | 删除创建失败实例成功。 |