备案控制台
文档
产品文档
输入文档关键字查找
首页 云安全中心 开发参考 API参考指南 API目录 任务管理 DescribeOnceTaskLeafRecordPage - 获取一次性任务的子任务信息

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

更新时间：
一键部署
产品详情
相关技术圈
我的收藏

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

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
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
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 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更。
  • 本页导读 （1）
文档反馈