更新时间:2021-09-29 GMT+08:00
分享

删除主机

功能介绍

根据主机id删除主机。

调试

您可以在API Explorer中调试该接口。

URI

DELETE /v2/host-groups/{group_id}/hosts/{host_id}

表1 路径参数

参数

是否必选

参数类型

描述

group_id

String

主机组id

host_id

String

主机id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json

缺省值:application/json;charset=utf-8

枚举值:

  • application/json;charset=utf-8

  • application/json

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

最小长度:0

最大长度:20000

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

host_id

String

主机id

状态码: 400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度:8

最大长度:36

error_msg

String

错误描述

最小长度:2

最大长度:512

状态码: 401

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度:8

最大长度:36

error_msg

String

错误描述

最小长度:2

最大长度:512

状态码: 403

表6 响应Body参数

参数

参数类型

描述

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

错误码

请参见错误码

分享:

    相关文档

    相关产品

close