更新时间：2024-05-16 GMT+08:00
获取主机组列表
功能介绍
获取主机组列表
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v3/{project_id}/hostscan/groups
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
project_id 最小长度：32 最大长度：32 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
offset |
否 |
Integer |
分页查询，偏移量，表示从此偏移量开始查询 最小值：0 最大值：200 缺省值：0 |
limit |
否 |
Integer |
分页查询，每页显示的条目数量 最小值：1 最大值：100 缺省值：5 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
X-Auth-Token 最小长度：1 最大长度：102400 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
total |
Integer |
群组总数 最小值：0 最大值：1000 |
items |
Array of Group objects |
群组列表 数组长度：0 - 1000 |
状态码： 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 |
请求示例
无
响应示例
状态码： 200
OK
{
"total" : 1,
"items" : [ {
"name" : "myGroup1",
"id" : "9a1cd36501a94a739db18a53ba07e35a"
} ]
}
状态码
状态码 |
描述 |
|---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
418 |
I'm a teapot |
错误码
请参见错误码。
父主题： 主机组管理
