Managing services

Important

Before you start managing services, refer to the “Acronis Cyber Protect Cloud services availability by data center” KB article and check what services are available in your data center.

Operations with services (also called “applications”) are located under the /applications endpoint in the API.

The API represents a service as a JSON object.

JSON object structure of a service

Name	Value type	Description
id	UUID string	The universally unique identifier (UUID) of the service. This UUID is used for accessing the service via the API.
api_base_url	string	The service console endpoint. The full URL of the service console is a concatenation of, for example, {{beta-url}} and this value.
name	string	The display name of the service.
type	string	The internal name of the service.
usages	array of strings	The names of service usage metrics that are available in reports.

Sample JSON object of a service

{
    "name": "Cyber Infrastructure",
    "id": "cc29685d-a9ca-3e87-a83d-069f18b588f0",
    "api_base_url": "/hci/",
    "usages": [
        "hci_cifs_storage",
        "hci_iscsi_storage",
        "hci_nfs_storage",
        "hci_s3_storage",
        "hci_storage",
        "hci_total_cifs_storage",
        "hci_total_iscsi_storage",
        "hci_total_nfs_storage",
        "hci_total_s3_storage",
        "hci_total_storage",
        "hci_total_vm_provisioned_cpu",
        "hci_total_vm_provisioned_ram",
        "hci_total_vm_storage",
        "hci_vm_provisioned_cpu",
        "hci_vm_provisioned_ram",
        "hci_vm_storage"
    ],
    "type": "hci"
}

What you can do with services

Operation	Methods and endpoints used
Fetch information about all platform services	GET /applications
Fetch information about services enabled for a tenant	GET /tenants/{tenant_id}/applications [Optional] GET /applications
Fetch information about an individual service	GET /tenants/{tenant_id}/applications GET /applications/{application_id}
Enable a service for a sub-tenant	GET /tenants/{tenant_id} GET /tenants/{tenant_id}/applications GET /applications POST /applications/{application_id}/bindings/tenants/{tenant_id}
Disable a service for a sub-tenant	GET /tenants/{tenant_id}/applications GET /applications DELETE /applications/{application_id}/bindings/tenants/{tenant_id}