DescribeOnceTaskLeafRecordPage - 获取一次性任务的子任务信息

获取一次性扫描任务结果的子任务的详情,包括镜像扫描及镜像资产同步。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
yundun-sas:DescribeOnceTaskLeafRecordPageget
*全部资源
*

请求参数

名称类型必填描述示例值
PageSizeinteger

指定分页查询时,每页显示的数据最大条数。每页默认显示的数据条数为 20 条。

20
CurrentPageinteger

分页查询,当前显示的页数。

1
TaskTypestring

任务类型。取值:

  • IMAGE_SCAN:镜像扫描
  • IMAGE_REGISTRY_PULL:镜像资产同步
CLIENT_PROBLEM_CHECK
RelateInfoboolean

是否关联扩展信息。

true
TaskIdstring

指定要获取的任务 ID。

1471d8ebb96795b41ede090b9758****
Sourcestring

请求来源。

console_batch
StartTimelong

开始时间的时间戳。

1648438617000
EndTimelong

结束时间的时间戳。

1668064495000
StatusListarray

状态列表。

string

任务运行的状态。取值:

  • INIT:待启动
  • START:已启动
  • SUCCESS:已完成
  • TIMEOUT:已超时
INIT

返回参数

名称类型描述示例值
object
RequestIdstring

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

A4EB8B1C-1DEC-5E18-BCD0-D1BBB393****
PageInfoobject

分页信息。

CurrentPageinteger

分页查询时,当前页的页码。

1
PageSizeinteger

分页查询时,每页最多显示的数据条数。

20
TotalCountinteger

查询结果的总记录数。

16
Countinteger

分页查询时,当前页显示的记录数。

6
OnceTasksarray<object>

任务详情列表。

OnceTasksobject

任务详情列表。

Statusstring

状态。

0
StatusTextstring

任务运行的状态。取值:

  • INIT:待启动
  • START:已启动
  • SUCCESS:已完成
  • TIMEOUT:已超时
SUCCESS
Progresslong

导出进度百分比(%)。

75
RealRunTimelong

任务执行时间。

1670307567000
TaskNamestring

任务名称。

IMAGE_SCAN
Finishinteger

任务是否完成。

  • 0:未完成
  • 1:已完成
1
TotalCountstring

总数,分页查询时生效。

30
EndTimelong

结束时间。

1670307567000
TaskTypestring

任务类型。

IMAGE_SCAN
StartTimelong

开始执行时间。

1640102400000
ResultInfostring

执行结果。

TASK_NOT_SUPPORT_REGION
Targetstring

任务目标。

238cf050a7270dd6940602e70f1e5a11eeaf4e02035f445b7f613ff5e064****
TaskIdstring

任务 ID。

9fb50f2af8bb67c9fdb684194c83****
FinishCountstring

已完成的记录数。

67
TargetTypestring

扫描对象类型。

  • IMAGE_REPO:镜像仓库。
  • IMAGE:镜像。
IMAGE
TaskImageInfoobject

镜像扫描相关的信息。

RepoIdstring

镜像仓库 ID。

crr-r88w2vryp8m****
Digeststring

镜像 digest

9e0dc29d872d2e386cc5c0c92b529a84e3acfade16f5cb1d054a2ee3c99****
Tagstring

镜像标签。

v1.20-002-a2*****
RepoRegionIdstring

镜像仓库的地域 ID。

cn-hangzhou
RepoNamestring

镜像仓库名称。

testyyy
RepoNamespacestring

镜像命名空间。

bitn***
RegionIdstring

服务器镜像所在的地域。

cn-hangzhou
Imagestring

容器镜像。

***s.com/sas_test/baseli***
Podstring

镜像 pod 信息。

expoit-law-****
AppNamestring

应用名称。

ack-jenkins-****
NodeNamestring

节点的名称。

pztest****
NodeIpstring

节点 IP 地址。

172.18.XXX.XXX
NodeInstanceIdstring

节点实例 ID。

i-0xi5mxvtmfw9****
ClusterIdstring

集群的 ID。

a765ba1435e7f9446065370e9a41****
ClusterNamestring

集群名称。

ACK-test-****
CostTimeInfostring

耗时统计,JSON 格式,展示各项的结束时间。

  • vul:系统漏洞。
  • scaVul:应用漏洞。
  • baseline:基线。
  • binary:二进制。
  • forbiddenPackageInfo:禁止安装。
  • identificationInfo:身份鉴别。
  • script:恶意脚本。
  • sensitiveFile:敏感文件。
  • sensitiveInfo:AK 检测。
  • webshell:网站脚本。
{"scaVul":"2023-09-04 09:37:21","identificationInfo":"2023-09-04 09:37:30","forbiddenPackageInfo":"2023-09-04 09:37:16","binary":"2023-09-04 09:37:25","baseline":"2023-09-04 09:37:19","sensitiveFile":"2023-09-04 09:38:34","vul":"2023-09-04 09:37:31","webshell":"2023-09-04 09:38:27","sensitiveInfo":"2023-09-04 09:37:16","script":"2023-09-04 09:39:44"}

示例

正常返回示例

JSON格式

{
  "RequestId": "A4EB8B1C-1DEC-5E18-BCD0-D1BBB393****",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 16,
    "Count": 6
  },
  "OnceTasks": [
    {
      "Status": "0",
      "StatusText": "SUCCESS",
      "Progress": 75,
      "RealRunTime": 1670307567000,
      "TaskName": "IMAGE_SCAN",
      "Finish": 1,
      "TotalCount": "30",
      "EndTime": 1670307567000,
      "TaskType": "IMAGE_SCAN",
      "StartTime": 1640102400000,
      "ResultInfo": "TASK_NOT_SUPPORT_REGION",
      "Target": "238cf050a7270dd6940602e70f1e5a11eeaf4e02035f445b7f613ff5e064****",
      "TaskId": "9fb50f2af8bb67c9fdb684194c83****",
      "FinishCount": "67",
      "TargetType": "IMAGE",
      "TaskImageInfo": {
        "RepoId": "crr-r88w2vryp8m****",
        "Digest": "9e0dc29d872d2e386cc5c0c92b529a84e3acfade16f5cb1d054a2ee3c99****",
        "Tag": "v1.20-002-a2*****",
        "RepoRegionId": "cn-hangzhou",
        "RepoName": "testyyy",
        "RepoNamespace": "bitn***",
        "RegionId": "cn-hangzhou",
        "Image": "***s.com/sas_test/baseli***",
        "Pod": "expoit-law-****",
        "AppName": "ack-jenkins-****",
        "NodeName": "pztest****",
        "NodeIp": "172.18.XXX.XXX",
        "NodeInstanceId": "i-0xi5mxvtmfw9****",
        "ClusterId": "a765ba1435e7f9446065370e9a41****",
        "ClusterName": "ACK-test-****",
        "CostTimeInfo": "{\"scaVul\":\"2023-09-04 09:37:21\",\"identificationInfo\":\"2023-09-04 09:37:30\",\"forbiddenPackageInfo\":\"2023-09-04 09:37:16\",\"binary\":\"2023-09-04 09:37:25\",\"baseline\":\"2023-09-04 09:37:19\",\"sensitiveFile\":\"2023-09-04 09:38:34\",\"vul\":\"2023-09-04 09:37:31\",\"webshell\":\"2023-09-04 09:38:27\",\"sensitiveInfo\":\"2023-09-04 09:37:16\",\"script\":\"2023-09-04 09:39:44\"}"
      }
    }
  ]
}

错误码

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

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

变更历史

变更时间变更内容概要操作
2023-09-07OpenAPI 返回结构发生变更查看变更详情