mtncloud-cli 1.0.0

data/lib/mtncloud/api/storage_volumes_interface.rb

@@ -0,0 +1,24 @@
+require 'mtncloud/api/rest_interface'
+
+class MtnCloud::StorageVolumesInterface < MtnCloud::RestInterface
+
+  def base_path
+    "/api/storage-volumes"
+  end
+
+  def resize(id,payload)
+    url = "#{@base_url}/api/storage-volumes/#{id}/resize"
+    headers = { :params => {},:authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  # Transfer ownership of a storage volume to another tenant.
+  # The server expects { "storageVolume": { "tenant": { "id": <id> } } }
+  # and handles all authorization and business-rule validation.
+  def update_tenant(id, payload, params={}, headers={})
+    validate_id!(id)
+    execute(method: :put, url: "#{base_path}/#{CGI::escape(id.to_s)}", params: params, payload: payload, headers: headers)
+  end
+
+end

data/lib/mtncloud/api/subnet_types_interface.rb

@@ -0,0 +1,20 @@
+require 'mtncloud/api/api_client'
+
+class MtnCloud::SubnetTypesInterface < MtnCloud::APIClient
+
+  def get(id, params={})
+    raise "#{self.class}.get() passed a blank id!" if id.to_s == ''
+    url = "#{@base_url}/api/subnet-types/#{id}"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+  def list(params={})
+    url = "#{@base_url}/api/subnet-types"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+end

data/lib/mtncloud/api/subnets_interface.rb

@@ -0,0 +1,41 @@
+require 'mtncloud/api/api_client'
+
+class MtnCloud::SubnetsInterface < MtnCloud::APIClient
+
+  def get(id, params={})
+    raise "#{self.class}.get() passed a blank id!" if id.to_s == ''
+    url = "#{@base_url}/api/subnets/#{id}"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+  def list(params={})
+    url = "#{@base_url}/api/subnets"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+  def create(network_id, payload)
+    url = "#{@base_url}/api/networks/#{network_id}/subnets"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :post, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def update(id, payload)
+    url = "#{@base_url}/api/subnets/#{id}"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def destroy(id, params={})
+    url = "#{@base_url}/api/subnets/#{id}"
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :delete, url: url, headers: headers}
+    execute(opts)
+  end
+
+end

data/lib/mtncloud/api/support_bundles_interface.rb

@@ -0,0 +1,46 @@
+require 'mtncloud/api/rest_interface'
+
+class MtnCloud::SupportBundlesInterface < MtnCloud::RestInterface
+
+  def base_path
+    "/api/support-bundles"
+  end
+
+  # Download uses chunked streaming to write directly to a file.
+  # Follows the same pattern as file_copy_request_interface.rb#download_file_chunked.
+  def download(id, outfile, params={})
+    raise "#{self.class}.download() passed a blank id!" if id.to_s == ''
+    url = "#{base_path}/#{CGI::escape(id.to_s)}/download"
+    headers = { params: params }
+    opts = {method: :get, url: url, headers: headers, parse_json: false}
+    if Dir.exist?(outfile)
+      raise "outfile is invalid. It is the name of an existing directory: #{outfile}"
+    end
+    if @dry_run
+      return execute(opts)
+    end
+    http_response = nil
+    begin
+      File.open(outfile, 'w') {|f|
+        block = proc { |response|
+          response.read_body do |chunk|
+            f.write chunk
+          end
+        }
+        opts[:block_response] = block
+        http_response = execute(opts)
+      }
+    rescue
+      if File.exist?(outfile) && File.file?(outfile)
+        File.delete(outfile)
+      end
+      raise
+    end
+    return http_response
+  end
+
+  def cancel(id, payload={}, params={}, headers={})
+    execute(method: :post, url: "#{base_path}/#{CGI::escape(id.to_s)}/cancel", params: params, payload: payload, headers: headers)
+  end
+
+end

data/lib/mtncloud/api/system_types_interface.rb

@@ -0,0 +1,13 @@
+require 'mtncloud/api/rest_interface'
+
+class MtnCloud::SystemTypesInterface < MtnCloud::RestInterface
+
+  def base_path
+    "/api/infrastructure/system-types"
+  end
+
+  def list_layouts(type_id, params = {})
+    execute(method: :get, url: "#{base_path}/#{type_id}/layouts", params: params)
+  end
+
+end

data/lib/mtncloud/api/systems_interface.rb

@@ -0,0 +1,55 @@
+require 'mtncloud/api/rest_interface'
+
+class MtnCloud::SystemsInterface < MtnCloud::RestInterface
+
+  def base_path
+    "/api/infrastructure/systems"
+  end
+
+  def save_uninitialized(payload, params={}, headers={})
+    execute(method: :post, url: "#{base_path}/uninitialized", params: params, payload: payload, headers: headers)
+  end
+
+  def initialize_system(id, payload={}, params={}, headers={})
+    validate_id!(id)
+    execute(method: :put, url: "#{base_path}/#{CGI::escape(id.to_s)}/initialize", params: params, payload: payload, headers: headers)
+  end
+
+  def validate_system(id, params={}, headers={})
+    validate_id!(id)
+    execute(method: :get, url: "#{base_path}/#{CGI::escape(id.to_s)}/validate", params: params, headers: headers)
+  end
+
+  def list_compute_server_update_definitions(system_id, server_id, params={}, headers={})
+    execute(method: :get, url: "#{base_path}/#{CGI::escape(system_id.to_s)}/servers/#{CGI::escape(server_id.to_s)}/update-definitions", params: params, headers: headers)
+  end
+
+  def apply_compute_server_update_definition(system_id, server_id, update_definition_id, payload={}, params={}, headers={})
+    execute(method: :post, url: "#{base_path}/#{CGI::escape(system_id.to_s)}/servers/#{CGI::escape(server_id.to_s)}/update-definitions/#{CGI::escape(update_definition_id.to_s)}", params: params, payload: payload, headers: headers)
+  end
+
+  def list_storage_server_update_definitions(system_id, server_id, params={}, headers={})
+    execute(method: :get, url: "#{base_path}/#{CGI::escape(system_id.to_s)}/storage-servers/#{CGI::escape(server_id.to_s)}/update-definitions", params: params, headers: headers)
+  end
+
+  def apply_storage_server_update_definition(system_id, server_id, update_definition_id, payload={}, params={}, headers={})
+    execute(method: :post, url: "#{base_path}/#{CGI::escape(system_id.to_s)}/storage-servers/#{CGI::escape(server_id.to_s)}/update-definitions/#{CGI::escape(update_definition_id.to_s)}", params: params, payload: payload, headers: headers)
+  end
+
+  def list_network_server_update_definitions(system_id, server_id, params={}, headers={})
+    execute(method: :get, url: "#{base_path}/#{CGI::escape(system_id.to_s)}/network-servers/#{CGI::escape(server_id.to_s)}/update-definitions", params: params, headers: headers)
+  end
+
+  def apply_network_server_update_definition(system_id, server_id, update_definition_id, payload={}, params={}, headers={})
+    execute(method: :post, url: "#{base_path}/#{CGI::escape(system_id.to_s)}/network-servers/#{CGI::escape(server_id.to_s)}/update-definitions/#{CGI::escape(update_definition_id.to_s)}", params: params, payload: payload, headers: headers)
+  end
+
+  def list_cluster_update_definitions(system_id, cluster_id, params={}, headers={})
+    execute(method: :get, url: "#{base_path}/#{CGI::escape(system_id.to_s)}/clusters/#{CGI::escape(cluster_id.to_s)}/update-definitions", params: params, headers: headers)
+  end
+
+  def apply_cluster_update_definition(system_id, cluster_id, update_definition_id, payload={}, params={}, headers={})
+    execute(method: :post, url: "#{base_path}/#{CGI::escape(system_id.to_s)}/clusters/#{CGI::escape(cluster_id.to_s)}/update-definitions/#{CGI::escape(update_definition_id.to_s)}", params: params, payload: payload, headers: headers)
+  end
+
+end

data/lib/mtncloud/api/task_sets_interface.rb

@@ -0,0 +1,52 @@
+require 'mtncloud/api/api_client'
+
+class MtnCloud::TaskSetsInterface < MtnCloud::APIClient
+
+  def list(params={})
+    url = "#{@base_url}/api/task-sets"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+  def get(options=nil)
+    url = "#{@base_url}/api/task-sets"
+    headers = { params: {}, authorization: "Bearer #{@access_token}" }
+    if options.is_a?(Hash)
+      headers[:params].merge!(options)
+    elsif options.is_a?(Numeric)
+      url = "#{@base_url}/api/task-sets/#{options}"
+    elsif options.is_a?(String)
+      headers[:params]['name'] = options
+    end
+    execute(method: :get, url: url, headers: headers)
+  end
+
+  def create(options)
+    url = "#{@base_url}/api/task-sets"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    execute(method: :post, url: url, headers: headers, payload: payload.to_json)
+  end
+
+  def update(id, options)
+    url = "#{@base_url}/api/task-sets/#{id}"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    execute(method: :put, url: url, headers: headers, payload: payload.to_json)
+  end
+
+  def destroy(id)
+    url = "#{@base_url}/api/task-sets/#{id}"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    execute(method: :delete, url: url, headers: headers)
+  end
+
+  def run(id, options)
+    url = "#{@base_url}/api/task-sets/#{id}/execute"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    execute(method: :post, url: url, headers: headers, payload: payload.to_json)
+  end
+
+end

data/lib/mtncloud/api/tasks_interface.rb

@@ -0,0 +1,66 @@
+require 'mtncloud/api/api_client'
+
+class MtnCloud::TasksInterface < MtnCloud::APIClient
+
+  def list(params={})
+    url = "#{@base_url}/api/tasks"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+  def get(options=nil)
+    url = "#{@base_url}/api/tasks"
+    headers = { params: {}, authorization: "Bearer #{@access_token}" }
+
+    if options.is_a?(Hash)
+      headers[:params].merge!(options)
+    elsif options.is_a?(Numeric)
+      url = "#{@base_url}/api/tasks/#{options}"
+    elsif options.is_a?(String)
+      headers[:params]['name'] = options
+    end
+    execute(method: :get, url: url, headers: headers)
+  end
+
+  def update(id, options)
+    url = "#{@base_url}/api/tasks/#{id}"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    execute(method: :put, url: url, headers: headers, payload: payload.to_json)
+  end
+
+
+  def create(options)
+    url = "#{@base_url}/api/tasks"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    execute(method: :post, url: url, headers: headers, payload: payload.to_json)
+  end
+
+  def destroy(id, params={})
+    url = "#{@base_url}/api/tasks/#{id}"
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    execute(method: :delete, url: url, headers: headers)
+  end
+
+  def run(id, options)
+    url = "#{@base_url}/api/tasks/#{id}/execute"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    execute(method: :post, url: url, headers: headers, payload: payload.to_json)
+  end
+
+  def list_types(params={})
+    url = "#{@base_url}/api/task-types"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    execute(method: :get, url: url, headers: headers)
+  end
+
+  def get_type(id, params={})
+    url = "#{@base_url}/api/task-types/#{id}"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    execute(method: :get, url: url, headers: headers)
+  end
+
+end

data/lib/mtncloud/api/tokens_interface.rb

@@ -0,0 +1,39 @@
+require 'mtncloud/api/api_client'
+
+class MtnCloud::TokensInterface < MtnCloud::APIClient
+
+  def base_path
+    "/api/tokens"
+  end
+
+  def list(params={}, headers={})
+    execute(method: :get, url: "#{base_path}", params: params, headers: headers)
+  end
+
+  def get(id, params={}, headers={})
+    validate_id!(id)
+    execute(method: :get, url: "#{base_path}/#{id}", params: params, headers: headers)
+  end
+
+  def create(payload, params={})
+    execute(method: :post, url: "#{base_path}", payload: payload, params: params)
+  end
+
+  # def update(id, payload, params={})
+  #   execute(method: :put, url: "#{base_path}/#{id}", params: params, headers: headers)
+  # end
+
+  def destroy(id, params={})
+    validate_id!(id)
+    execute(method: :delete, url: "#{base_path}/#{id}", params: params)
+  end
+  
+  def destroy_all(params={})
+    execute(method: :delete, url: "#{base_path}", params: params)
+  end
+
+  def available_clients(params={})
+    execute(method: :get, url: "#{base_path}/api-clients", params: params)
+  end
+
+end

data/lib/mtncloud/api/usage_interface.rb

@@ -0,0 +1,18 @@
+require 'mtncloud/api/api_client'
+
+class MtnCloud::UsageInterface < MtnCloud::APIClient
+
+  def base_path
+    "/api/usage" # not /usages ?
+  end
+
+  def list(params={})
+    execute(method: :get, url: "#{base_path}", params: params)
+  end
+
+  def get(id, params={})
+    validate_id!(id)
+    execute(method: :get, url: "#{base_path}/#{id}", params: params)
+  end
+
+end

data/lib/mtncloud/api/user_groups_interface.rb

@@ -0,0 +1,59 @@
+require 'mtncloud/api/api_client'
+
+class MtnCloud::UserGroupsInterface < MtnCloud::APIClient
+
+  def get(account_id, id)
+    raise "#{self.class}.get() passed a blank id!" if id.to_s == ''
+    url = build_url(account_id, id)
+    headers = { params: {}, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, timeout: 10, headers: headers}
+    execute(opts)
+  end
+
+  def list(account_id, options={})
+    url = build_url(account_id)
+    headers = { params: {}, authorization: "Bearer #{@access_token}" }
+    headers[:params].merge!(options)
+    opts = {method: :get, url: url, timeout: 10, headers: headers}
+    execute(opts)
+  end
+
+  def create(account_id, options)
+    url = build_url(account_id)
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    opts = {method: :post, url: url, timeout: 10, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def update(account_id, id, options)
+    url = build_url(account_id, id)
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    opts = {method: :put, url: url, timeout: 10, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def destroy(account_id, id)
+    url = build_url(account_id, id)
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :delete, url: url, timeout: 10, headers: headers}
+    execute(opts)
+  end
+
+  private
+
+  def build_url(account_id=nil, user_id=nil)
+    url = "#{@base_url}/api"
+    if account_id
+      url += "/accounts/#{account_id}/user-groups"
+    else
+      url += "/user-groups"
+    end
+    if user_id
+      url += "/#{user_id}"
+    end
+    url
+  end
+
+end

data/lib/mtncloud/api/user_settings_interface.rb

@@ -0,0 +1,90 @@
+require 'mtncloud/api/api_client'
+
+class MtnCloud::UserSettingsInterface < MtnCloud::APIClient
+
+  def base_path
+    "/api/user-settings"
+  end
+
+  def get(params={}, headers={})
+    execute(method: :get, url: "#{base_path}", params: params, headers: headers)
+  end
+
+  def update(payload, params={}, headers={})
+    execute(method: :put, url: "#{base_path}", params: params, payload: payload, headers: headers)
+  end
+
+  # download file as attachment
+  def download_avatar(params, outfile)
+    url = "#{base_path}/avatar"
+    headers = { :params => params, :authorization => "Bearer #{@access_token}"}
+    opts = {method: :get, url: url, headers: headers, payload: payload}
+    execute(opts)
+  end
+
+  # multipart file upload
+  def update_avatar(avatar_file, params={})
+    url = "#{base_path}/avatar"
+    headers = { :params => params, :authorization => "Bearer #{@access_token}"}
+    payload = {}
+    #payload['user'] ||= {}
+    #payload['user']['avatar'] = avatar_file
+    payload['user.avatar'] = avatar_file
+    payload[:multipart] = true
+    opts = {method: :post, url: url, headers: headers, payload: payload}
+    execute(opts)
+  end
+
+  def remove_avatar(params={})
+    url = "#{base_path}/avatar"
+    headers = { :params => params, :authorization => "Bearer #{@access_token}"}
+    # POST empty payload will do
+    payload = {}
+    opts = {method: :delete, url: url, headers: headers, payload: payload}
+    execute(opts)
+  end
+
+  # multipart file upload
+  def update_desktop_background(desktop_background_file, params={})
+    url = "#{base_path}/desktop-background"
+    headers = { :params => params, :authorization => "Bearer #{@access_token}"}
+    payload = {}
+    #payload['user'] ||= {}
+    #payload['user']['desktopBackground'] = desktop_background_file
+    payload['user.desktopBackground'] = desktop_background_file
+    payload[:multipart] = true
+    opts = {method: :post, url: url, headers: headers, payload: payload}
+    execute(opts)
+  end
+
+  def remove_desktop_background(params={})
+    url = "#{base_path}/desktop-background"
+    headers = { :params => params, :authorization => "Bearer #{@access_token}"}
+    # POST empty payload will do
+    payload = {}
+    opts = {method: :delete, url: url, headers: headers, payload: payload}
+    execute(opts)
+  end
+
+  def regenerate_access_token(params, payload={})
+    url = "#{base_path}/regenerate-access-token"
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json'}
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def clear_access_token(params, payload={})
+    url = "#{base_path}/clear-access-token"
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json'}
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def available_clients(params={})
+    url = "#{base_path}/api-clients"
+    headers = { :params => params, authorization: "Bearer #{@access_token}"}
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+end

data/lib/mtncloud/api/user_sources_interface.rb

@@ -0,0 +1,99 @@
+require 'mtncloud/api/api_client'
+
+class MtnCloud::UserSourcesInterface < MtnCloud::APIClient
+
+  def get(account_id, id)
+    raise "#{self.class}.get() passed a blank id!" if id.to_s == ''
+    url = build_url(account_id, id)
+    headers = { params: {}, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, timeout: 10, headers: headers}
+    execute(opts)
+  end
+
+  def list(account_id, options={})
+    url = build_url(account_id)
+    headers = { params: {}, authorization: "Bearer #{@access_token}" }
+    headers[:params].merge!(options)
+    opts = {method: :get, url: url, timeout: 10, headers: headers}
+    execute(opts)
+  end
+
+  def create(account_id, options)
+    url = build_url(account_id)
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    opts = {method: :post, url: url, timeout: 10, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def update(account_id, id, options)
+    url = build_url(account_id, id)
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    opts = {method: :put, url: url, timeout: 10, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def destroy(account_id, id)
+    url = build_url(account_id, id)
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :delete, url: url, timeout: 10, headers: headers}
+    execute(opts)
+  end
+
+  def activate(account_id, id, options)
+    url = build_url(account_id, id) + "/activate"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    opts = {method: :put, url: url, timeout: 10, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def deactivate(account_id, id, options)
+    url = build_url(account_id, id) + "/deactivate"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    opts = {method: :put, url: url, timeout: 10, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def update_subdomain(account_id, id, options)
+    url = build_url(account_id, id) + "/subdomain"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    opts = {method: :put, url: url, timeout: 10, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  # move me to my own interface class
+  def list_types(params={})
+    url = "#{@base_url}/api/user-source-types"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, timeout: 10, headers: headers}
+    execute(opts)
+  end
+
+  # move me to my own interface class
+  def get_type(id, params={})
+    url = "#{@base_url}/api/user-source-types/#{id}"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, timeout: 10, headers: headers}
+    execute(opts)
+  end
+
+  private
+
+  def build_url(account_id=nil, user_id=nil)
+    url = "#{@base_url}/api"
+    if account_id
+      url += "/accounts/#{account_id}/user-sources"
+    else
+      url += "/user-sources"
+    end
+    if user_id
+      url += "/#{user_id}"
+    end
+    url
+  end
+
+end

data/lib/mtncloud/api/users_interface.rb

@@ -0,0 +1,33 @@
+require 'mtncloud/api/rest_interface'
+
+class MtnCloud::UsersInterface < MtnCloud::RestInterface
+
+  def base_path
+    "/api/users"
+  end
+
+  def feature_permissions(id, params={}, headers={})
+    validate_id!(id)
+    execute(method: :get, url: "#{base_path}/#{id}/feature-permissions", params: params, headers: headers)
+  end
+
+  def permissions(id, params={}, headers={})
+    validate_id!(id)
+    execute(method: :get, url: "#{base_path}/#{id}/permissions", params: params, headers: headers)
+  end
+
+  def available_roles(id=nil, params={}, headers={})
+    execute(method: :get, url: "#{build_url(id)}/available-roles", params: params, headers: headers)
+  end
+
+  private
+
+  def build_url(id=nil)
+    url = base_path
+    if id
+      url += "/#{id}"
+    end
+    url
+  end
+
+end

data/lib/mtncloud/api/vdi_allocations_interface.rb

@@ -0,0 +1,9 @@
+require 'mtncloud/api/read_interface'
+
+class MtnCloud::VdiAllocationsInterface < MtnCloud::ReadInterface
+
+  def base_path
+    "/api/vdi-allocations"
+  end
+
+end