文档首页/ 漏洞管理服务 CodeArts Inspector/ API参考/ API/ 主机管理/ 批量创建主机资产
更新时间：2024-10-14 GMT+08:00
查看PDF
分享

批量创建主机资产

功能介绍

批量创建租户的主机资产

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v3/{project_id}/hostscan/hosts

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

用户的project_id

最小长度：32

最大长度：32

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

最小长度：1

最大长度：102400
表3 请求Body参数

参数

是否必选

参数类型

描述

hosts

是

Array of HostItem objects

主机资产列表

数组长度：1 - 100
表4 HostItem

参数

是否必选

参数类型

描述

ip

是

String

主机IP

最小长度：7

最大长度：15

name

是

String

主机名称

最小长度：1

最大长度：64

os_type

是

String

操作系统类型:

  • linux

  • windows

枚举值：

  • linux

  • windows

group_id

否

String

主机组id

最小长度：1

最大长度：64

ssh_credential_id

否

String

linux主机ssh授权登录信息ID

最小长度：1

最大长度：64

jumper_server_id

否

String

linux跳板机信息ID

最小长度：1

最大长度：64

smb_credential_id

否

String

windows主机smb授权登录信息ID

最小长度：1

最大长度：64

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

items

Array of HostItemWithId objects

创建的主机列表

数组长度：1 - 100

total

Integer

主机总数

最小值：0

最大值：100
表6 HostItemWithId

参数

参数类型

描述

ip

String

主机IP

最小长度：7

最大长度：15

name

String

主机名称

最小长度：1

最大长度：64

os_type

String

操作系统类型:

  • linux

  • windows

枚举值：

  • linux

  • windows

group_id

String

主机组id

最小长度：1

最大长度：64

ssh_credential_id

String

linux主机ssh授权登录信息ID

最小长度：1

最大长度：64

jumper_server_id

String

linux跳板机信息ID

最小长度：1

最大长度：64

smb_credential_id

String

windows主机smb授权登录信息ID

最小长度：1

最大长度：64

id

String

主机ID

最小长度：1

最大长度：64

状态码： 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：0

最大长度：50

error_msg

String

错误描述

最小长度：0

最大长度：256

状态码： 401

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：0

最大长度：50

error_msg

String

错误描述

最小长度：0

最大长度：256

状态码： 418

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：0

最大长度：50

error_msg

String

错误描述

最小长度：0

最大长度：256

请求示例

POST https://{endpoint}/v3/{project_id}/hostscan/hosts

{
  "hosts" : [ {
    "ip" : "10.90.2.190",
    "name" : "密钥test190",
    "os_type" : "linux",
    "group_id" : "c322c9acecb244cebf2c5449ba8a1930",
    "ssh_credential_id" : "c8a7b0e4707749dfaaf8764ea827a764",
    "jumper_server_id" : "b22f51d539994e76a325d388e51b9783",
    "smb_credential_id" : ""
  } ]
}

响应示例

状态码： 200

OK

{
  "items" : [ {
    "id" : "6704f2e83cac4a618046051802e856af",
    "ip" : "10.90.2.190",
    "name" : "密钥test190",
    "os_type" : "linux",
    "group_id" : "63503a5a20cb440fba17b4d14a13e666",
    "ssh_credential_id" : "63503a5a20cb440fba17b4d14a13e203",
    "jumper_server_id" : "b22f51d539994e76a325d388e51b9783",
    "smb_credential_id" : ""
  } ]
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

418

I'm a teapot

错误码

请参见错误码。

父主题： 主机管理

相关文档