Cloud Accounts
Contents
Cloud Accounts
A cloud account stores the credentials needed to use a cloud provider services. A cloud account allows the platform to commission and manage servers and VPCs on behalf of a customer's users.
List cloud accounts
GET /v2/admin/customers/:customer_id/cloud_accounts
It lists the cloud accounts available for a customer.
Inputs
None
Returns
An array of cloud accounts, each with the following fields:
| Field | Type | Description |
|---|---|---|
| id | String | Identifier of the cloud account. |
| cloud_provider_id | String | Identifier of the cloud provider. |
| name | String | The logical name for the cloud account. |
| last_discovered_at | Time | Time at which the cloud account was last searched for server candidates for brownfield importing. |
| last_discovery_failed_at | Time | Last time at which the cloud account's discovery of server candidates for brownfield importing failed. |
| resource_type | String | An identifier for the type of resource, specifically "cloud_account". |
| supports_importing | Boolean | Flag to indicate whether this cloud account supports importing servers |
| supports_importing_vpcs | Boolean | Flag to indicate whether this cloud account supports importing VPCs |
| supports_importing_floating_ips | Boolean | Flag to indicate whether this cloud account supports importing floating IPs |
| supports_importing_volumes | Boolean | Flag to indicate whether this cloud account supports importing volumes |
Show cloud account
GET /v2/admin/cloud_accounts/:id
It shows information about a cloud account.
Inputs
None
Returns
A cloud account with the following fields:
| Field | Type | Description |
|---|---|---|
| id | String | Identifier of the cloud account. |
| cloud_provider_id | String | Identifier of the cloud provider. |
| name | String | The logical name for the cloud account. |
| last_discovered_at | Time | Last time at which the cloud account's discovery of server candidates for brownfield importing was successful. |
| last_discovery_failed_at | Time | Last time at which the cloud account's discovery of server candidates for brownfield importing failed. |
| resource_type | String | An identifier for the type of resource, specifically "cloud_account". |
| supports_importing | Boolean | Flag to indicate whether this cloud account supports importing servers |
| supports_importing_vpcs | Boolean | Flag to indicate whether this cloud account supports importing VPCs |
| supports_importing_floating_ips | Boolean | Flag to indicate whether this cloud account supports importing floating IPs |
| supports_importing_volumes | Boolean | Flag to indicate whether this cloud account supports importing volumes |
Create cloud account
POST /v2/admin/customers/:customer_id/cloud_accounts
It creates a cloud account for a customer.
Inputs
| Field | Type | Description | Required |
|---|---|---|---|
| cloud_provider_id | String | Identifier of the cloud provider. | Yes |
| credentials | Object | An object or dictionary with the credentials of the cloud account. It must have a property for every credential required by the cloud provider. | Yes |
| name | String | The logical name for the cloud account. | Yes |
| validate_master_account | Boolean | Flag to indicate whether it is necessary to validate credentials in the master account. | No |
Returns
cloud account with the following fields:
| Field | Type | Description |
|---|---|---|
| id | String | Identifier of the cloud account. |
| cloud_provider_id | String | Identifier of the cloud provider. |
| name | String | The logical name for the cloud account. |
| last_discovered_at | Time | Time at which the cloud account was last searched for server candidates for brownfield importing. |
| last_discovery_failed_at | Time | Last time at which the cloud account's discovery of server candidates for brownfield importing failed. |
| resource_type | String | An identifier for the type of resource, specifically "cloud_account". |
| supports_importing | Boolean | Flag to indicate whether this cloud account supports importing servers |
| supports_importing_vpcs | Boolean | Flag to indicate whether this cloud account supports importing VPCs |
| supports_importing_floating_ips | Boolean | Flag to indicate whether this cloud account supports importing floating IPs |
| supports_importing_volumes | Boolean | Flag to indicate whether this cloud account supports importing volumes |
Update cloud account
PUT /v2/admin/cloud_accounts/:id
It updates the name and/or credentials of a cloud account.
Inputs
| Field | Type | Description | Required |
|---|---|---|---|
| credentials | Object | An object or dictionary with the credentials of the cloud account. It must have a property for every credential required by the cloud provider. | No |
| name | String | The logical name for the cloud account. | No |
| validate_master_account | Boolean | Flag to indicate whether it is necessary to validate credentials in the master account. | No |
Returns
A cloud account with the following fields:
| Field | Type | Description |
|---|---|---|
| id | String | Identifier of the cloud account. |
| cloud_provider_id | String | Identifier of the cloud provider. |
| name | String | The logical name for the cloud account. |
| last_discovered_at | Time | Time at which the cloud account was last searched for server candidates for brownfield importing. |
| last_discovery_failed_at | Time | Last time at which the cloud account's discovery of server candidates for brownfield importing failed. |
| resource_type | String | An identifier for the type of resource, specifically "cloud_account". |
| supports_importing | Boolean | Flag to indicate whether this cloud account supports importing servers |
| supports_importing_vpcs | Boolean | Flag to indicate whether this cloud account supports importing VPCs |
| supports_importing_floating_ips | Boolean | Flag to indicate whether this cloud account supports importing floating IPs |
| supports_importing_volumes | Boolean | Flag to indicate whether this cloud account supports importing volumes |
Destroy cloud account
DELETE /v2/admin/cloud_accounts/:id
It deletes a cloud account from the platform. As a result of this API request, servers, VPCs and other resources deployed with or imported from the cloud account will cease to be represented on the platform API and UI. A cloud account cannot be destroyed if it has some associated resources in the platform unless the flag ‘force' set to true in the request. In the case this flag set to true, deletions are only on the platform, not on the cloud provider.
Inputs
| Field | Type | Description | Required |
|---|---|---|---|
| force | Boolean | Flag to indicate whether the cloud account is forced to be destroyed even it has associated resources. (Deletion only on the platform, not on the cloud provider) | No |
Returns
None