调用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 |
指定待查询实例中子任务状态。取值:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Count | Integer | 20 |
指定当前页显示数据条数。 |
CurrentPage | Integer | 5 |
指定返回结果的当前页码。 |
List | Array |
返回的任务实例列表。 |
|
CreatedAt | Long | 1565690460000 |
扫描创建时间。 |
FinishedAt | Long | 1565690260000 |
扫描结束时间。 |
Interval | Integer | 1 |
返回结果中任务的扫描间隔时间。 |
JobStatus | String | waiting |
返回结果中子任务扫描状态。取值:
|
Name | String | test |
返回结果中任务名称。 |
Period | String | hour |
返回结果中各任务的扫描周期。取值:
|
ReportStatus | String | running |
返回结果中各任务实例生成报表状态。取值:
|
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 |
返回结果中各扫描任务下子任务的任务触发类型。取值:
|
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
}
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交