# 批量创建主机资产
#### 功能介绍
批量创建租户的主机资产
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CodeArtsInspector/doc?api=BatchCreateHosts)中调试该接口，支持自动认证鉴权。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** |
   
 表4HostItem 
| 参数                | 是否必选 | 参数类型   | 描述                                                       |
|:---|:---|:---|:---|
| 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** |
   
 表6HostItemWithId 
| 参数                | 参数类型   | 描述                                                       |
|:---|:---|:---|
| 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 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-vss/ErrorCode.html)。