Additional considerations

Contributors netapp-ranuk Download PDF of this page

There are several additional characteristics of the Cloud Manager REST API affecting its operation and use. You should be aware of these considerations before issuing an API call.

Public identifiers

All Cloud Manager resources (for example, working environments) are assigned a public ID. Whenever a resource is created or returned, the public ID is displayed in the response. You must specify a resource’s public ID when performing operations on the resource. For example, you must specify the public ID for a working environment when you create a volume.

Asynchronous processing

All HTTP request methods except GET are processed asynchronously. If needed, you can check the status of an active task based on the request id returned in the original HTTP response. Each task has a status value as shown in the following table.

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.

For more information about how to retrieve the status of a background task for an asynchronous request see Get active task.