Cloudistics Web Services API
Cloudistics Web Services (CWS) provides API access to the Cloudistics on-premises cloud platform. Specifically, the API provides access to virtual datacenter and infrastructure resources. You can use the API, for example, to create resizable resources, manage workloads, and retrieve information about the underlying infrastructure. Refer to the following topics.
Navigate to the CWS Site
First, you need to authorize your API token.
You can obtain a token for your account in the Cloudistics Ignite management portal under Developer Options. See this topic for instructions: Manage Developer Options.
- Once you have your token, click the Authorize button on the main page.(It will show an unlocked icon, meaning there are no authorizations provided yet.)
- In the Available Authorizations dialog box, add your token in the following format,
Bearer my_token, where
my_tokenis your API token, and then click Authorize.
After you click Authorize you should see the Available Authorizations dialog box.
On the main API documentation page, you should see that the authorization is added as noted with a locked icon. Since the authorization has been provided, you can now successfully make API requests.
Once you have an API token, you can make an API request via a selected endpoint as follows.
- Select a specific endpoint, and then click Try it out.
When you click Try it out, an "Execute" button will appear between the Parameters and Responses sections.
- Set the available parameters as you like, and then click Execute to make the API request.
Upon submitting the API request, an example Curl request appears, which represents the API request, as well as the server response. The response includes the status code, response body and response headers.
An example is provided below to help guide you in learning to use the CWS API.
Example Scenario: Using the Applications Get API, search for an application with a specific name and only include the UUID in the response.
- Input filter criteria and data to include in the response.
The screenshot below shows inputting the UUID with the application name, "Cloudistics Migration Manager," in the filters input box.
- Execute the query.
The screenshot below shows the query being executed based on the user input (in the Curl section). Notice that the UUID is returned in the response body.