ListUnfinishedOnceTask - 查询未完成的任务列表 - 云安全中心

提供根据任务类型，查询未完成的任务列表。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:ListUnfinishedOnceTask

list

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
TaskType	string	是	任务类型。取值： ASSETS_COLLECTION：资产采集任务 IMAGE_SCAN：镜像扫描任务	IMAGE_SCAN
Target	string	否	目标对象值。可选参数：当任务类型IMAGE_SCAN时，目标对象值为镜像的 Digest。当任务类型为ASSETS_COLLECTION时，目标对象值为机器的 Uuid*。	4fe8e1cd-3c37-4851-b9de-124da32c****

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	F5CF78A7-30AA-59DB-847F-13EE3AE7****
OnceTasks	array<object>	任务详情列表。
	array<object>	任务详情列表。
Status	integer	状态。	1
StatusText	string	任务运行的状态。取值： INIT：待启动 START：已启动 SUCCESS：已完成 TIMEOUT：已超时	SUCCESS
Progress	integer	导出进度百分比（%）。	75
RealRunTime	integer	任务执行时间。	1670307567000
TaskName	string	任务名称。	IMAGE_SCAN
Finish	integer	任务是否完成。 0：未完成 1：已完成	1
TotalCount	integer	总数，分页查询时生效。	30
EndTime	integer	结束时间。	1670307567000
TaskType	string	任务类型。	IMAGE_SCAN
StartTime	integer	开始执行时间。	1640102400000
ResultInfo	string	执行结果。	TASK_NOT_SUPPORT_REGION
Target	string	任务目标。	238cf050a7270dd6940602e70f1e5a11eeaf4e02035f445b7f613ff5e064****
TaskId	string	任务 ID。	9fb50f2af8bb67c9fdb684194c83****
FinishCount	integer	已完成的记录数。	67
TargetType	string	扫描对象类型。 IMAGE_REPO：镜像仓库。 IMAGE：镜像。	IMAGE
TaskImageInfo	object	镜像扫描相关的信息。
RepoId	string	镜像仓库 ID。	crr-r88w2vryp8m****
Digest	string	镜像 digest。	default_digest
Tag	string	镜像标签。	v1.20-002-a2*****
RepoRegionId	string	镜像仓库的地域 ID。	cn-hangzhou
RepoName	string	镜像仓库名称。	testyyy
RepoNamespace	string	镜像命名空间。	bitn***
RegionId	string	服务器镜像所在的地域。	cn-hangzhou
Image	string	容器镜像。	*s.com/sas_test/baseli*
Pod	string	镜像 pod 信息。	expoit-law-****
AppName	string	应用名称。	ack-jenkins-****
NodeName	string	节点的名称。	pztest****
NodeIp	string	节点 IP 地址。	172.18.XXX.XXX
NodeInstanceId	string	节点实例 ID。	i-0xi5mxvtmfw9****
ClusterId	string	集群的 ID。	a765ba1435e7f9446065370e9a41****
ClusterName	string	查询服务下某个集群的实例列表时所需要的参数。	ACK-test-****

示例

正常返回示例

JSON格式

{
  "RequestId": "F5CF78A7-30AA-59DB-847F-13EE3AE7****",
  "OnceTasks": [
    {
      "Status": 1,
      "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": "default_digest",
        "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-****"
      }
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
500	ServerError	ServerError
403	NoPermission	caller has no permission

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

变更历史

更多信息，参考变更详情。