class Fog::Compute::Terremark::Real

documentation stub

doc stub

Public Class Methods

new(options = {}) click to toggle source
# File lib/fog/compute/terremark/real.rb, line 8
def initialize(options = {})
  @terremark_username     = options[:terremark_vcloud_username]
  @terremark_password     = options[:terremark_vcloud_password]
end

Public Instance Methods

add_internet_service(ip_id, name, protocol, port, options = {}) click to toggle source

Reserve requested resources and deploy vApp

Parameters

  • ip_id<~Integer> - Id of ip to add service to

  • name<~String> - Name of service

  • protocol<~String> - Protocol of service

  • port<~Integer> - Port of service

  • options<~Hash>:

    • Enabled<~Boolean>: defaults to true

    • Description<~String>: optional description

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “endTime”<~String> - endTime of task

      • “href”<~String> - link to task

      • “startTime”<~String> - startTime of task

      • “status”<~String> - status of task

      • “type”<~String> - type of task

      • “Owner”<~String> -

        • “href”<~String> - href of owner

        • “name”<~String> - name of owner

        • “type”<~String> - type of owner

# File lib/fog/compute/terremark/requests/add_internet_service.rb, line 28
def add_internet_service(ip_id, name, protocol, port, options = {})
  unless options.key?("Enabled")
    options["Enabled"] = true
  end
  data = <<-DATA
  <CreateInternetServiceRequest xml:lang="en" xmlns="urn:tmrk:vCloudExpressExtensions-1.6" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Name>#{name}</Name>
    <Protocol>#{protocol.upcase}</Protocol>
    <Port>#{port}</Port>
    <Enabled>#{options['Enabled']}</Enabled>
    <Description>#{options['Description']}</Description>
    </CreateInternetServiceRequest>
  DATA
  request(
    :body     => data,
    :expects  => 200,
    :headers  => { "Content-Type" => "application/xml" },
    :method   => "POST",
    :parser   => Fog::Parsers::Terremark::InternetService.new,
    :path     => "api/extensions/v1.6/publicIp/#{ip_id}/internetServices",
    :override_path => true
  )
end
add_node_service(service_id, ip, name, port, options = {}) click to toggle source

Reserve requested resources and deploy vApp

Parameters

  • service_id<~String> - Id of service to add node to

  • ip<~String> - Private ip of server to add to node

  • name<~String> - Name of service

  • port<~Integer> - Port of service

  • options<~Hash>:

    • Enabled<~Boolean>: defaults to true

    • Description<~String>: optional description

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “endTime”<~String> - endTime of task

      • “href”<~String> - link to task

      • “startTime”<~String> - startTime of task

      • “status”<~String> - status of task

      • “type”<~String> - type of task

      • “Owner”<~String> -

        • “href”<~String> - href of owner

        • “name”<~String> - name of owner

        • “type”<~String> - type of owner

# File lib/fog/compute/terremark/requests/add_node_service.rb, line 28
def add_node_service(service_id, ip, name, port, options = {})
  unless options.key?("Enabled")
    options["Enabled"] = true
  end

  data = <<-DATA
        <CreateNodeServiceRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="urn:tmrk:vCloudExpressExtensions-1.6"><IpAddress>#{ip}</IpAddress><Name>#{name}</Name><Port>#{port}</Port><Enabled>#{options['Enabled']}</Enabled><Description>#{options['Description']}</Description></CreateNodeServiceRequest>
  DATA
  response = request(
    :body     => data,
    :expects  => 200,
    :headers  => { "Content-Type" => "application/vnd.tmrk.vCloud.nodeService+xml" },
    :method   => "POST",
    :parser   => Fog::Parsers::Terremark::NodeService.new,
    :path     => "api/extensions/v1.6/internetService/#{service_id}/nodeServices",
    :override_path => true
  )

  response
end
configure_vapp(vapp_id, vapp_name, options = {}) click to toggle source
# File lib/fog/compute/terremark/requests/configure_vapp.rb, line 5
        def configure_vapp(vapp_id, vapp_name, options = {})
          items = ""
          vapp_uri = [@host, @path, "vApp", vapp_id.to_s].join("/")

          if options["vcpus"]
            vcpu_item = <<-DATA
<Item xmlns="http://schemas.dmtf.org/ovf/envelope/1"> <InstanceID xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">1</InstanceID><ResourceType xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">3</ResourceType><VirtualQuantity xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">#{options['vcpus']}</VirtualQuantity></Item>
            DATA
            items << vcpu_item
          end

          if options["memory"]
            memory_item = <<-DATA
<Item xmlns="http://schemas.dmtf.org/ovf/envelope/1"><InstanceID xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">2</InstanceID><ResourceType xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">4</ResourceType>38<VirtualQuantity xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">#{options['memory']}</VirtualQuantity></Item>
            DATA
            items << memory_item
          end
          #Default root disk
          virtual_disk_item = <<-DATA
<Item>
<AddressOnParent xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">0</AddressOnParent> <HostResource xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">1048576</HostResource><InstanceID xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">9</InstanceID><ResourceType xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">17</ResourceType><VirtualQuantity xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">1048576</VirtualQuantity></Item>
          DATA
          items << virtual_disk_item
          #Additional disks
          if options["virtual_disks"]
            options["virtual_disks"].each do |disk|
              actual_size = disk.to_i * 1024 * 1024
              virtual_disk_item = <<-DATA
<Item>
<AddressOnParent xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">-1</AddressOnParent><HostResource xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">#{actual_size}</HostResource><InstanceID xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">9</InstanceID><ResourceType xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">17</ResourceType><VirtualQuantity xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">#{actual_size}</VirtualQuantity></Item>
              DATA
              items << virtual_disk_item
            end
          end

          data = <<-DATA
<VApp href="#{vapp_uri}" type="application/vnd.vmware.vcloud.vApp+xml" name="#{vapp_name}" status="2" size="10485760" xmlns="http://www.vmware.com/vcloud/v0.8" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<VirtualHardwareSection xmlns="http://schemas.dmtf.org/ovf/envelope/1"><Info>Virtual Hardware</Info>#{items}
</VirtualHardwareSection>
</VApp>
          DATA

          request(
            :body => data,
            :expects => 202,
            :headers => { "Content-Type" => "application/vnd.vmware.vCloud.vApp+xml" },
            :method => "PUT",
            :path => "vapp/#{vapp_id}"
          )
        end
create_internet_service(vdc_id, name, protocol, port, options = {}) click to toggle source

Reserve requested resources and deploy vApp

Parameters

  • vdc_id<~Integer> - Id of vDc to add internet service to

  • name<~String> - Name of service

  • protocol<~String> - Protocol of service

  • port<~Integer> - Port of service

  • options<~Hash>:

    • Enabled<~Boolean>: defaults to true

    • Description<~String>: optional description

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “endTime”<~String> - endTime of task

      • “href”<~String> - link to task

      • “startTime”<~String> - startTime of task

      • “status”<~String> - status of task

      • “type”<~String> - type of task

      • “Owner”<~String> -

        • “href”<~String> - href of owner

        • “name”<~String> - name of owner

        • “type”<~String> - type of owner

# File lib/fog/compute/terremark/requests/create_internet_service.rb, line 28
def create_internet_service(vdc_id, name, protocol, port, options = {})
  unless options.key?("Enabled")
    options["Enabled"] = true
  end
  #Sample: "https://services.vcloudexpress.terremark.com/api/extensions/v1.6/vdc/3142/internetServices"
  path = vdcs.get(vdc_id).links.detect { |item| item["name"] == "Internet Services" }["href"].split(@host)[1]
  data = <<-DATA
  <CreateInternetServiceRequest xml:lang="en" xmlns="urn:tmrk:vCloudExpressExtensions-1.6" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Name>#{name}</Name>
    <Protocol>#{protocol.upcase}</Protocol>
    <Port>#{port}</Port>
    <Enabled>#{options['Enabled']}</Enabled>
    <Description>#{options['Description']}</Description>
    </CreateInternetServiceRequest>
  DATA
  response = request(
      :body     => data,
      :expects  => 200,
      :headers  => { "Content-Type" => "application/vnd.tmrk.vCloud.internetService+xml" },
      :method   => "POST",
      :parser   => Fog::Parsers::Terremark::InternetService.new,
      :path     => path,
      :override_path => true
  )
  response
end
delete_internet_service(internet_service_id) click to toggle source

Destroy an internet service

Parameters

  • internet_service_id<~Integer> - Id of service to destroy

# File lib/fog/compute/terremark/requests/delete_internet_service.rb, line 10
def delete_internet_service(internet_service_id)
  request(
    :expects  => 200,
    :method   => "DELETE",
    :path     => "api/extensions/v1.6/internetService/#{internet_service_id}",
    :override_path => true
  )
end
delete_node_service(node_service_id) click to toggle source

Destroy a node

Parameters

  • node_service_id<~Integer> - Id of node to destroy

# File lib/fog/compute/terremark/requests/delete_node_service.rb, line 10
def delete_node_service(node_service_id)
  request(
    :expects  => 200,
    :method   => "DELETE",
    :path     => "api/extensions/v1.6/nodeService/#{node_service_id}",
    :override_path => true
  )
end
delete_public_ip(public_ip_id) click to toggle source

Destroy a public ip

Parameters

  • public_ip_id<~Integer> - Id of public ip to destroy

# File lib/fog/compute/terremark/requests/delete_public_ip.rb, line 10
def delete_public_ip(public_ip_id)
  request(
    :expects  => 200,
    :method   => "DELETE",
    :path     => "api/extensions/v1.6/publicIp/#{public_ip_id}",
    :override_path => true
  )
end
delete_vapp(vapp_id) click to toggle source

Destroy a vapp

Parameters

  • vapp_id<~Integer> - Id of vapp to destroy

# File lib/fog/compute/terremark/requests/delete_vapp.rb, line 10
def delete_vapp(vapp_id)
  request(
    :expects  => 202,
    :method   => "DELETE",
    :path     => "vApp/#{vapp_id}"
  )
end
deploy_vapp(vapp_id) click to toggle source

Reserve requested resources and deploy vApp

Parameters

  • vapp_id<~Integer> - Id of vApp to deploy

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “endTime”<~String> - endTime of task

      • “href”<~String> - link to task

      • “startTime”<~String> - startTime of task

      • “status”<~String> - status of task

      • “type”<~String> - type of task

      • “Owner”<~String> -

        • “href”<~String> - href of owner

        • “name”<~String> - name of owner

        • “type”<~String> - type of owner

# File lib/fog/compute/terremark/requests/deploy_vapp.rb, line 22
def deploy_vapp(vapp_id)
  request(
    :expects  => 202,
    :method   => "POST",
    :parser   => Fog::Parsers::Terremark::Task.new,
    :path     => "vApp/#{vapp_id}/action/deploy"
  )
end
get_catalog(vdc_id) click to toggle source

Get details of a catalog

Parameters

  • vdc_id<~Integer> - Id of vdc to view catalog for

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “CatalogItems”<~Array>

        • “href”<~String> - linke to item

        • “name”<~String> - name of item

        • “type”<~String> - type of item

      • “description”<~String> - Description of catalog

      • “name”<~String> - Name of catalog

# File lib/fog/compute/terremark/requests/get_catalog.rb, line 19
def get_catalog(vdc_id)
  request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::GetCatalog.new,
    :path     => "vdc/#{vdc_id}/catalog"
  )
end
get_catalog_item(catalog_item_id) click to toggle source
  • “CatalogItems”<~Array>

    • “href”<~String> - linke to item

    • “name”<~String> - name of item

    • “type”<~String> - type of item

  • “description”<~String> - Description of catalog

  • “name”<~String> - Name of catalog

# File lib/fog/compute/terremark/requests/get_catalog_item.rb, line 22
def get_catalog_item(catalog_item_id)
  request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::GetCatalogItem.new,
    :path     => "catalogItem/#{catalog_item_id}"
  )
end
get_internet_services(vdc_id) click to toggle source

Get a list of all internet services for a vdc

Parameters

  • vdc_id<~Integer> - Id of vDc to get list of internet services for

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “InternetServices”<~Array>

        • “id”<~String> => id of the internet service

        • “name”<~String> => name of service

        • “PublicIPAddress”<~Hash>

        • “Id”<~String> => id of the public IP

        • “name”<~String> => actual ip address

# File lib/fog/compute/terremark/requests/get_internet_services.rb, line 20
def get_internet_services(vdc_id)
  request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::GetInternetServices.new,
    :path     => "api/extensions/v1.6/vdc/#{vdc_id}/internetServices",
    :override_path => true
  )
end
get_keys_list(organization_id) click to toggle source

Get list of SSH keys for an organization

Parameters

  • organization_id<~Integer> - Id of organization to lookup

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “description”<~String> - Description of organization

      • “links”<~Array> - An array of links to entities in the organization

        • “href”<~String> - location of link

        • “name”<~String> - name of link

        • “rel”<~String> - action to perform

        • “type”<~String> - type of link

# File lib/fog/compute/terremark/requests/get_keys_list.rb, line 19
def get_keys_list(organization_id)
  response = request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::GetKeysList.new,
    :path     => "api/extensions/v1.6/org/#{organization_id}/keys",
    :override_path => true
  )
  response
end
get_network(network_id) click to toggle source

Get details for a Network

Parameters

  • network_id<~Integer> - Id of the network to look up

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

    FIXME

# File lib/fog/compute/terremark/requests/get_network.rb, line 14
def get_network(network_id)
  request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::Network.new,
    :path     => "network/#{network_id}"
  )
end
get_network_ips(network_id) click to toggle source

Get details for a Network

Parameters

  • network_id<~Integer> - Id of the network to look up

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

    FIXME

# File lib/fog/compute/terremark/requests/get_network_ips.rb, line 14
def get_network_ips(network_id)
  opts =  {
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::GetNetworkIps.new,
    :path     => "network/#{network_id}/ipAddresses"
  }
  if self.is_a?(Fog::Terremark::Ecloud::Real)
    opts[:path] = "/extensions/network/#{network_id}/ips"
  end
  request(opts)
end
get_node_services(service_id) click to toggle source
# File lib/fog/compute/terremark/requests/get_node_services.rb, line 15
def get_node_services(service_id)
  request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::GetNodeServices.new,
    :path     => "api/extensions/v1.6/internetService/#{service_id}/nodeServices",
    :override_path => true
  )
end
get_organization(organization_id) click to toggle source

Get details of an organization

Parameters

  • organization_id<~Integer> - Id of organization to lookup

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “description”<~String> - Description of organization

      • “links”<~Array> - An array of links to entities in the organization

        • “href”<~String> - location of link

        • “name”<~String> - name of link

        • “rel”<~String> - action to perform

        • “type”<~String> - type of link

      • “name”<~String> - Name of organization

# File lib/fog/compute/terremark/requests/get_organization.rb, line 20
def get_organization(organization_id)
  response = request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::GetOrganization.new,
    :path     => "org/#{organization_id}"
  )
  response
end
get_public_ip(public_ip_id) click to toggle source

Get details for a public ip

Parameters

  • public_ip_id<~Integer> - Id of public ip to look up

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “PublicIpAddresses”<~Array>

        • “href”<~String> - linke to item

        • “name”<~String> - name of item

# File lib/fog/compute/terremark/requests/get_public_ip.rb, line 16
def get_public_ip(public_ip_id)
  opts = {
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::PublicIp.new,
    :path     => "publicIps/#{public_ip_id}"
  }
  if self.class == Fog::Terremark::Ecloud::Real
    opts[:path] = "extensions/publicIp/#{public_ip_id}"
  end
  request(opts)
end
get_public_ips(vdc_id) click to toggle source

Get list of public ips

Parameters

  • vdc_id<~Integer> - Id of vdc to find public ips for

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “PublicIpAddresses”<~Array>

        • “href”<~String> - link to item

        • “name”<~String> - name of item

# File lib/fog/compute/terremark/requests/get_public_ips.rb, line 16
def get_public_ips(vdc_id)
  opts = {
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::GetPublicIps.new,
    :path     => "vdc/#{vdc_id}/publicIps"
  }
  if self.class == Fog::Terremark::Ecloud::Real
    opts[:path] = "extensions/vdc/#{vdc_id}/publicIps"
  end
  request(opts)
end
get_task(task_id) click to toggle source

Get details of a task

Parameters

  • task_id<~Integer> - Id of task to lookup

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “endTime”<~String> - endTime of task

      • “href”<~String> - link to task

      • “startTime”<~String> - startTime of task

      • “status”<~String> - status of task

      • “type”<~String> - type of task

      • “Owner”<~String> -

        • “href”<~String> - href of owner

        • “name”<~String> - name of owner

        • “type”<~String> - type of owner

      • “Result”<~String> -

        • “href”<~String> - href of result

        • “name”<~String> - name of result

        • “type”<~String> - type of result

# File lib/fog/compute/terremark/requests/get_task.rb, line 26
def get_task(task_id)
  request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::Task.new,
    :path     => "task/#{task_id}"
  )
end
get_tasks_list(tasks_list_id) click to toggle source

Get list of tasks

Parameters

  • tasks_list_id<~Integer> - Id of tasks lists to view

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “CatalogItems”<~Array>

        • “href”<~String> - linke to item

        • “name”<~String> - name of item

        • “type”<~String> - type of item

      • “description”<~String> - Description of catalog

      • “name”<~String> - Name of catalog

# File lib/fog/compute/terremark/requests/get_tasks_list.rb, line 19
def get_tasks_list(tasks_list_id)
  request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::GetTasksList.new,
    :path     => "tasksList/#{tasks_list_id}"
  )
end
get_vapp(vapp_id) click to toggle source
  • “endTime”<~String> - endTime of task

  • “href”<~String> - link to task

  • “startTime”<~String> - startTime of task

  • “status”<~String> - status of task

  • “type”<~String> - type of task

  • “Owner”<~String> -

    • “href”<~String> - href of owner

    • “name”<~String> - name of owner

    • “type”<~String> - type of owner

  • “Result”<~String> -

    • “href”<~String> - href of result

    • “name”<~String> - name of result

    • “type”<~String> - type of result

# File lib/fog/compute/terremark/requests/get_vapp.rb, line 29
def get_vapp(vapp_id)
  request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::Vapp.new,
    :path     => "vapp/#{vapp_id}"
  )
end
get_vapp_template(vapp_template_id) click to toggle source
  • “CatalogItems”<~Array>

    • “href”<~String> - linke to item

    • “name”<~String> - name of item

    • “type”<~String> - type of item

  • “description”<~String> - Description of catalog

  • “name”<~String> - Name of catalog

# File lib/fog/compute/terremark/requests/get_vapp_template.rb, line 22
def get_vapp_template(vapp_template_id)
  request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::GetVappTemplate.new,
    :path     => "vAppTemplate/#{vapp_template_id}"
  )
end
get_vdc(vdc_id) click to toggle source
  • “CatalogItems”<~Array>

    • “href”<~String> - linke to item

    • “name”<~String> - name of item

    • “type”<~String> - type of item

  • “description”<~String> - Description of catalog

  • “name”<~String> - Name of catalog

# File lib/fog/compute/terremark/requests/get_vdc.rb, line 22
def get_vdc(vdc_id)
  request(
    :expects  => 200,
    :method   => "GET",
    :parser   => Fog::Parsers::Terremark::GetVdc.new,
    :path     => "vdc/#{vdc_id}"
  )
end
instantiate_vapp_template(name, vapp_template, options = {}) click to toggle source

Instatiate a vapp template

Parameters

  • name<~String>: Name of the resulting vapp .. must start with letter, up to 15 chars alphanumeric.

  • options<~Hash>:

  • cpus<~Integer>: Number of cpus in [1, 2, 4, 8], defaults to 1

  • memory<~Integer>: Amount of memory either 512 or a multiple of 1024, defaults to 512

  • vapp_template<~String>: id of the vapp template to be instantiated

Returns

  • response<~Excon::Response>:

  • body<~Hash>:

  • “Links;<~Array> (e.g. up to vdc)

  • “href”<~String> Link to the resulting vapp

  • “name”<~String> - name of item

  • “type”<~String> - type of item

  • “status”<~String> - 0(pending) –> 2(off) –>4(on)

# File lib/fog/compute/terremark/requests/instantiate_vapp_template.rb, line 21
        def instantiate_vapp_template(name, vapp_template, options = {})
          raise ArgumentError.new("Name must be fewer than 15 characters") unless name.length < 15
          raise ArgumentError.new("vApp Image Template is a compulsary parameter") unless vapp_template
          options["ssh_key_fingerprint"] ||= default_ssh_key["FingerPrint"]
          options["cpus"] ||= 1
          options["memory"] ||= 512
          options["network_id"] ||= default_network_id
          options["vdc_id"] ||= default_vdc_id
          options["primary_dns"] ||= "208.67.222.222"
          options["secondary_dns"] ||= "208.67.220.220"

          data = <<-DATA
<?xml version="1.0" encoding="UTF-8"?>
<InstantiateVAppTemplateParams name="#{name}" xmlns="http://www.vmware.com/vcloud/v0.8" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.vmware.com/vcloud/v0.8 http://services.vcloudexpress.terremark.com/api/v0.8/ns/vcloud.xsd">
  <VAppTemplate href="#{@scheme}://#{@host}/#{@path}/vAppTemplate/#{vapp_template}" />
  <InstantiationParams xmlns:vmw="http://www.vmware.com/schema/ovf">
    <ProductSection xmlns:ovf="http://schemas.dmtf.org/ovf/envelope/1" xmlns:q1="http://www.vmware.com/vcloud/v0.8">
    <Property xmlns="http://schemas.dmtf.org/ovf/envelope/1" ovf:key="primaryDNS" ovf:value="#{options['primary_dns']}" />
    <Property xmlns="http://schemas.dmtf.org/ovf/envelope/1" ovf:key="secondaryDNS" ovf:value="#{options['secondary_dns']}" />
    <Property xmlns="http://schemas.dmtf.org/ovf/envelope/1" ovf:key="sshKeyFingerprint" ovf:value="#{options['ssh_key_fingerprint']}" />
    </ProductSection>
    <VirtualHardwareSection xmlns:q1="http://www.vmware.com/vcloud/v0.8">
      <Item xmlns="http://schemas.dmtf.org/ovf/envelope/1">
        <InstanceID xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">1</InstanceID>
        <ResourceType xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">3</ResourceType>
        <VirtualQuantity xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">#{options['cpus']}</VirtualQuantity>
      </Item>
      <Item xmlns="http://schemas.dmtf.org/ovf/envelope/1">
        <InstanceID xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">2</InstanceID>
        <ResourceType xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">4</ResourceType>
        <VirtualQuantity xmlns="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData">#{options['memory']}</VirtualQuantity>
      </Item>
    </VirtualHardwareSection>
    <NetworkConfigSection>
      <NetworkConfig>
        <NetworkAssociation href="#{@scheme}://#{@host}/#{@path}/network/#{options['network_id']}"/>
      </NetworkConfig>
    </NetworkConfigSection>
  </InstantiationParams>
</InstantiateVAppTemplateParams>
          DATA

          request(
              :body => data,
              :expects => 200,
              :headers => { "Content-Type" => "application/vnd.vmware.vcloud.instantiateVAppTemplateParams+xml" },
              :method => "POST",
              :parser => Fog::Parsers::Terremark::InstantiateVappTemplate.new,
              :path => "vdc/#{options['vdc_id']}/action/instantiatevAppTemplate"
          )
        end
organizations() click to toggle source

Get list of organizations

Returns

  • response<~Excon::Response>:

    • body<~Array>:

      • “description”<~String> - Description of organization

      • “links”<~Array> - An array of links to entities in the organization

      • “name”<~String> - Name of organization

# File lib/fog/compute/terremark/requests/get_organizations.rb, line 14
def organizations
  request(
    :expects => 200,
    :headers => auth_headers,
    :method => "POST",
    :parser => Fog::Parsers::Terremark::GetOrganizations.new,
    :path => "login"
  )
end
power_off(vapp_id) click to toggle source

Power off a vapp

Parameters

  • vapp_id<~Integer> - Id of vapp to power off

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “endTime”<~String> - endTime of task

      • “href”<~String> - link to task

      • “startTime”<~String> - startTime of task

      • “status”<~String> - status of task

      • “type”<~String> - type of task

      • “Owner”<~String> -

        • “href”<~String> - href of owner

        • “name”<~String> - name of owner

        • “type”<~String> - type of owner

# File lib/fog/compute/terremark/requests/power_off.rb, line 22
def power_off(vapp_id)
  request(
    :expects  => 202,
    :method   => "POST",
    :parser   => Fog::Parsers::Terremark::Task.new,
    :path     => "vApp/#{vapp_id}/power/action/powerOff"
  )
end
power_on(vapp_id) click to toggle source

Power on a vapp

Parameters

  • vapp_id<~Integer> - Id of vapp to power on

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “endTime”<~String> - endTime of task

      • “href”<~String> - link to task

      • “startTime”<~String> - startTime of task

      • “status”<~String> - status of task

      • “type”<~String> - type of task

      • “Owner”<~String> -

        • “href”<~String> - href of owner

        • “name”<~String> - name of owner

        • “type”<~String> - type of owner

# File lib/fog/compute/terremark/requests/power_on.rb, line 22
def power_on(vapp_id)
  request(
    :expects  => 202,
    :method   => "POST",
    :parser   => Fog::Parsers::Terremark::Task.new,
    :path     => "vApp/#{vapp_id}/power/action/powerOn"
  )
end
power_reset(vapp_id) click to toggle source

Reset a vapp

Parameters

  • vapp_id<~Integer> - Id of vapp to reset

Returns

  • response<~Excon::Response>:

    • body<~Hash>:

      • “endTime”<~String> - endTime of task

      • “href”<~String> - link to task

      • “startTime”<~String> - startTime of task

      • “status”<~String> - status of task

      • “type”<~String> - type of task

      • “Owner”<~String> -

        • “href”<~String> - href of owner

        • “name”<~String> - name of owner

        • “type”<~String> - type of owner

# File lib/fog/compute/terremark/requests/power_reset.rb, line 22
def power_reset(vapp_id)
  request(
    :expects  => 202,
    :method   => "POST",
    :parser   => Fog::Parsers::Terremark::Task.new,
    :path     => "vApp/#{vapp_id}/power/action/reset"
  )
end
power_shutdown(vapp_id) click to toggle source

Shutdown a vapp

Parameters

  • vapp_id<~Integer> - Id of vapp to shutdown

Returns

Nothing

# File lib/fog/compute/terremark/requests/power_shutdown.rb, line 12
def power_shutdown(vapp_id)
  request(
    :expects  => 204,
    :method   => "POST",
    :path     => "vApp/#{vapp_id}/power/action/shutdown"
  )
end

Private Instance Methods

auth_headers() click to toggle source
# File lib/fog/compute/terremark/real.rb, line 27
def auth_headers
  credentials = "#{@terremark_username}:#{@terremark_password}"
  encoded_credentials = Base64.encode64(credentials)
  # remove newlines because strict_encode64 is not compatible with 1.8
  encoded_credentials = encoded_credentials.gsub(/\n/, "")
  {
    "Authorization" => "Basic #{encoded_credentials}",
    # Terremark said they're going to remove passing in the
    # Content-Type to login in a future release
    "Content-Type"  => "application/vnd.vmware.vcloud.orgList+xml"
  }
end
auth_token() click to toggle source
# File lib/fog/compute/terremark/real.rb, line 15
def auth_token
  response = @connection.request(
      :expects   => 200,
      :headers   => auth_headers,
      :host      => @host,
      :method    => "POST",
      :parser    => Fog::Parsers::Terremark::GetOrganizations.new,
      :path      => "#{@path}/login"
  )
  response.headers["Set-Cookie"]
end
do_request(params) click to toggle source
# File lib/fog/compute/terremark/real.rb, line 54
def do_request(params)
  @connection.request(
    :body     => params[:body],
    :expects  => params[:expects],
    :headers  => make_headers(params),
    :host     => @host,
    :method   => params[:method],
    :parser   => params[:parser],
    :path     => make_path(params)
  )
end
make_headers(params) click to toggle source
# File lib/fog/compute/terremark/real.rb, line 66
def make_headers(params)
  headers = {}
  headers.merge!("Cookie" => @cookie) if @cookie
  headers.merge!(params[:headers] || {})
end
make_path(params) click to toggle source
# File lib/fog/compute/terremark/real.rb, line 72
def make_path(params)
  if params[:path]
    if params[:override_path] == true
      params[:path]
    else
      "#{@path}/#{params[:path]}"
    end
  else
    "#{@path}"
  end
end
reload() click to toggle source
# File lib/fog/compute/terremark/real.rb, line 40
def reload
  @connection.reset
end
request(params) click to toggle source
# File lib/fog/compute/terremark/real.rb, line 44
def request(params)
  @cookie ||= auth_token
  begin
    do_request(params)
  rescue Excon::Errors::Unauthorized
    @cookie = auth_token
    do_request(params)
  end
end