upcloud_api 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9b9499c81732dab73f760bcfc382a7c288d82960
-  data.tar.gz: 61ec8087b5b00f870495fdf4c9859e962c8675f4
+  metadata.gz: 8b54b7fb711a64b56613be72b899acdc0305e9d0
+  data.tar.gz: b88391e2f5aff4f02b5f16f1849f215038081303
 SHA512:
-  metadata.gz: 52496d8d4289e67cf15da5703500e497201d312553c78eaf58e548d1958796075177405ae5b5acc75dbfc1a594bc6b6fc7913cc8d789c7cce7cbdbb47b4c7e8e
-  data.tar.gz: edab2b929517934e42e082142ae19b5c186116b4a3cc248cf31df506974b415641dd4e46efbe07d175fa100c120b63f642bcd799ac06352ac35de4a0e66d3660
+  metadata.gz: 993b7e0461cd0bd75e700a8099a25ee50aa67facb21034201c01417c796d86d339b5790c6ad87a0c95a73cc6221b0d2f33ef47ade05eaaf6d419a216884914a7
+  data.tar.gz: f5f091a10d094926a09e1357d832524ef76643b5fd730e51c854e64201d1f1e1d2a87ea9984d749c15dc4b484f3e3797c830a61f61c0c94b9277616dcb9581f5

data/lib/upcloud_api/version.rb

@@ -1,3 +1,3 @@
 class UpcloudApi
-  VERSION = "2.0.0".freeze
+  VERSION = "2.1.0".freeze
 end

data/lib/upcloud_api.rb

@@ -19,7 +19,7 @@ class UpcloudApi
   #
   # Calls GET /1.2/server
   #
-  # Returns true in success, false if not.
+  # @return true in success, false if not.
   def login
     response = get "server"
     response.code == 200
@@ -29,7 +29,9 @@ class UpcloudApi
   #
   # Calls GET /1.2/server_size.
   #
-  # Returns array of server size hashes:
+  # @return array of server size hashes
+  #
+  # @example Return hash
   #   {
   #     "core_number": "1",
   #     "memory_amount": "512"
@@ -43,7 +45,7 @@ class UpcloudApi
   #
   # Calls GET /1.2/acccount
   #
-  # Returns available credits in the account as a string.
+  # @return available credits in the account as a string.
   def account_information
     response = get "account"
     data = JSON.parse response.body
@@ -54,14 +56,16 @@ class UpcloudApi
   #
   # Calls GET /1.2/server.
   #
-  # Returns array of servers with following values or empty array if no servers found.
-  # - zone
-  # - core_number
-  # - title
-  # - hostname
-  # - memory_amount
-  # - uuid
-  # - state
+  # @return array of servers with following values or empty array if no servers found.
+  #
+  # @example Return values
+  #   - zone
+  #   - core_number
+  #   - title
+  #   - hostname
+  #   - memory_amount
+  #   - uuid
+  #   - state
   def servers
     response = get "server"
     data = JSON.parse response.body
@@ -74,7 +78,9 @@ class UpcloudApi
   #
   # @param uuid from UpcloudApi#servers
   #
-  # Returns hash of server details or nil:
+  # @return hash of server details or nil
+  #
+  # @example Return values
   #   {
   #    "boot_order"         => "cdrom,disk",
   #    "core_number"        => "3",
@@ -137,8 +143,7 @@ class UpcloudApi
   #
   # Calls POST /1.2/server.
   #
-  # Storage devices should be array of hashes containing following data:
-  #
+  # @example Storage devices should be array of hashes containing following data
   #   {
   #     "action"  => "clone"          # Can be "create", "clone" or "attach"
   #     "storage" => template_uuid,   # Should be passed only for "clone" or "attach"
@@ -149,7 +154,7 @@ class UpcloudApi
   # @param plan [String] Preconfigured plan for the server. If nil, a custom plan will be created from input data, otherwise this overrides custom configuration.
   #   Predefined plans can be fetched with {#plans}.
   #
-  # login_user should be following hash or nil:
+  # @example login_user should be following hash or nil
   #   {
   #     "username": "upclouduser",
   #     "ssh_keys": {
@@ -160,12 +165,12 @@ class UpcloudApi
   #     }
   #   }
   #
-  # ip_addresses should be an array containing :public, :private and/or :ipv6. It defaults to
+  # @param ip_addresses should be an array containing :public, :private and/or :ipv6. It defaults to
   # :all, which means the server will get public IPv4, private IPv4 and public IPv6 addresses.
   #
   # @param other [Hash] Other optional arguments create_server API call takes. See Upcloud’s documentation for possible values.
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def create_server(zone: "fi-hel1", title:, hostname:, core_number: 1,
                     memory_amount: 1024, storage_devices:, ip_addresses: :all,
                     plan: nil, login_user: nil, other: nil)
@@ -212,12 +217,12 @@ class UpcloudApi
   #
   # In order to modify a server, the server must be stopped first.
   #
-  # Calls PUT /1.2/server/_uuid_.
+  # Calls PUT /1.2/server/_server_uuid_.
   #
   # @param server_uuid [String] UUID of the server that will be modified.
   # @param params [Hash] Hash of params that will be passed to be changed.
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def modify_server(server_uuid, params)
     data = { "server" => params }
     json = JSON.generate data
@@ -230,9 +235,9 @@ class UpcloudApi
   #
   # In order to delete a server, the server must be stopped first.
   #
-  # Calls DELETE /1.2/server/_uuid_.
+  # Calls DELETE /1.2/server/_server_uuid_.
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def delete_server(server_uuid)
     response = delete "server/#{server_uuid}"
 
@@ -241,11 +246,11 @@ class UpcloudApi
 
   # Starts server that is shut down.
   #
-  # Calls POST /1.2/server/_uuid_/start.
+  # Calls POST /1.2/server/_server_uuid_/start.
   #
   # @param server_uuid UUID of the server.
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def start_server(server_uuid)
     response = post "server/#{server_uuid}/start"
 
@@ -264,16 +269,16 @@ class UpcloudApi
   #
   # @param server_uuid UUID of the server
   # @param type Type of the shutdown. Available types are :hard and :soft.
-  # Defaults to :soft.
+  #   Defaults to :soft.
   # @param timeout Time after server will be hard stopped if it did not
-  # close cleanly. Only affects :soft type.
+  #   close cleanly. Only affects :soft type.
   # @param asynchronous If false, this call will wait until the server
-  # has really stopped.
+  #   has really stopped.
   #
-  # Raises Timeout::Error in case server does not shut down in 300
-  # seconds in non-asynchronous mode.
+  # @raise Timeout::Error in case server does not shut down in 300
+  #   seconds in non-asynchronous mode.
   #
-  # Returns HTTParty response object if server was removed successfully or request is asynchronous and nil otherwise
+  # @return HTTParty response object if server was removed successfully or request is asynchronous and nil otherwise
   def stop_server(server_uuid, type: :soft, timeout: nil, asynchronous: false)
     data = {
       "stop_server" => {
@@ -311,14 +316,14 @@ class UpcloudApi
   #
   # @param server_uuid UUID of the server
   # @param type Type of the shutdown. Available types are :hard and :soft.
-  # Defaults to :soft.
+  #   Defaults to :soft.
   # @param timeout Time after server will be hard stopped if it did not
-  # close cleanly. Only affects :soft type.
+  #   close cleanly. Only affects :soft type.
   # @param timeout_action What will happen when timeout happens.
-  # :destroy hard stops the server and :ignore stops the operation
-  # if timeout happens. Default is :ignore.
+  #   :destroy hard stops the server and :ignore stops the operation
+  #   if timeout happens. Default is :ignore.
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def restart_server(server_uuid, type: :soft, timeout: nil, timeout_action: :ignore)
     data = {
       "restart_server" => {
@@ -339,18 +344,18 @@ class UpcloudApi
   #
   # Calls GET /1.2/storage or /1.2/storage/_type_.
   #
-  # Available types:
-  # - public
-  # - private
-  # - normal
-  # - backup
-  # - cdrom
-  # - template
-  # - favorite
+  # @example Available types
+  #   - public
+  #   - private
+  #   - normal
+  #   - backup
+  #   - cdrom
+  #   - template
+  #   - favorite
   #
   # @param type Type of the storages to be returned on nil.
   #
-  # Returns array of storages, inside "storage" key in the API or empty array if none found.
+  # @return array of storages, inside "storage" key in the API or empty array if none found.
   def storages(type: nil)
     response = get(type && "storage/#{type}" || "storage")
     data = JSON.parse response.body
@@ -363,7 +368,8 @@ class UpcloudApi
   #
   # @param storage_uuid UUID of the storage.
   #
-  # Returns hash of following storage details or nil:
+  # @return hash of following storage details or nil
+  # @example Return values
   #   {
   #     "access"  => "public",
   #     "license" => 0,
@@ -389,21 +395,21 @@ class UpcloudApi
   #
   # Calls POST /1.2/storage.
   #
-  # backup_rule should be hash with following attributes:
-  # - interval # allowed values: daily / mon / tue / wed / thu / fri / sat / sun
-  # - time # allowed values: 0000-2359
-  # - retention # How many days backup will be kept. Allowed values: 1-1095
+  # @example backup_rule should be hash with following attributes
+  #   - interval # allowed values: daily / mon / tue / wed / thu / fri / sat / sun
+  #   - time # allowed values: 0000-2359
+  #   - retention # How many days backup will be kept. Allowed values: 1-1095
   #
   # @param size Size of the storage in gigabytes
   # @param tier Type of the disk. maxiops is SSD powered disk, other
-  # allowed value is "hdd"
+  #   allowed value is "hdd"
   # @param title Name of the disk
   # @param zone Where the disk will reside. Needs to be within same zone
-  # with the server
+  #   with the server
   # @param backup_rule Hash of backup information. If not given, no
-  # backups will be automatically created.
+  #   backups will be automatically created.
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def create_storage(size:, tier: "maxiops", title:, zone: "fi-hel1",
                      backup_rule: nil)
     data = {
@@ -426,18 +432,18 @@ class UpcloudApi
   #
   # Calls PUT /1.2/storage/_uuid_.
   #
-  # backup_rule should be hash with following attributes:
-  # - interval # allowed values: daily / mon / tue / wed / thu / fri / sat / sun
-  # - time # allowed values: 0000-2359
-  # - retention # How many days backup will be kept. Allowed values: 1-1095
+  # @example backup_rule should be hash with following attributes
+  #   - interval # allowed values: daily / mon / tue / wed / thu / fri / sat / sun
+  #   - time # allowed values: 0000-2359
+  #   - retention # How many days backup will be kept. Allowed values: 1-1095
   #
   # @param storage_uuid UUID of the storage that will be modified
   # @param size Size of the storage in gigabytes
   # @param title Name of the disk
   # @param backup_rule Hash of backup information. If not given, no
-  # backups will be automatically created.
+  #   backups will be automatically created.
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def modify_storage(storage_uuid, size:, title:, backup_rule: nil)
     data = {
       "storage" => {
@@ -462,12 +468,12 @@ class UpcloudApi
   #
   # @param storage_uuid UUID of the storage that will be modified
   # @param tier Type of the disk. maxiops is SSD powered disk, other
-  # allowed value is "hdd"
+  #   allowed value is "hdd"
   # @param title Name of the disk
   # @param zone Where the disk will reside. Needs to be within same zone
-  # with the server
+  #   with the server
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def clone_storage(storage_uuid, zone: "fi-hel1", title:, tier: "maxiops")
     data = {
       "storage" => {
@@ -493,7 +499,7 @@ class UpcloudApi
   # @param storage_uuid UUID of the storage that will be templatized
   # @param title Name of the template storage
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def templatize_storage(storage_uuid, title:)
     data = {
       "storage" => {
@@ -519,9 +525,9 @@ class UpcloudApi
   # @param storage_uuid UUID of the storage that will be attached.
   # @param type Type of the disk. Valid values are "disk" and "cdrom".
   # @param address Address where the disk will be attached to. Defaults
-  # to next available address.
+  #   to next available address.
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def attach_storage(server_uuid, storage_uuid:, type: "disk", address: nil)
     data = {
       "storage_device" => {
@@ -546,7 +552,7 @@ class UpcloudApi
   # @param server_uuid UUID of the server from which to detach the storage.
   # @param address Address where the storage that will be detached resides.
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def detach_storage(server_uuid, address:)
     data = {
       "storage_device" => {
@@ -570,7 +576,7 @@ class UpcloudApi
   # @param storage_uuid UUID of the storage to be backed-up
   # @param title Name of the backup
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def create_backup(storage_uuid, title:)
     data = {
       "storage" => {
@@ -593,7 +599,7 @@ class UpcloudApi
   #
   # @param backup_uuid UUID of the backup
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def restore_backup(backup_uuid)
     response = post "storage/#{backup_uuid}/restore"
 
@@ -606,7 +612,7 @@ class UpcloudApi
   #
   # @param storage_uuid UUID of the storage to be included in favorites
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def favorite_storage(storage_uuid)
     response = post "storage/#{storage_uuid}/favorite"
 
@@ -619,7 +625,7 @@ class UpcloudApi
   #
   # @param storage_uuid UUID of the storage to be removed from favorites
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def defavorite_storage(storage_uuid)
     response = delete "storage/#{storage_uuid}/favorite"
 
@@ -634,7 +640,7 @@ class UpcloudApi
   #
   # @param storage_uuid UUID of the storage that will be deleted.
   #
-  # Returns HTTParty response object.
+  # @return HTTParty response object.
   def delete_storage(storage_uuid)
     response = delete "storage/#{storage_uuid}"
 
@@ -643,7 +649,8 @@ class UpcloudApi
 
   # Lists available predefined plans that can be used to create a server.
   #
-  # Returns Array of plan hashes:
+  # @return Array of plan hashes
+  # @example Return values
   #   [
   #    {
   #      "core_number" : 1,
@@ -661,6 +668,353 @@ class UpcloudApi
     data["plans"]["plan"]
   end
 
+  # Lists firewall rules of a server.
+  #
+  # Calls POST /1.2/server/_uuid_/firewall_rule.
+  #
+  # @param server_uuid [String] UUID of server
+  #
+  # @return Array of firewall rules
+  # @example Return values
+  #   [
+  #    {
+  #      "action": "accept",
+  #      "destination_address_end": "",
+  #      "destination_address_start": "",
+  #      "destination_port_end": "80",
+  #      "destination_port_start": "80",
+  #      "direction": "in",
+  #      "family": "IPv4",
+  #      "icmp_type": "",
+  #      "position": "1",
+  #      "protocol": "",
+  #      "source_address_end": "",
+  #      "source_address_start": "",
+  #      "source_port_end": "",
+  #      "source_port_start": ""
+  #    }
+  #   ]
+  def firewall_rules server_uuid
+    response = get "server/#{server_uuid}/firewall_rule"
+
+    data = JSON.parse response.body
+    data["firewall_rules"]["firewall_rule"]
+  end
+
+
+  # Creates new firewall rule to a server specified by _server_uuid_.
+  #
+  # Calls POST /1.2/server/_server_uuid_/firewall_rule.
+  #
+  # _params_ should contain data as documented in Upcloud’s API:
+  # https://www.upcloud.com/api/1.2.3/11-firewall/#create-firewall-rule .
+  # It should not contain "firewall_rule" wrapper hash, but only the values inside a hash.
+  #
+  # @example _params_ contents
+  #   {
+  #    "position": "1",
+  #    "direction": "in",
+  #    "family": "IPv4",
+  #    "protocol": "tcp",
+  #    "source_address_start": "192.168.1.1",
+  #    "source_address_end": "192.168.1.255",
+  #    "source_port_end": "",
+  #    "source_port_start": "",
+  #    "destination_address_start": "",
+  #    "destination_address_end": "",
+  #    "destination_port_start": "22",
+  #    "destination_port_end": "22",
+  #    "icmp_type": "",
+  #    "action": "accept"
+  #   }
+  #
+  # @param server_uuid [String] UUID of server
+  # @param params [Hash] Parameters for the firewall rule.
+  #
+  # @return HTTParty response object.
+  def create_firewall_rule server_uuid, params
+    data = {
+      "firewall_rule" => params
+    }
+
+    json = JSON.generate data
+
+    response = post "server/#{server_uuid}/firewall_rule", json
+
+    response
+  end
+
+  # Removes a firewall rule at position _position_.
+  #
+  # Calls DELETE /1.2/server/_server_uuid_/firewall_rule/_position_.
+  #
+  # A position of a rule can be seen with firewall_rules().
+  #
+  # @param server_uuid [String] UUID of server
+  # @param position [Integer] position of the rule in rule list that will be removed
+  #
+  # @return HTTParty response object.
+  def remove_firewall_rule server_uuid, position
+    response = delete "server/#{server_uuid}/firewall_rule/#{position}"
+
+    response
+  end
+
+  # Lists all tags with UUIDs of servers they are attached to.
+  #
+  # Calls GET /1.2/tags.
+  #
+  # @return Array of tag hashes
+  # @example Return values
+  #   [
+  #    {
+  #      "description": "Development servers",
+  #      "name": "DEV",
+  #      "servers": {
+  #        "server": [
+  #          "0077fa3d-32db-4b09-9f5f-30d9e9afb565"
+  #        ]
+  #      }
+  #    }
+  #   ]
+  def tags
+    response = get "tags"
+
+    data = JSON.parse response.body
+    data["tags"]["tag"]
+  end
+
+  # Creates new tag.
+  #
+  # Calls POST /1.2/tag.
+  #
+  # _params_ should contain following data
+  #   name        *required*
+  #   description
+  #   servers     *required*
+  #
+  # @example _params_ hash’s contents
+  #   {
+  #     "name": "DEV", # required
+  #     "description": "Development servers",
+  #     "servers":  [
+  #       "0077fa3d-32db-4b09-9f5f-30d9e9afb565",
+  #       ".."
+  #     ]
+  #   }
+  #
+  # @example Response body
+  #   {
+  #     "name": "DEV",
+  #     "description": "Development servers",
+  #     "servers": {
+  #       "server": [
+  #         "0077fa3d-32db-4b09-9f5f-30d9e9afb565"
+  #       ]
+  #     }
+  #   }
+  #
+  # @param server_uuid [String] UUID of server
+  # @param params [Hash] Parameters for the firewall rule.
+  #
+  # @return Tag parameters as Hash or HTTParty response object in case of error.
+  def create_tag server_uuid, params
+    data = {
+      "tag" => params
+    }
+    temp = data["servers"]
+    data["servers"] = { "server" => temp }
+
+    json = JSON.generate data
+
+    response = post "tag", json
+    return response unless response.code == 201
+
+    body = JSON.parse response.body
+    body["tag"]
+  end
+
+  # Modifies existing tag.
+  #
+  # Calls PUT /1.2/tag/_tag_.
+  #
+  # @note Attributes are same as with create_tag().
+  #
+  # @return Tag parameters as Hash or HTTParty response object in case of error.
+  def modify_tag tag
+    data = {
+      "tag" => params
+    }
+    temp = data["servers"]
+    data["servers"] = { "server" => temp }
+
+    json = JSON.generate data
+
+    response = put "tag/#{tag}", json
+    return response unless response.code == 200
+
+    body = JSON.parse response.body
+    body["tag"]
+  end
+
+  # Deletes existing tag.
+  #
+  # Calls DELETE /1.2/tag/_tag_.
+  #
+  # @return HTTParty response object.
+  def delete_tag tag
+    delete "tag/#{tag}"
+  end
+
+  # Attaches one or more tags to a server.
+  #
+  # Calls POST /1.2/server/_uuid_/tag/_tags_.
+  #
+  # @param server_uuid [String] UUID of the server
+  # @param tags [Array, String] Tags that will be attached to the server
+  #
+  # @return HTTParty response object.
+  def add_tag_to_server server_uuid, tags
+    tag = (tags.respond_to? :join && tags.join(",") || tags)
+
+    post "server/#{server_uuid}/tag/#{tag}"
+  end
+
+  # Removes one or more tags to a server.
+  #
+  # Calls POST /1.2/server/_uuid_/untag/_tags_.
+  #
+  # @param server_uuid [String] UUID of the server
+  # @param tags [Array, String] Tags that will be removed from the server
+  #
+  # @return HTTParty response object.
+  def remove_tag_from_server server_uuid, tags
+    tag = (tags.respond_to? :join && tags.join(",") || tags)
+
+    post "server/#{server_uuid}/untag/#{tag}"
+  end
+
+  # Lists all IP addresses visible to user specified in contructor along with
+  # their information and UUIDs of the servers they are bound to.
+  #
+  # Calls GET /1.2/ip_address.
+  #
+  # @return [Hash] details of IP addresses
+  # @example Return hash
+  #   [
+  #     {
+  #       "access": "private",
+  #       "address": "10.0.0.0",
+  #       "family": "IPv4",
+  #       "ptr_record": "",
+  #       "server": "0053cd80-5945-4105-9081-11192806a8f7"
+  #     }
+  #   ]
+  def ip_addresses
+    response = get "ip_address"
+    body = JSON.parse response.body
+    body["ip_addresses"]["ip_address"]
+  end
+
+  # Gives details of specific IP address.
+  #
+  # Calls GET /1.2/ip_address/_ip_address_.
+  #
+  # @param ip_address [String] IP address to get details for.
+  #
+  # @return [Hash] details of an IP address
+  # @example Return hash
+  #   {
+  #     "access": "public",
+  #     "address": "0.0.0.0"
+  #     "family": "IPv4",
+  #     "part_of_plan": "yes",
+  #     "ptr_record": "test.example.com",
+  #     "server": "009d64ef-31d1-4684-a26b-c86c955cbf46",
+  #   }
+  def ip_address_details ip_address
+    response = get "ip_address/#{ip_address}"
+    body = JSON.parse response.body
+    body["ip_address"]
+  end
+
+  # Adds new IP address to given server.
+  #
+  # Calls POST /1.2/ip_address.
+  #
+  # @note To add a new IP address, the server must be stopped.
+  # @note Only public IP addresses can be added. There is always exactly one private IP address per server.
+  # @note There is a maximum of five public IP addresses per server.
+  #
+  # @param server_uuid [String] UUID of the server
+  # @param family ["IPv4", "IPv6"] Type of the IP address.
+  #
+  # @see https://www.upcloud.com/api/1.2.3/10-ip-addresses/#assign-ip-address Upcloud’s API
+  #
+  # @return HTTParty response object.
+  def new_ip_address_to_server server_uuid, family: "IPv4"
+    data = {
+      "ip_address" => {
+        "family" => family,
+        "server" => server_uuid
+      }
+    }
+    json = JSON.generate data
+
+    post "ip_address", json
+  end
+
+  # Changes given IP address’s PTR record.
+  #
+  # Calls PUT /1.2/ip_address.
+  #
+  # @note Can only be set to public IP addresses.
+  #
+  # @return HTTParty response object.
+  def change_ip_address_ptr ip_address, ptr_record
+    data = {
+      "ip_address" => {
+        "ptr_record" => ptr_record
+      }
+    }
+    json = JSON.generate data
+
+    put "ip_address/#{ip_address}", json
+  end
+
+  # Removes IP address (from a server).
+  #
+  # Calls DELETE /1.2/_ip_address_.
+  #
+  # @todo I’m fairly sure the API call is wrong, but this is what their documentation says. Please tell me if you test if this one works.
+  #
+  # @return HTTParty response object.
+  def remove_ip_address ip_address
+    delete "#{ip_address}"
+  end
+
+  # Lists prices for specific components that can be tied to a server.
+  #
+  # @see https://www.upcloud.com/api/1.2.3/4-pricing/ Upcloud’s documentation for more details.
+  #
+  # @return [Array] list of prices per component
+  def prices
+    response = get "price"
+    body = JSON.parse response.body
+    body["prices"]["zone"]
+  end
+
+  # Lists available zones and their details.
+  #
+  # @see https://www.upcloud.com/api/1.2.3/5-zones/ Upcloud’s zone documentation for more details
+  #
+  # @return [Array] list of zones
+  def zones
+    response = get "zone"
+    body = JSON.parse response.body
+    body["zones"]["zone"]
+  end
+
   private
 
   def get(action)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: upcloud_api
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - Samu Voutilainen
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-27 00:00:00.000000000 Z
+date: 2017-05-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -54,7 +54,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
 summary: Implementation of Upcloud API for VPS management