九游平台/ 漏洞管理服务 codearts inspector/ api参考/ / / 批量创建主机资产
更新时间：2024-10-14 gmt 08:00

批量创建主机资产-九游平台

功能介绍

批量创建租户的主机资产

调试

您可以在中调试该接口，支持自动认证鉴权。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

错误码

请参见错误码。

父主题：

相关文档

网站地图