DevicesResource


List devices in a location


Returns all the usable devices in the location (device in this enterprise or all enterprises)

GET https://example.com/api/cloud/locations/{location}/devices

Roles : [ROLE_VDC_ENUMERATE]

Parameter Type Default Value Description
startwith Integer 0 The first element to be retrieved of the filtered search
by String name Parameter for ordering. Valid values {@link com.abiquo.server.core.cloud.Device.ORDER_BY}
has String If present filter to apply in the search.
limit Integer 25 The number of entities to retrieve
asc Boolean true If the value of the 'by' parameter must be sorted in ascending order (true) or descending order (false)

Accept : devices

Error Codes

  • LOCATION-4 - The location does not exist

Example

Get a device in a location


GET https://example.com/api/cloud/locations/{location}/devices/{device}

Roles : [ROLE_VDC_ENUMERATE]

Accept : device

Error Codes

  • NETDEVICE-1 - The device does not exist

Example

List virtual datacenters using a device


GET https://example.com/api/cloud/locations/{location}/devices/{device}/virtualdatacenters

Roles : [ROLE_VDC_ENUMERATE]

Example

List ssl certificates


List all SSL certificates available in the given location.
Some providers can reuse existing SSL certificates by using a link instead of embedding all the certificate info.

GET https://example.com/api/cloud/locations/{location}/devices/{device}/sslcertificates

Roles : [ROLE_MANAGE_LOADBALANCERS]

Parameter Type Default Value Description
source String LOCAL use ''REMOTE'' to force the synchronization in the provider

Accept : sslcertificates

Example

Get a ssl certificate


Get an SSL certificate in a given location.

GET https://example.com/api/cloud/locations/{location}/devices/{device}/sslcertificates/{sslcertificate}

Roles : [ROLE_MANAGE_LOADBALANCERS]

Accept : sslcertificate

Error Codes

  • LOADBALANCER-18 - The requested SSL certificate does not exist

Example