调用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
    }
}

错误码

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