UpCloud is a cloud hosting platform used to run virtual servers. UpCloud provides:
- easy creation and hosting of virtual server instances
- management of hosting resources such as servers, storages and IP addresses efficiently
- quickly upscaling and downscaling servers
- migrating servers to different geographical locations
- a private network for communication between servers
- firewall services
The billing of resources is done by the hour on a utility basis.
This document describes the Application Programming Interface (API) to UpCloud. It gives information on how to use the API to build applications to control resources such as servers and storages on UpCloud. API client applications can be used to automate regular tasks on the cloud such as creating new servers and to abstract the end user from the cloud service.
This technical document is intended for developers building applications using the UpCloud API. Basic knowledge in programming is required to use the API. The API is independent from any programming language.
|1.0.0||Apr 27, 2012||First version of this document.|
|1.0.1||Jul 9, 2012||Added the error code CDROM_EJECT_FAILED to the Eject CD-ROM operation.|
|1.0.2||Oct 3, 2012||Added the new storage resource backup features.|
|1.0.3, 1.1.1||Aug 7, 2013||Added the Modify IP address operation for modifying PTR records. Storages are divided into two tiers:
|1.2.0||Mar 30, 2015||Storage tier
|1.2.1||Apr 29, 2015||Server attribute
|1.2.2||Jul 20, 2015||Server attribute
|1.2.3||Apr 28, 2016||Server creation attributes
|1.2.4||Jul 4, 2016||Firewall rule attribute
|1.2.5||Jun 20, 2017||Server attributes
|1.2.6||Jan 2, 2018||Server operation cancellation added.
|1.2.7||Mar 1, 2018||Flag for setting storages as boot disks and
|1.2.8||Mar 1, 2019||Storages can now be removed during server deletion by adding ?storages=1 to the end of server deletion URI. The platform may rate-limit non-virtio network devices. Other smaller fixes and clarifications.|
Changes from version 1.1
List of incompatible changes from version 1.1
- IP address and Firewall Rule operations now require
- Customers can now configure servers to avoid certain hosts for added redundancy of environments.