Query unfinished tasks by task type with ListUnfinishedOnceTask - Security Center - Alibaba Cloud - Security Center

Queries the list of incomplete tasks by task type.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

yundun-sas:ListUnfinishedOnceTask

list

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
TaskType	string	Yes	The task type. Valid values: ASSETS_COLLECTION: asset information collection task IMAGE_SCAN: image scan task.	IMAGE_SCAN
Target	string	No	The target object value. Valid values: If the task type is IMAGE_SCAN, the target object value is the Digest of the image. If the task type is ASSETS_COLLECTION, the target object value is the Uuid of the server.	4fe8e1cd-3c37-4851-b9de-124da32c****

Response elements

Element	Type	Description	Example
	object
RequestId	string	The request ID, which is a unique identifier generated by Alibaba Cloud for the request. You can use this ID to troubleshoot issues.	F5CF78A7-30AA-59DB-847F-13EE3AE7****
OnceTasks	array<object>	The task details.
	array<object>	The task details.
Status	integer	The status.	1
StatusText	string	The running status of the task. Valid values: INIT: pending START: started SUCCESS: completed TIMEOUT: timed out.	SUCCESS
Progress	integer	The export progress percentage (%).	75
RealRunTime	integer	The task execution time.	1670307567000
TaskName	string	The task name.	IMAGE_SCAN
Finish	integer	Indicates whether the task is completed. Valid values: 0: not completed 1: completed.	1
TotalCount	integer	The total number of entries. This parameter takes effect for paged query and paging.	30
EndTime	integer	The end time.	1670307567000
TaskType	string	The task type.	IMAGE_SCAN
StartTime	integer	The start time of the task execution.	1640102400000
ResultInfo	string	The execution result.	TASK_NOT_SUPPORT_REGION
Target	string	The task target.	238cf050a7270dd6940602e70f1e5a11eeaf4e02035f445b7f613ff5e064****
TaskId	string	The task ID.	9fb50f2af8bb67c9fdb684194c83****
FinishCount	integer	The number of completed records.	67
TargetType	string	The scan object type. Valid values: IMAGE_REPO: image repository. IMAGE: image.	IMAGE
TaskImageInfo	object	The image scan information.
RepoId	string	The ID of the image repository.	crr-r88w2vryp8m****
Digest	string	The image digest.	default_digest
Tag	string	The image tag.	v1.20-002-a2*****
RepoRegionId	string	The region ID of the image repository.	cn-hangzhou
RepoName	string	The name of the image repository.	testyyy
RepoNamespace	string	The namespace to which the image repository belongs.	bitn***
RegionId	string	The region ID of the server image.	cn-hangzhou
Image	string	The container image.	*s.com/sas_test/baseli*
Pod	string	The pod of the image.	expoit-law-****
AppName	string	The name of the application.	ack-jenkins-****
NodeName	string	The name of the node.	pztest****
NodeIp	string	The IP address of the node.	172.18.XXX.XXX
NodeInstanceId	string	The instance ID of the node.	i-0xi5mxvtmfw9****
ClusterId	string	The ID of the cluster.	a765ba1435e7f9446065370e9a41****
ClusterName	string	The name of the cluster.	ACK-test-****

Examples

Success response

JSON format

{
  "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-****"
      }
    }
  ]
}

Error codes

HTTP status code	Error code	Error message	Description
500	ServerError	ServerError
403	NoPermission	caller has no permission

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.