删除主机
功能介绍
根据主机id删除主机。
调试
您可以在API Explorer中调试该接口。
URI
DELETE /v2/host-groups/{group_id}/hosts/{host_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
group_id |
是 |
String |
主机组id |
host_id |
是 |
String |
主机id |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-Type |
是 |
String |
消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json;charset=utf-8 枚举值:
|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) 最小长度:0 最大长度:20000 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
host_id |
String |
主机id |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:8 最大长度:36 |
error_msg |
String |
错误描述 最小长度:2 最大长度:512 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:8 最大长度:36 |
error_msg |
String |
错误描述 最小长度:2 最大长度:512 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:8 最大长度:36 |
error_msg |
String |
错误描述 最小长度:2 最大长度:512 |
请求示例
https://{endpoint}/v2/host-groups/ab7647b0863c4e969c8949d38d591339/hosts/300d6d2e53624d0da08b182099ad10f7
响应示例
状态码: 200
OK
{ "host_id" : "300d6d2e53624d0da08b182099ad10f7" }
状态码: 400
Bad Request
{ "error_code" : "Deploy.00021104", "error_msg" : "The host group does not exist." }
状态码: 401
Unauthorized
{ "error_code" : "Deploy.00021206", "error_msg" : "You do not have permission to delete hosts." }
状态码: 403
Forbidden
{ "error_code" : "Deploy.00021204", "error_msg" : "This user is pending real-name authentication." }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
错误码
请参见错误码。
