全部产品
Search

搜索本产品

    云安全中心：DescribeOnceTaskLeafRecordPage - 获取一次性任务的子任务信息

    文档中心

    云安全中心：DescribeOnceTaskLeafRecordPage - 获取一次性任务的子任务信息

    更新时间：Nov 25, 2024

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

    调试

    您可以在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 返回结构发生变更查看变更详情