12. usage – Virtual Machine Resource Usage

Virtual machine resource usage functionality.

12.1. Resources

12.1.1. Usage

class usage.Usage

This resource represens virtual machine resource usage data.

Resource URI:

/rest/hosting/usage/

GET()

Retrieve the usage data by submitting an HTTP GET request.

Note

This resource requires read permission on the elastic_hosting extension module.

Return type:usage.RepUsage

12.1.2. UsageUUID

class usage.UsageUUID

This resource represens virtual machine resource usage data for a particular virtual machine.

Resource URI:

/rest/hosting/usage/<UUID>/

GET()

Retrieve the usage data by submitting an HTTP GET request. The UUID in the resource path should be the uuid of the target virtual machine.

Note

This resource requires read permission both on the elastic_hosting extension module and on the target virtual machine.

Return type:usage.RepUsage

12.2. Representations

12.2.1. RepUsage

class usage.RepUsage

This is a representation of the virtual machine resource usage data.

Representation:

{"vms": {"used": usage.used_vms, "available": usage.available_cpus},
 "cpus": {"used": usage.used_cpus, "available": usage.available_cpus},
 "memory": {"used": usage.used_memory, "available": usage.available_memory},\
 "storage": {"used": usage.used_storage, "available": usage.available_storage}}