批量创建主机资产

功能介绍

批量创建租户的主机资产

调试

您可以在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

{
  "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" : ""
  } ]
}