批量创建主机组
功能介绍
批量创建主机组
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v3/{project_id}/hostscan/groups
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | project_id 最小长度:32 最大长度:32 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | X-Auth-Token 最小长度:1 最大长度:102400 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 否 | String | 群组名称 最小长度:1 最大长度:24 |
响应参数
状态码: 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 群组ID 最小长度:1 最大长度:64 |
| name | String | 群组名称 最小长度:1 最大长度:24 |
状态码: 400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 最小长度:0 最大长度:50 |
| error_msg | String | 错误描述 最小长度:0 最大长度:256 |
状态码: 401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 最小长度:0 最大长度:50 |
| error_msg | String | 错误描述 最小长度:0 最大长度:256 |
状态码: 418
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 最小长度:0 最大长度:50 |
| error_msg | String | 错误描述 最小长度:0 最大长度:256 |
请求示例
{
"name" : "myGroup1"
} 响应示例
状态码: 200
OK
{
"id" : "6704f2e83cac4a618046051802e856af",
"name" : "myGroup1"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 418 | I'm a teapot |
错误码
请参见错误码。