This PHP API client library provides integration with the UpCloud API allowing operations used to manage resources on UpCloud. The client is a web service interface that uses HTTPS to connect to the API. The API follows the principles of a RESTful web service wherever possible.

The base URL for all API operations is https://api.upcloud.com/ and require basic authentication using UpCloud username and password. We recommend creating a subaccount dedicated for the API communication for security purposes. This allows you to restrict API access by servers, storages, and tags ensuring you will never accidentally affect critical systems.

• Installation
• Usage
• Documentation
• Issues
• License

Using this library requires the PHP version 5.5 and later.

To install the bindings via Composer, add the following to composer.json:

{
  "require": {
    "upcloudltd/upcloud-php-api": "v1.0.3"
  }
}

Then run composer install

The upcloudltd/upcloud-php-api can be found from packagist.org, https://packagist.org/packages/upcloudltd/upcloud-php-api

Download the files and include autoload.php:

    require_once('/path/to//vendor/autoload.php');

To run the unit tests:

composer install
UPCLOUD_API_TEST_USER=user UPCLOUD_API_TEST_PASSWORD=pass ./vendor/bin/phpunit

Note: You need to supply an UpCloud account's details to run the tests. The tests will create/modify/delete servers under this account in the actual UpCloud environment, so please use a test account.

Please follow the installation procedure and then run the following (NOTE: In real production applications you should use for example ENV variables instead of inserting credentials directly to code and to version control):

<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Upcloud\ApiClient\Upcloud\AccountApi();
$config = $api_instance->getConfig();
$config->setUsername('YOUR UPCLOUD USERNAME');
$config->setPassword('YOUR UPCLOUD PASSWORD');

try {
    $result = $api_instance->getAccount();
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AccountApi->getAccount: ', $e->getMessage(), PHP_EOL;
}

?>

To create a server:

<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Upcloud\ApiClient\Upcloud\AccountApi();
$config = $api_instance->getConfig();
$config->setUsername('YOUR UPCLOUD USERNAME');
$config->setPassword('YOUR UPCLOUD PASSWORD');

try {
        $result = $api_instance->getAccount();
            print_r($result);
} catch (Exception $e) {
        echo 'Exception when calling AccountApi->getAccount: ', $e->getMessage(), PHP_EOL;
}

$server = new Upcloud\ApiClient\Model\Server();
$server->setTitle('php-test-machine');
$server->setZone('fi-hel1');
$server->setHostname('phptest');
$server->setPlan('1xCPU-1GB');

$storage = new Upcloud\ApiClient\Model\StorageDevice();
$storage->setStorage('01000000-0000-4000-8000-000030040200');
$storage->setSize(50.0);
$storage->setAction('clone');
$storage->setTitle('php-test-storage');

$storage_devices = new Upcloud\ApiClient\Model\ServerStorageDevices();
$storage_devices->setStorageDevice($storage);

$server->setStorageDevices($storage_devices);

$server_request = new Upcloud\ApiClient\Model\CreateServerRequest();
$server_request->setServer($server);
$api_instance = new Upcloud\ApiClient\Upcloud\ServerApi();
try {
        $result = $api_instance->createServer($server_request);
            print_r($result);
} catch (Exception $e) {
        echo 'Exception when calling ServerApi->createServer: ', $e->getMessage(), PHP_EOL;
}

?>

All URIs are relative to https://api.upcloud.com/1.2

• Account
• AccountResponse
• AddIpRequest
• AddressFamily
• AssignIpResponse
• AttachStorageDeviceRequest
• AvailablePlanListResponse
• AvailablePlanListResponsePlans
• BackupRule
• CloneStorageRequest
• ConfigurationListResponse
• ConfigurationListResponseServerSizes
• CreateBackupStorageRequest
• CreateNewTagResponse
• CreateServerRequest
• CreateServerResponse
• CreateStorageRequest
• CreateStorageResponse
• Error
• ErrorCode
• ErrorError
• ErrorStatus
• FirewallRule
• FirewallRuleCreateResponse
• FirewallRuleListResponse
• FirewallRuleListResponseFirewallRules
• FirewallRuleRequest
• IpAddress
• IpAddressListResponse
• IpAddresses
• ModifyIpRequest
• ModifyStorageRequest
• ModifyTagRequest
• Plan
• Price
• PriceListResponse
• PriceListResponsePrices
• PriceZone
• RestartServer
• Server
• ServerListResponse
• ServerListResponseServers
• ServerSize
• ServerState
• ServerStorageDevices
• ServerTags
• StopServer
• StopServerRequest
• Storage
• StorageAccessType
• StorageBackups
• StorageDevice
• StorageDeviceDetachRequest
• StorageDeviceLoadRequest
• StorageServers
• StorageState
• StorageTier
• StorageType
• SuccessStoragesResponse
• SuccessStoragesResponseStorages
• Tag
• TagCreateRequest
• TagListResponse
• TagListResponseTags
• TagServers
• TemplitizeStorageRequest
• Timezone
• TimezoneListResponse
• TimezoneListResponseTimezones
• Zone
• ZoneListResponse
• ZoneListResponseZones

It's recommended to store the username and password in a separate configuration file while developing API applications to avoid accidentally publishing your account credentials.

• Type: HTTP basic authentication
• Username: Your UpCloud API username
• Password: Your UpCloud API user's password

Found a bug, have a problem using the client, or anything else about the library you would want to mention? Open a new issue here to get in contact.

This project is distributed under the MIT License, see LICENSE.txt for more information.