Using the Cloud Service API

Use the Cloud Service API to integrate directly with Cloud Service for management activities such as cluster provisioning, deprovisioning, and scaling.

The API reference documentation is available from the Console. To access the documentation directly, go to API docs.

Prerequisite

Before calling API, create an access key. For more information, see Access key.

Call the API

To call the Cloud Service API, your application must pass the retrieved access key as a bearer token in the x-access-key header of your HTTP request. For example:

curl --request GET \
  --url "https://portal.biganimal.com/api/v3/projects" \
  --header "x-access-key: $ACCESS_KEY"

Where the ACCESS_KEY variable is the access key's text copied from the BigAnimal UI.

Example response:

{
    "projectId": "prj_abcd1234",
    "projectName": "Test project",
    "clusterCount": 4,
    "userCount": 10,
    "cloudProviders": [
    {
       "cloudProviderId": "aws",
       "cloudProviderName": "AWS"
    },
    {
       "cloudProviderId": "azure",
       "cloudProviderName": "Azure"
    }
  ]
}