调用ListUserHosts获取主机列表信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListUserHosts

需要执行的操作。取值：ListUserHosts。

Search String 否 ip:1.1.1.1

需要查询的主机。
CurrentPage Integer 否 1

返回结果的当前页码。

默认值为1。
PageSize Integer 否 10

返回结果列表每页显示数据条数。

默认值为10，可设置的最大值为10。

返回数据

名称 类型 示例值 描述
CurrentPage Integer 1

返回结果的当前页码。
PageSize Integer 10

返回结果列表每页显示数据条数。
Records Array

查询返回的主机信息列表。
Hostname String guest

查询返回的主机信息列表中的主机名。
IP String 192.168.1.1

查询返回的主机信息列表中的IP地址。
Id Integer 1

主机信息列表中的漏洞扫描为该主机分配的ID号。
Index Integer 1

查询返回的主机列表中每条记录的索引号。
OS String windows

查询返回的域名信息列表中主机的操作系统。
State String up

查询返回的域名信息列表中主机的状态。取值：

  • up：表示主机在线。
  • down：表示主机离线。
UpdatedAt Long 1581348080000

主机查询列表更新时间。
RequestId String 7DC8391E-D5D8-4E00-A457-1F861F86E78A

返回结果的请求ID。
TotalCount Integer 269

返回结果总数。

示例

请求示例

http(s)://[Endpoint]/?Action=ListUserHosts
&<公共请求参数>

正常返回示例

XML 格式 

<ListUserHostsResponse>
  <TotalCount>1</TotalCount>
  <PageSize>10</PageSize>
  <RequestId>4A1AA1D7-F806-475B-8B9B-B9B0B889EA9F</RequestId>
  <CurrentPage>1</CurrentPage>
  <Records>
        <OS>Linux 3.10 - 4.11</OS>
        <State>up</State>
        <IP>1.1.1.1</IP>
        <Hostname></Hostname>
        <Index>1</Index>
        <Id>4741</Id>
        <UpdatedAt>1582625412000</UpdatedAt>
  </Records>
</ListUserHostsResponse>

JSON 格式 

{
	"TotalCount": 1,
	"PageSize": 10,
	"RequestId": "4A1AA1D7-F806-475B-8B9B-B9B0B889EA9F",
	"CurrentPage": 1,
	"Records": [
		{
			"OS": "Linux 3.10 - 4.11",
			"State": "up",
			"IP": "1.1.1.1",
			"Hostname": "",
			"Index": 1,
			"Id": 4741,
			"UpdatedAt": 1582625412000
		}
	]
}

错误码

访问错误中心查看更多错误码。