Use GetCheckProcess to query configuration check task progress - Security Center - Alibaba Cloud - Security Center

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

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
TaskId	string	No	The ID of the cloud service configuration check task that you want to query. Note You can call the SubmitCheck operation to obtain this parameter.	5347c7b6-c85c-4070-846a-3029e08e****
ResourceDirectoryAccountId	integer	No	The ID of the member accounts in the resource folder (Alibaba Cloud account). Note You can invoke the DescribeMonitorAccounts operation to obtain this parameter.	1232428423234****

Response elements

Element	Type	Description	Example
	object	The response parameters.
TotalCount	integer	The total number of assets to be checked.	113
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.	D18B5DAD-BA97-5552-AE48-83F59D5F****
FinishCount	integer	The total number of assets that have been checked.	80
StatusCode	string	The status code of the CSPM check task. Valid values: 0: The task is being initialized and the total number of tasks is being calculated. 1: The task is running. You can query the total number of tasks and the number of completed tasks. 2: The task is completed. 3: The task timed out. 4: The task is invalid. Check whether valid assets exist for the check. 5: No task record exists. Check whether the TaskId is correct. 6: The task is running and data is being prepared. You cannot query the total number of tasks or the number of completed tasks.	1
TaskId	string	The ID of the cloud service configuration check task.	5347c7b6-c85c-4070-846a-3029e08e****

Examples

Success response

JSON format

{
  "TotalCount": 113,
  "RequestId": "D18B5DAD-BA97-5552-AE48-83F59D5F****",
  "FinishCount": 80,
  "StatusCode": "1",
  "TaskId": "5347c7b6-c85c-4070-846a-3029e08e****\n"
}

Error codes

HTTP status code	Error code	Error message
400	RdCheckNoPermission	Resource directory account verification has no permission.
500	ServerError	ServerError
500	RdCheckInnerError	Resource directory account service internal error.
403	NoPermission	caller has no permission

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.