调用DescribeScanSessions获取扫描任务实例列表。

说明 调用该接口可以分页查询扫描任务调度产生的任务实例列表信息。

调试

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

请求参数

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

要执行的操作。取值：DescribeScanSessions。

SourceIp String 否 1.2.3.4

指定访问源IP地址。
ScanId String 否 66c07fa5-542b-47df-8501-e0401dc42d3e

指定查询特定扫描任务ID的实例列表。
CurrentPage Integer 否 3

指定返回结果的当前页码。
PageSize Integer 否 20

指定返回结果的每页显示数据条数。
Search String 否 1.2.*.*

指定待查询实例的任务搜索字段。
StatusList.N RepeatList 否 waiting

指定待查询实例中子任务状态。取值：

  • waiting：等待中
  • finished：已完成
  • running：运行中
  • aborted：暂停

返回数据

名称 类型 示例值 描述
Count Integer 20

指定当前页显示数据条数。
CurrentPage Integer 5

指定返回结果的当前页码。
List Array

返回的任务实例列表。
CreatedAt Long 1565690460000

扫描创建时间。
FinishedAt Long 1565690260000

扫描结束时间。
Interval Integer 1

返回结果中任务的扫描间隔时间。
JobStatus String waiting

返回结果中子任务扫描状态。取值：

  • waiting：等待中
  • finished：已完成
  • running：运行中
  • aborted：已暂停
Name String test

返回结果中任务名称。
Period String hour

返回结果中各任务的扫描周期。取值：

  • minute：每分钟
  • hour：每小时
  • day：每天
  • week：每周
  • month：每月
ReportStatus String running

返回结果中各任务实例生成报表状态。取值：

  • failed：生成失败
  • finished：生成完成
  • running：生成中
  • inexistent：不存在
ReportUrl String http://***.com

返回结果中各任务实例生成的报告链接。
RunPercent Float 10.21

返回结果中各任务实例的扫描进度。
ScanId String c0065a11-fe41-44f4-a5d2-b921316ddb52

返回结果中各扫描任务的子任务ID。
Targets List ["1.2.3.5"]

返回结果中各任务实例下扫描目标（IP/域名/子域名）。
TaskId Long 1236984

返回结果中各任务实例的ID。
TriggerType String date

返回结果中各扫描任务下子任务的任务触发类型。取值：

  • date：单次任务
  • interval ：周期任务
PageCount Integer 20

返回任务实例列表总页数。
PageSize Integer 20

返回任务实例列表中每页显示数据总条数。
RequestId String F8955687-DDFC-4FE1-BC67-5C613657B8E5

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

返回任务实例列表的实例总数量。

示例

请求示例

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

正常返回示例

XML 格式 

<DescribeScanSessionsResponse>
      <code>200</code>
	  <requestId>F8955687-DDFC-4FE1-BC67-5C613657B8E5</requestId>
	  <success>true</success>
	  <data>
		    <List>
			      <TaskId>11</TaskId>
			      <ScanId>11111</ScanId>
			      <JobStatus>waiting</JobStatus>
			      <CreatedAt>111212121</CreatedAt>
			      <FinishedAt>12121</FinishedAt>
			      <name>test</name>
			      <targets>1.2.3.5</targets>
			      <triggerType>date</triggerType>
			      <period>hour</period>
			      <interval>1</interval>
			      <reportStatus>running</reportStatus>
			      <reportUrl>http://***.com</reportUrl>
		    </List>
		    <PageNumber>1</PageNumber>
		    <PageSize>20</PageSize>
		    <TotalCount>100</TotalCount>
	  </data>
</DescribeScanSessionsResponse>

JSON 格式 

{
    "code": "200",
    "requestId": "F8955687-DDFC-4FE1-BC67-5C613657B8E5",
    "success": true,
    "data": {
        "List": [
            {
                "TaskId": 11,
                "ScanId": 11111,
                "JobStatus": "waiting",
                "CreatedAt": 111212121,
                "FinishedAt": 12121,
                "name": "test",
                "targets": ["1.2.3.5"],
                "triggerType": "date",
                "period": "hour",
                "interval": 1,
                "reportStatus": "running",
                "reportUrl": "http://***.com"
            }
        ],
        "PageNumber": 1,
        "PageSize": 20,
        "TotalCount": 100
    }
}

错误码

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