Manage and monitor virtual machines easily.

The Application Programmer Interface [API] allows customers to manage and monitor the lifecycle of their virtual machines using endpoints that can be easily integrated in the customer´s software stack.

GREENCLOUDS offers two API’s based on best-of-breed and well-known technologies called REST and SOAP. The GREENCLOUDS API can be used from custom or off-the-shelf tooling that the customer uses for managing and monitoring virtual machines. Developers and operations can utilize the GREENCLOUDS API when building their mission-critical applications.

The key characteristics of the GREENCLOUDS API are:
  • Scalable and fault-tolerant;
  • Secure by using secured keys;
  • Easy to integrate in existing customer software stack. Pre-packaged Java and .NET client-stubs are offered to enable even faster integration;
  • Standards-based (REST, SOAP);
  • Revoking or granting access to users;
  • Delegation model for usage of the API to downstream clients;
  • Easy integration with existing client-tools for managing or monitoring purposes;
  • Delegation model for granting access to the API to downstream clients.

    • This allows developers to perform multiple operations in a single call, reducing round trips and latency. The process of handling a request is as follows:
  • The API call is executed from any location, such as a company network. In the call the API-key is embedded that contains the credentials for authentication;
  • The call is received by an API Endpoint handler which is a robust and fault-tolerant cluster of machines capable of accepting many concurrent requests;
  • The API enters the GREENCLOUDS internal network where it´s being processed further.

    • The GREENCLOUDS API allows customers to manage and monitor the lifecycle of their virtual machines. Contact GREENCLOUDS to learn more.

    Related FAQ’s regarding API:

    Receiving an API key


    If you’d like to receive an API key, send an e-mail to support@greencloudsonline.com. You will receive the key and your username shortly.

    Where can I find my API?


    The latest versions of our REST API endpoints can always be found at the following addresses:
  • http://lb-p-01-pub.greencloudsonline.com/gc-api-rest/
  • http://lb-p-02-pub.greencloudsonline.com/gc-api-rest/

    • We provide specific versions that can be accessed by a direct URL of the following format:
  • http://lb-p-01-pub.greencloudsonline.com/gc-api-rest-[version-identifier]/
  • http://lb-p-02-pub.greencloudsonline.com/gc-api-rest-[version-identifier]/

    • Our technical documentation can be found here:
  • http://lb-p-01-pub.greencloudsonline.com/gc-api-rest-/docs/apidocs.html
  • http://lb-p-02-pub.greencloudsonline.com/gc-api-rest-/docs/apidocs.html


    • How can I test my API?


    We have very good experiences with a Chrome plugin called Dev HTTP Client. This is a free-of-charge tool that can be downloaded from Chrome. When installed your Chrome home page will look like this. See the Dev HTTP Client option on the right.

    Chrome plugin 550x180 How can I test my API?

    When you’ve downloaded and installed this plugin in your Chrome browser you can create REST-based repositories in the user interface, as you can see here.

    Repositories 550x70 How can I test my API?

    Clicking on one of the repositories brings you to the details. In the example below we have provided a few friendly names for the various service operations that we want to test.

    Repositories details 550x95 How can I test my API?

    To create a new repository or to add operations to an existing repository is done by saving the request you are working on using the Save button:

    Repositories request 550x51 How can I test my API?

    The following window pops up, whereby the name is the name of the operation, such as Destroy Products and the label is the name of the repository.

    Repositories save request How can I test my API?

    You can share your repositories with your colleagues using the Export and Import buttons.

    NOTE: In this article we are using a nice online formatter that will make your JSON requests a lot more readable:


    Browse all FAQ’s in our knowledge base here.