This page describes basic remote services management with the Abiquo API.
When you create a location (datacenter or public cloud region), you will supply the URLs of remote services. These remote services will be registered in Abiquo and they will also be assigned to the location you are creating.
Prerequisites
Before you begin working with remote services, create a datacenter, using the UI or the API, as described in the API infrastructure tutorial.
Retrieve existing remote services
To retrieve all the remote services currently registered in Abiquo, use a GET request to the RemoteServices Resource.
See https://wiki.abiquo.com/api/latest/RemoteServicesResource.html#list-remote-services
Check remote services
The following example shows how to check a remote service from the IP address (as with the check button in the UI). In this case we are checking a NARS remote service. If you want to check other remote services, just replace the remote service details in the example below.
Check a remote service from the IP address
cURL:
curl -X POST https://example.com:443/api/config/action/remoteservicecheck \ -H 'Content-Type:application/vnd.abiquo.remoteservice+json;version=5.0' \ -d @requestpayload.json \ -u admin:xabiquo --verbose
Success status code: 204
Request payload:
{
"links":[],
"type":"NARS",
"uri":"http://mjsrs.bcn.abiquo.com:8009/nars"
}
Response payload:
--none--
Check a remote service that is already registered in Abiquo
To check a remote service that is already registered in Abiquo, you can use the link in the remote service entity or its ID.
See https://wiki.abiquo.com/api/latest/RemoteServicesResource.html#check-a-remote-service
Modify a remote service to add it to locations
To modify a remote service to add it to public cloud regions or datacenters, perform a PUT request with a remote service entity containing the links to the locations where you want to add the remote service.
https://wiki.abiquo.com/api/latest/RemoteServicesResource.html#update-a-remote-service