Get active task

Contributors netapp-ranuk Download PDF of this page

All of the requests made to the Cloud Manager REST API are processed asynchronously except those using the HTTP GET method. Each of these asynchronous requests is assigned a unique identifier which is returned to the caller in the response. You can use the request ID to retrieve information about the background task including its status.

1. Get the request identifier

After issuing any REST API call, the associated request identifier is returned in the X-Response_Id header. You must extract this value and use it in the path variable in the next step.

2. Get the task

HTTP method Resource path

GET

/occm/api/audit/activeTask/{request_id}

curl example
curl --location --request GET 'https://cloudmanager.cloud.netapp.com/occm/api/audit/activeTask/<REQUEST_ID>' --header 'Content-Type: application/json' --header 'x-agent-id: <AGENT_ID>' --header 'Authorization: Bearer <ACCESS_TOKEN>'
Input parameters

Path parameter that contains the request identifier <REQUEST_ID> for the original task.

Output

The JSON output example includes the list of returned values. The status contains one of three values indicating the status of the task.

Status Description

1

The asynchronous task completed successfully.

0

The background task is still running and has not completed.

-1

The asynchronous task completed but failed.

JSON output example
{
    "status": 0,
    "closeTime": -2147483648,
    "actionName": "Create Vsa Working Environment",
    "error": null
}