Xeround Cloud Database API
Get up & Running with Xeround in Minutes!
Xeround’s API allows developers to easily configure their application to provision and manage multiple Xeround cloud database instances.
Many applications today are required to create a new database instance for every end user or account that uses the service. This is especially true for SaaS, and PaaS applications.
Effectively managing sometimes thousands of database instances is becoming a major operation problem for many providers. Each database has its own needs in terms of size, throughput and performance – and ensuring multi-tenancy, scalability and availability, is challenging.
With a couple of API calls you can now integrate Xeround’s Database-as-a-Service (DBaaS) with your platform, and easily create multiple database instances and assure they are optimally running in the cloud. With scalability and availability automatically handled by the service itself – you are free to focus on the application rather than on the IT operations.
Technical Overview
The Xeround Service API allows developers to connect third-party applications to Xeround service and automate processes available via Xeround’s Database Manager UI.
The API is accessible using either REST or SOAP, per your preference.
To use the API you need to be a registered user of Xeround’s Database-as-a-service.
Connecting to the API
The connection is secured over HTTPS, authentication is done with your user credentials added to the HTTP header via HTTP Basic Authentication.
- To access the API’s landing page navigate with your browser to: https://api.xeround.com:8443
- To access the API using SOAP: https://api.xeround.com:8443/1.1/soap?wsdl
- To access the API using REST: https://api.xeround.com:8443/1.1/rest
- To use SOAP from a JAVA application: use xeround-api-service-1.1.jar
Note: the API uses a certificate issued by GoDaddy. You may need to add it to your trusted certificate issuers (see the following instructions) and make sure that your application uses that keystore:
- Access https://certs.godaddy.com/anonymous/repository.seam
- Download the Go Daddy Secure Server Certificate (Intermediate Certificate) – gd_intermediate.crt
- Import GoDaddy’s certificate into the trust store using the following command:
./keytool -import -alias “gd_intermediate” -file gd_intermediate.crt -keystore xeround.service.api.truststore
Actions
The following actions are currently supported:
- createDbInstance
- dropDbInstance
- getDbInstanceInfo
- getDbInstanceCost
- changeDbInstancePassword
Common Errors
There are two common errors that all actions return:
- 201 - Unable to perform the action
- 202 – Invalid parameter value
For action-specific errors please see the documentation.
How to use Xeround API?
Download the Documentation »
Xeround API Version: 1.2
