DescribeIdcProbeScanResultList - 查询IDC资产探针扫描结果列表 - 云安全中心

获取通过IDC资产探针发现的资产列表。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
PageSize	integer	否	指定分页查询时，每页显示的数据最大条数。每页默认显示的数据条数为 20 条，PageSize 参数值为空时，将默认返回 20 条数据。说明建议 PageSize 取值不要为空。	20
CurrentPage	integer	否	分页查询时，当前页的页码。	1
Criteria	string	否	设置搜索资产的条件。该参数 JSON 格式，输入参数时注意大小写。说明支持使用资产的实例 ID、实例名称、所属 VPC ID、地域、公网 IP 地址等条件搜索资产。	[{\"name\":\"scannedIp\",\"value\":\"192.168.2.11\"}]
LogicalExp	string	否	设置多个搜索条件间生效的逻辑关系。取值： OR：表示多个搜索条件之间是或的关系。 AND：表示多个搜索条件之间是与的关系。	OR
Status	string	否	对应探针的状态列表，多个逗号分隔。取值： 0：有效 1：已忽略 2：无效 3：过期 *4：探针不存在	0,1
FoundStartTime	long	否	扫描发现的起始时间。	1720006818000
FoundEndTime	long	否	扫描发现的结束时间。	1720006819000

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	A3D7C47D-3F11-57BB-90E8-E5C20C61****
PageInfo	object	分页信息。
CurrentPage	integer	分页查询时，当前页的页码。	1
PageSize	integer	分页大小。	20
TotalCount	integer	总条数。	69
Count	integer	当前页显示的数据条数。	9
Instances	array<object>	实例列表。
Instance	object	实例列表。
ValidPort	string	扫描端口。	22
ProbeIntranetIp	string	关联机器实例的私网 IP。	192.168..
Os	string	资产系统类型。取值： windows linux	Linux
ClientStatus	string	探针实例的客户端在线状态。取值： online：在线，表示资产的 Agent 客户端状态为开启。 offline：离线，表示资产的 Agent 客户端状态为关闭。	online
ProbeInternetIp	string	关联机器实例的公网 IP。	42.121..
LastScanTime	long	最新扫描的时间戳，单位：毫秒。	1720006818000
IpSegment	string	IP 段列表。	192.168.2.0/24
ProbeMachineName	string	关联机器实例的名称。	i-xxxx
ScannedIp	string	扫描到的 IP。	192.168..
ProbeUuid	string	关联机器实例的 UUID。	11C96623-E106-59C9-866D-A6C82911****
IdcName	string	IDC 机房名称。	3K机房广州
ScanResultId	long	扫描结果 ID。	1231

示例

正常返回示例

JSON格式

{
  "RequestId": "A3D7C47D-3F11-57BB-90E8-E5C20C61****",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 69,
    "Count": 9
  },
  "Instances": [
    {
      "ValidPort": "22",
      "ProbeIntranetIp": "192.168.*.*",
      "Os": "Linux",
      "ClientStatus": "online",
      "ProbeInternetIp": "42.121.*.*",
      "LastScanTime": 1720006818000,
      "IpSegment": "192.168.2.0/24",
      "ProbeMachineName": "i-xxxx",
      "ScannedIp": "192.168.*.*",
      "ProbeUuid": "11C96623-E106-59C9-866D-A6C82911****\n",
      "IdcName": "3K机房广州",
      "ScanResultId": 1231
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	ServerError	ServerError	服务故障，请稍后重试！

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