fog-maestrodev 1.15.0.20130829165835 → 1.15.0.20130927082724

data/lib/fog/rackspace/requests/monitoring/list_overview.rb

@@ -11,8 +11,104 @@ module Fog
             :query    => options
           )
         end
-
       end
+
+      class Mock
+        def list_overview(options={})
+
+          alarm_id   = Fog::Mock.random_letters(10)
+          check_id   = Fog::Mock.random_letters(10)
+          entity_id  = Fog::Mock.random_letters(10)
+          account_id = Fog::Mock.random_numbers(6).to_s
+          server_id  = Fog::Rackspace::MockData.uuid
+
+          response = Excon::Response.new
+          response.status = 200
+          response.body = {
+            "values" => [
+              {
+                "entity" => {
+                  "id"           => entity_id,
+                  "label"        => "mock_entity",
+                  "ip_addresses" => { 
+                    "access_ip0_v6" => Fog::Rackspace::MockData.ipv6_address,
+                    "public0_v4"    => Fog::Rackspace::MockData.ipv4_address,
+                    "public1_v6"    => Fog::Rackspace::MockData.ipv6_address,
+                    "access_ip1_v4" => Fog::Rackspace::MockData.ipv4_address,
+                    "private0_v4"   => Fog::Rackspace::MockData.ipv4_address
+                  },
+                  "metadata" => {
+                    "testing" => "Bar"
+                  },
+                  "managed"    => false,
+                  "uri"        => "https://ord.servers.api.rackspacecloud.com/" + account_id + "/servers/" + server_id,
+                  "agent_id"   => nil,
+                  "created_at" => Time.now.to_i - 1,
+                  "updated_at" => Time.now.to_i
+                },
+                "checks"              => [
+                  {
+                    "id"              => check_id,
+                    "label"           => "mock",
+                    "type"            => "remote.mock",
+                    "details"         => {},
+                    "monitoring_zones_poll" => nil,
+                    "timeout"         => 10,
+                    "period"          => 30,
+                    "target_alias"    => nil,
+                    "target_hostname" => nil,
+                    "target_resolver" => nil,
+                    "disabled       " => false,
+                    "metadata"        => nil,
+                    "created_at"      => Time.now.to_i - 1,
+                    "updated_at"      => Time.now.to_i
+                  }
+                ],
+                "alarms" => [
+                  {
+                    "id"         => alarm_id,
+                    "label"      => nil,
+                    "check_id"   => check_id,
+                    "criteria"   => nil,
+                    "disabled"   => false,
+                    "notification_plan_id" => "npTechnicalContactsEmail",
+                    "metadata"   => nil,
+                    "created_at" => Time.now.to_i - 1,
+                    "updated_at" => Time.now.to_i
+                  }
+                ],
+                "latest_alarm_states" => []
+              }
+            ],
+          
+            "metadata" => {
+              "count"       => 1,
+              "limit"       => 100,
+              "marker"      => nil,
+              "next_marker" => nil,
+              "next_href"   => nil
+            }
+
+          }
+
+          response.headers = {
+            "Date"                  => Time.now.utc.to_s,
+            "Content-Type"          => "application/json; charset=UTF-8",
+            "X-RateLimit-Limit"     => "50000",
+            "X-RateLimit-Remaining" => "49627",
+            "X-RateLimit-Window"    => "24 hours",
+            "X-RateLimit-Type"      => "global",
+            "X-Response-Id"         =>" zsdvasdtrq345",
+            "X-LB"                  => "dfw1-maas-prod-api0",
+            "Vary"                  => "Accept-Encoding",
+            "Transfer-Encoding"     => "chunked"
+          }
+
+          response.remote_ip = Fog::Rackspace::MockData.ipv4_address
+          response
+        end
+      end          
+
     end
   end
 end

data/lib/fog/rackspace/requests/monitoring/update_alarm.rb

@@ -3,15 +3,46 @@ module Fog
     class Monitoring
       class Real
 
-        def update_alarm(entity_id, id, options)
+        def update_alarm(entity_id, alarm_id, options)
           request(
             :body     => JSON.encode(options),
             :expects  => [204],
             :method   => 'PUT',
-            :path     => "entities/#{entity_id}/alarms/#{id}"
+            :path     => "entities/#{entity_id}/alarms/#{alarm_id}"
           )
         end
       end
+
+      class Mock
+
+        def update_alarm(entity_id, alarm_id, options)
+
+          account_id = Fog::Mock.random_numbers(6).to_s
+
+          if entity_id == -1 || alarm_id == -1 || options[:testing]
+            raise Fog::Rackspace::Monitoring::NotFound
+          end
+
+          response = Excon::Response.new
+          response.status = 204
+          response.body = ""
+          response.headers = {
+            "Date"                  => Time.now.utc.to_s,
+            "Location"              => "https://monitoring.api.rackspacecloud.com/v1.0/" + account_id + "/entities/" + entity_id.to_s + "/alarms/" + alarm_id,
+            "X-Object-ID"           => alarm_id,
+            "X-RateLimit-Limit"     => "50000",
+            "X-RateLimit-Remaining" => "47877",
+            "X-RateLimit-Window"    => "24 hours",
+            "X-RateLimit-Type"      => "global",
+            "X-Response-Id"         => "laolsgggopsnfksdovnsv",
+            "X-LB"                  => "dfw1-maas-prod-api1",
+            "Content-Length"        => "0",
+            "Content-Type"          => "text/plain"
+          }
+          response.remote_ip = Fog::Rackspace::MockData.ipv4_address
+          response
+        end
+      end
     end
   end
 end

data/lib/fog/rackspace/requests/monitoring/update_check.rb

@@ -3,15 +3,45 @@ module Fog
     class Monitoring
       class Real
 
-        def update_check(entity_id, id, options)
+        def update_check(entity_id, check_id, options)
           request(
             :body     => JSON.encode(options),
             :expects  => [204],
             :method   => 'PUT',
-            :path     => "entities/#{entity_id}/checks/#{id}"
+            :path     => "entities/#{entity_id}/checks/#{check_id}"
           )
         end
       end
+
+      class Mock
+        def update_check(entity_id, check_id, options)
+
+           account_id = Fog::Mock.random_numbers(6).to_s
+
+          if entity_id == -1 || check_id == -1 || options[:testing]
+            raise Fog::Rackspace::Monitoring::NotFound
+          end
+
+          response = Excon::Response.new
+          response.status = 204
+          response.body = ""
+          response.headers = {
+            "Date"                  => Time.now.utc.to_s,
+            "Location"              => "https://monitoring.api.rackspacecloud.com/v1.0/" + account_id + "/entities/" + entity_id + "/checks/" + check_id,
+            "X-Object-ID"           => check_id,
+            "X-RateLimit-Limit"     => "50000",
+            "X-RateLimit-Remaining" => "49627",
+            "X-RateLimit-Window"    => "24 hours",
+            "X-RateLimit-Type"      => "global",
+            "X-Response-Id"         => "owbgowb989wno73ubgvw89",
+            "X-LB"                  => "ord1-maas-prod-api1",
+            "Content-Length"        => "0",
+            "Content-Type"          => "text/plain",
+          }
+          response.remote_ip = Fog::Rackspace::MockData.ipv4_address
+          response
+        end
+      end
     end
   end
 end

data/lib/fog/rackspace/requests/monitoring/update_entity.rb

@@ -3,15 +3,46 @@ module Fog
     class Monitoring
       class Real
 
-        def update_entity(id, options)
+        def update_entity(entity_id, options)
           request(
             :body     => JSON.encode(options),
             :expects  => [204],
             :method   => 'PUT',
-            :path     => "entities/#{id}"
+            :path     => "entities/#{entity_id}"
           )
         end
       end
+
+      class Mock
+
+        def update_entity(entity_id, options)
+
+          account_id = Fog::Mock.random_numbers(6).to_s
+
+          if entity_id == -1
+           raise Fog::Rackspace::Monitoring::NotFound
+          end
+
+          response = Excon::Response.new
+          response.status = 204
+          response.body = ""
+          response.headers = {
+            "Date"                  => Time.now.utc.to_s,
+            "Location"              => "https://monitoring.api.rackspacecloud.com/v1.0/" + account_id + "/entities/" + entity_id.to_s,
+            "X-Object-ID"           => entity_id.to_s,
+            "X-RateLimit-Limit"     => "50000",
+            "X-RateLimit-Remaining" => "47877",
+            "X-RateLimit-Window"    => "24 hours",
+            "X-RateLimit-Type"      => "global",
+            "X-Response-Id"         => "lakbngf9bsgkn69gb39sobnsv",
+            "X-LB"                  => "dfw1-maas-prod-api1",
+            "Content-Length"        => "0",
+            "Content-Type"          => "text/plain"
+          }
+          response.remote_ip = Fog::Rackspace::MockData.ipv4_address
+          response
+        end
+      end 
     end
   end
 end

data/lib/fog/rackspace/requests/monitoring/update_notification.rb

@@ -0,0 +1,17 @@
+module Fog
+  module Rackspace
+    class Monitoring
+      class Real
+        def update_notification(id, options)
+          request(
+            :body     => JSON.encode(options),
+            :expects  => [204],
+            :method   => 'PUT',
+            :path     => "notifications/#{id}"
+          )
+        end
+      end
+    end
+  end
+end
+

data/lib/fog/rackspace/requests/storage/get_object.rb

@@ -13,19 +13,17 @@ module Fog
         # @raise [Fog::Storage::Rackspace::InternalServerError] - HTTP 500
         # @raise [Fog::Storage::Rackspace::ServiceError]
         def get_object(container, object, &block)
-          params = {}
+          params = {
+            :expects  => 200,
+            :method   => 'GET',
+            :path     => "#{Fog::Rackspace.escape(container)}/#{Fog::Rackspace.escape(object)}"
+          }
 
           if block_given?
-            params[:response_block] = Proc.new
+            params[:response_block] = block
           end
 
-          request(params.merge!({
-            :expects  => 200,
-            :method   => 'GET',
-            :path     => "#{Fog::Rackspace.escape(container)}/#{Fog::Rackspace.escape(object)}"
-          }),
-          false,
-          &block)
+          request(params, false)
         end
 
       end

data/lib/fog/rackspace/service.rb

@@ -30,17 +30,17 @@ module Fog
          self.send authentication_method, options
       end
 
-      def request_without_retry(params, parse_json = true, &block)
-        response = @connection.request(request_params(params), &block)
+      def request_without_retry(params, parse_json = true)
+        response = @connection.request(request_params(params))
 
         process_response(response) if parse_json
         response
       end
 
-      def request(params, parse_json = true, &block)
+      def request(params, parse_json = true)
         first_attempt = true
         begin
-          response = @connection.request(request_params(params), &block)
+          response = @connection.request(request_params(params))
         rescue Excon::Errors::Unauthorized => error
           raise error unless first_attempt
           first_attempt = false
@@ -55,7 +55,11 @@ module Fog
       private
 
       def process_response(response)
-        if response && response.body && response.body.is_a?(String) && Fog::Rackspace.json_response?(response)
+        if response &&
+           response.body &&
+           response.body.is_a?(String) &&
+           !response.body.strip.empty? &&
+           Fog::Rackspace.json_response?(response)
           begin
             response.body = Fog::JSON.decode(response.body)
           rescue MultiJson::DecodeError => e
@@ -66,8 +70,7 @@ module Fog
       end
 
       def headers(options={})
-        h = {
-          'Content-Type' => 'application/json',
+        { 'Content-Type' => 'application/json',
           'Accept' => 'application/json',
           'X-Auth-Token' => auth_token
         }.merge(options[:headers] || {})
@@ -85,7 +88,7 @@ module Fog
         if v2_authentication?
           :authenticate_v2
         else
-          Fog::Logger.deprecation "Authentication using a v1.0/v1.1 endpoint is deprecated. Please specify a v2.0 endpoint using :rackpace_auth_url.\ 
+          Fog::Logger.deprecation "Authentication using a v1.0/v1.1 endpoint is deprecated. Please specify a v2.0 endpoint using :rackpace_auth_url.\
           For a list of v2.0 endpoints refer to http://docs.rackspace.com/auth/api/v2.0/auth-client-devguide/content/Endpoints-d1e180.html"
          :authenticate_v1
         end
@@ -123,6 +126,11 @@ module Fog
         @auth_token || @identity_service.auth_token
       end
 
+      def select_options(keys)
+        return nil unless @options && keys
+        @options.select {|k,v| keys.include?(k)}
+      end
+
     end
   end
 end

data/lib/fog/rackspace/storage.rb

@@ -145,8 +145,8 @@ module Fog
           @connection.reset
         end
 
-        def request(params, parse_json = true, &block)
-          super(params, parse_json, &block)
+        def request(params, parse_json = true)
+          super
         rescue Excon::Errors::NotFound => error
           raise NotFound.slurp(error, self)
         rescue Excon::Errors::BadRequest => error

data/lib/fog/vcloud_director.rb

@@ -0,0 +1,11 @@
+require 'fog/core'
+
+module Fog
+  module VcloudDirector
+
+    extend Fog::Provider
+
+    service(:compute, 'vcloud_director/compute', 'Compute')
+
+  end
+end

data/lib/fog/vcloud_director/README.md

@@ -0,0 +1,967 @@
+# VMware vCloud Director 5.1 API client
+
+## Introduction
+
+Collection and Model representation in vcloud_director fog provider.
+
+```no-highlight
+Organizations
+  Organization
+    vdcs -> vdc -> vapps -> vapp -> vms -> vm -> customizations -> script
+                                              -> network
+                                              -> disks -> disk
+                                              -> tags -> tag
+                                              -> power_on
+    networks -> network
+  catalogs -> catalog -> catalog_items -> catalog_item -> instantiate_vapp
+```
+
+### Actions
+
+Every collection supports the following methods:
+
+Method Name       | Lazy Load
+----------------- | ---------
+get(id)           | false
+get_by_name(name) | false
+all               | true
+all(false)        | false
+
+### Lazy Loading
+
+When listing a collection (eg: `vdc.vapps`), lazy load will be used by default
+to improve the performance, otherwise it will make as many requests as items
+are in the collection.
+
+You can disable lazy load using the explict caller and passing a *false*
+option: `vdc.vapps.all(false)`.
+
+Attributes showing the value **NonLoaded** will be populated when accessing the
+value, if there are more than one **NonLoaded** values the first time accessing
+on any of those values will populate the others.
+
+You can explicitly load those attributes with the `reload` method:
+
+```ruby
+org = vcloud.organizations.first
+org.reload
+```
+
+Lazy load isn't used with `get` and `get_by_name` methods are used.
+
+## Initialization
+
+```ruby
+vcloud = Fog::Compute::VcloudDirector.new(
+  vcloud_director_username: "<username>@<org_name>",
+  vcloud_director_password: "<password>",
+  vcloud_director_host: 'example.com',
+  :connection_options => {
+    :ssl_verify_peer => false,
+    :connect_timeout => 200,
+    :read_timeout => 200
+  }
+)
+```
+
+## Organizations
+
+### List Organizations
+
+Note that when listing, by default only the attributes `id`, `name`, `type`,
+and `href` are loaded. To disable lazy loading, and load all attributes, just
+specify `false`. Another option is to reload a specific item:
+`vcloud.organizations.first.reload`
+
+```ruby
+vcloud.organizations
+```
+```
+  <Fog::Compute::VcloudDirector::Organizations
+    [
+      <Fog::Compute::VcloudDirector::Organization
+        id="c6a4c623-c158-41cf-a87a-dbc1637ad55a",
+        name="DevOps",
+        type="application/vnd.vmware.vcloud.org+xml",
+        href="https://example.com/api/org/c6a4c623-c158-41cf-a87a-dbc1637ad55a",
+        description=NonLoaded
+      >
+    ]
+  >
+```
+
+### Retrieve an Organization by Id
+
+```ruby
+org = vcloud.organizations.get("c6a4c623-c158-41cf-a87a-dbc1637ad55a")
+```
+
+### Retrieve an Organization by Name
+
+```ruby
+org = vcloud.organizations.get_by_name("DevOps")
+```
+
+## vDCs
+
+It shows the Organization's vDCs.
+
+### List vDCs
+
+```ruby
+org = vcloud.organizations.first
+org.vdcs
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Vdcs
+    organization=    <Fog::Compute::VcloudDirector::Organization
+      id="c6a4c623-c158-41cf-a87a-dbc1637ad55a",
+      name="DevOps",
+      type="application/vnd.vmware.vcloud.org+xml",
+      href="https://example.com/api/org/c6a4c623-c158-41cf-a87a-dbc1637ad55a",
+      description=NonLoaded
+    >
+    [
+      <Fog::Compute::VcloudDirector::Vdc
+        id="9a06a16b-12c6-44dc-aee1-06aa52262ea3",
+        name="DevOps - VDC",
+        type="application/vnd.vmware.vcloud.vdc+xml",
+        href="https://example.com/api/vdc/9a06a16b-12c6-44dc-aee1-06aa52262ea3",
+        description=NonLoaded,
+        available_networks=NonLoaded,
+        compute_capacity_cpu=NonLoaded,
+        compute_capacity_memory=NonLoaded,
+        storage_capacity=NonLoaded,
+        allocation_model=NonLoaded,
+        capabilities=NonLoaded,
+        nic_quota=NonLoaded,
+        network_quota=NonLoaded,
+        vm_quota=NonLoaded,
+        is_enabled=NonLoaded
+      >
+    ]
+  >
+```
+
+### Retrieve a vDC
+
+```ruby
+org = vcloud.organizations.first
+org.vdcs.get_by_name("DevOps - VDC")
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Vdc
+    id="9a06a16b-12c6-44dc-aee1-06aa52262ea3",
+    name="DevOps - VDC",
+    type="application/vnd.vmware.vcloud.vdc+xml",
+    href="https://example.com/api/vdc/9a06a16b-12c6-44dc-aee1-06aa52262ea3",
+    description="",
+    available_networks={:type=>"application/vnd.vmware.vcloud.network+xml", :name=>"DevOps - Dev Network Connection", :href=>"https://example.com/api/network/d5f47bbf-de27-4cf5-aaaa-56772f2ccd17"},
+    compute_capacity_cpu=NonLoaded,
+    compute_capacity_memory={:Units=>"MB", :Allocated=>"0", :Limit=>"0", :Used=>"3584", :Overhead=>"65"},
+    storage_capacity={:Units=>"MB", :Allocated=>"1048320", :Limit=>"1048320", :Used=>"903168", :Overhead=>"0"},
+    allocation_model="AllocationVApp",
+    capabilities={:SupportedHardwareVersion=>"vmx-09"},
+    nic_quota=0,
+    network_quota=1024,
+    vm_quota=0,
+    is_enabled=true
+  >
+```
+
+## vApps
+
+### List vApps
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vdc.vapps
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Vapps
+    vdc=    <Fog::Compute::VcloudDirector::Vdc
+      id="9a06a16b-12c6-44dc-aee1-06aa52262ea3",
+      name="DevOps - VDC",
+      type="application/vnd.vmware.vcloud.vdc+xml",
+      href="https://example.com/api/vdc/9a06a16b-12c6-44dc-aee1-06aa52262ea3",
+      description=NonLoaded,
+      available_networks=NonLoaded,
+      compute_capacity_cpu=NonLoaded,
+      compute_capacity_memory=NonLoaded,
+      storage_capacity=NonLoaded,
+      allocation_model=NonLoaded,
+      capabilities=NonLoaded,
+      nic_quota=NonLoaded,
+      network_quota=NonLoaded,
+      vm_quota=NonLoaded,
+      is_enabled=NonLoaded
+    >
+    [
+      <Fog::Compute::VcloudDirector::Vapp
+        id="vapp-11c7102f-443d-40fd-b1da-cca981fb44b6",
+        name="segundo",
+        type="application/vnd.vmware.vcloud.vApp+xml",
+        href="https://example.com/api/vApp/vapp-11c7102f-443d-40fd-b1da-cca981fb44b6",
+        description=NonLoaded,
+        deployed=NonLoaded,
+        status=NonLoaded,
+        deployment_lease_in_seconds=NonLoaded,
+        storage_lease_in_seconds=NonLoaded,
+        startup_section=NonLoaded,
+        network_section=NonLoaded,
+        network_config=NonLoaded,
+        owner=NonLoaded,
+        InMaintenanceMode=NonLoaded
+      >,
+      <Fog::Compute::VcloudDirector::Vapp
+        id="vapp-6ac43e0e-13e2-4642-a58a-6dc3a12f585b",
+        name="vApp_restebanez_9",
+        type="application/vnd.vmware.vcloud.vApp+xml",
+        href="https://example.com/api/vApp/vapp-6ac43e0e-13e2-4642-a58a-6dc3a12f585b",
+        description=NonLoaded,
+        deployed=NonLoaded,
+        status=NonLoaded,
+        deployment_lease_in_seconds=NonLoaded,
+        storage_lease_in_seconds=NonLoaded,
+        startup_section=NonLoaded,
+        network_section=NonLoaded,
+        network_config=NonLoaded,
+        owner=NonLoaded,
+        InMaintenanceMode=NonLoaded
+      >
+    ]
+  >
+```
+
+### Retrieve a vApp
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vdc.vapps.get_by_name("segundo")
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Vapp
+    id="vapp-11c7102f-443d-40fd-b1da-cca981fb44b6",
+    name="segundo",
+    type="application/vnd.vmware.vcloud.vApp+xml",
+    href="https://example.com/api/vApp/vapp-11c7102f-443d-40fd-b1da-cca981fb44b6",
+    description="",
+    deployed=false,
+    status="8",
+    deployment_lease_in_seconds=NonLoaded,
+    storage_lease_in_seconds="7776000",
+    startup_section={:ovf_stopDelay=>"0", :ovf_stopAction=>"powerOff", :ovf_startDelay=>"0", :ovf_startAction=>"powerOn", :ovf_order=>"0", :ovf_id=>"DEVWEB"},
+    network_section={:ovf_name=>"DevOps - Dev Network Connection", :"ovf:Description"=>""},
+    network_config={:networkName=>"DevOps - Dev Network Connection", :Link=>{:rel=>"repair", :href=>"https://example.com/api/admin/network/82a07044-4dda-4a3e-a53d-8981cf0d5baa/action/reset"}, :Description=>"", :Configuration=>{:IpScope=>{:IsInherited=>"true", :Gateway=>"10.192.0.1", :Netmask=>"255.255.252.0", :Dns1=>"10.192.0.11", :Dns2=>"10.192.0.12", :DnsSuffix=>"dev.ad.mdsol.com", :IpRanges=>{:IpRange=>{:StartAddress=>"10.192.0.100", :EndAddress=>"10.192.3.254"}}}, :ParentNetwork=>{:name=>"DevOps - Dev Network Connection", :id=>"d5f47bbf-de27-4cf5-aaaa-56772f2ccd17", :href=>"https://example.com/api/admin/network/d5f47bbf-de27-4cf5-aaaa-56772f2ccd17"}, :FenceMode=>"bridged", :RetainNetInfoAcrossDeployments=>"false"}, :IsDeployed=>"false"},
+    owner={:type=>"application/vnd.vmware.admin.user+xml", :name=>"restebanez", :href=>"https://example.com/api/admin/user/c3ca7b97-ddea-425f-8bdb-1fdb946f7349"},
+    InMaintenanceMode=false
+  >
+```
+
+## VMs
+
+### List VMs
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vapp.vms
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Vms
+    vapp=    <Fog::Compute::VcloudDirector::Vapp
+      id="vapp-11c7102f-443d-40fd-b1da-cca981fb44b6",
+      name="segundo",
+      type="application/vnd.vmware.vcloud.vApp+xml",
+      href="https://example.com/api/vApp/vapp-11c7102f-443d-40fd-b1da-cca981fb44b6",
+      description="",
+      deployed=false,
+      status="8",
+      deployment_lease_in_seconds=NonLoaded,
+      storage_lease_in_seconds="7776000",
+      startup_section={:ovf_stopDelay=>"0", :ovf_stopAction=>"powerOff", :ovf_startDelay=>"0", :ovf_startAction=>"powerOn", :ovf_order=>"0", :ovf_id=>"DEVWEB"},
+      network_section={:ovf_name=>"DevOps - Dev Network Connection", :"ovf:Description"=>""},
+      network_config={:networkName=>"DevOps - Dev Network Connection", :Link=>{:rel=>"repair", :href=>"https://example.com/api/admin/network/82a07044-4dda-4a3e-a53d-8981cf0d5baa/action/reset"}, :Description=>"", :Configuration=>{:IpScope=>{:IsInherited=>"true", :Gateway=>"10.192.0.1", :Netmask=>"255.255.252.0", :Dns1=>"10.192.0.11", :Dns2=>"10.192.0.12", :DnsSuffix=>"dev.ad.mdsol.com", :IpRanges=>{:IpRange=>{:StartAddress=>"10.192.0.100", :EndAddress=>"10.192.3.254"}}}, :ParentNetwork=>{:name=>"DevOps - Dev Network Connection", :id=>"d5f47bbf-de27-4cf5-aaaa-56772f2ccd17", :href=>"https://example.com/api/admin/network/d5f47bbf-de27-4cf5-aaaa-56772f2ccd17"}, :FenceMode=>"bridged", :RetainNetInfoAcrossDeployments=>"false"}, :IsDeployed=>"false"},
+      owner={:type=>"application/vnd.vmware.admin.user+xml", :name=>"restebanez", :href=>"https://example.com/api/admin/user/c3ca7b97-ddea-425f-8bdb-1fdb946f7349"},
+      InMaintenanceMode=false
+    >
+    [
+      <Fog::Compute::VcloudDirector::Vm
+        id="vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+        vapp_id="vapp-11c7102f-443d-40fd-b1da-cca981fb44b6",
+        name="DEVWEB",
+        type="application/vnd.vmware.vcloud.vm+xml",
+        href="https://example.com/api/vApp/vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+        status="off",
+        operating_system="Microsoft Windows Server 2008 R2 (64-bit)",
+        ip_address="10.192.0.144",
+        cpu=3,
+        memory=3584,
+        hard_disks=[{"Hard disk 1"=>163840}]
+      >
+    ]
+  >
+```
+
+### Retrieve a VM
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vapp.vms.get_by_name("DEVWEB")
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Vm
+    id="vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+    vapp_id="vapp-11c7102f-443d-40fd-b1da-cca981fb44b6",
+    name="DEVWEB",
+    type="application/vnd.vmware.vcloud.vm+xml",
+    href="https://example.com/api/vApp/vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+    status="off",
+    operating_system="Microsoft Windows Server 2008 R2 (64-bit)",
+    ip_address="10.192.0.144",
+    cpu=3,
+    memory=3584,
+    hard_disks=[{"Hard disk 1"=>163840}]
+  >
+```
+
+### Modify CPU
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.cpu = 4
+```
+```no-highlight
+...  success
+4
+```
+
+### Modify Memory
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.memory = 4096
+```
+```no-highlight
+...  success
+4096
+```
+
+### Power On a VM
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.power_on
+```
+```no-highlight
+.....  success
+true
+```
+
+## VM Customization
+
+### Retrieve VM Customization
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.customization
+```
+```ruby
+  <Fog::Compute::VcloudDirector::VmCustomization
+    id="vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+    type="application/vnd.vmware.vcloud.guestCustomizationSection+xml",
+    href="https://example.com/api/vApp/vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192/guestCustomizationSection/",
+    enabled=false,
+    change_sid=false,
+    join_domain_enabled=false,
+    use_org_settings=false,
+    admin_password_enabled=false,
+    reset_password_required=false,
+    virtual_machine_id="2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+    computer_name="DEVWEB-001",
+    has_customization_script=true
+  >
+```
+
+### Modify VM Customization
+
+Customization attributes model requires to `save` it after setting the
+attributes.
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+customization = vm.customization
+customization.compute_name = "NEWNAME"
+customization.enabled = false
+customization.script = "new userdata script"
+customization.save
+```
+```no-highlight
+..  success
+true
+```
+
+## VM Network
+
+### Show VM Networks
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.network
+```
+```ruby
+    <Fog::Compute::VcloudDirector::VmNetwork
+    id="vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+    type="application/vnd.vmware.vcloud.networkConnectionSection+xml",
+    href="https://example.com/api/vApp/vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192/networkConnectionSection/",
+    info="Specifies the available VM network connections",
+    primary_network_connection_index=0,
+    network="DevOps - Dev Network Connection",
+    needs_customization=true,
+    network_connection_index=0,
+    is_connected=true,
+    mac_address="00:50:56:01:00:ea",
+    ip_address_allocation_mode="POOL"
+  >
+```
+
+### Modify one or more attributes
+
+Network attributes model requires to `save` it after setting the attributes.
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+network = vm.network
+network.is_connected = false
+network.ip_address_allocation_mode = "DHCP"
+network.save
+```
+```no-highlight
+..  success
+true
+```
+
+## VM Disk
+
+### List VM Disks
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.disks
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Disks
+    vm=    <Fog::Compute::VcloudDirector::Vm
+      id="vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+      vapp_id="vapp-11c7102f-443d-40fd-b1da-cca981fb44b6",
+      name="DEVWEB",
+      type="application/vnd.vmware.vcloud.vm+xml",
+      href="https://example.com/api/vApp/vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+      status="off",
+      operating_system="Microsoft Windows Server 2008 R2 (64-bit)",
+      ip_address="10.192.0.144",
+      cpu=4,
+      memory=4096,
+      hard_disks=[{"Hard disk 1"=>163840}]
+    >
+    [
+      <Fog::Compute::VcloudDirector::Disk
+        id=2,
+        address=0,
+        description="SCSI Controller",
+        name="SCSI Controller 0",
+        resource_sub_type="lsilogicsas",
+        resource_type=6,
+        address_on_parent=nil,
+        parent=nil,
+        capacity=nil,
+        bus_sub_type=nil,
+        bus_type=nil
+      >,
+      <Fog::Compute::VcloudDirector::Disk
+        id=2000,
+        address=nil,
+        description="Hard disk",
+        name="Hard disk 1",
+        resource_sub_type=nil,
+        resource_type=17,
+        address_on_parent=0,
+        parent=2,
+        capacity=163840,
+        bus_sub_type="lsilogicsas",
+        bus_type=6
+      >,
+      <Fog::Compute::VcloudDirector::Disk
+        id=3,
+        address=0,
+        description="IDE Controller",
+        name="IDE Controller 0",
+        resource_sub_type=nil,
+        resource_type=5,
+        address_on_parent=nil,
+        parent=nil,
+        capacity=nil,
+        bus_sub_type=nil,
+        bus_type=nil
+      >
+    ]
+  >
+```
+
+### Create a New Disk
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.disks.create(1024)
+```
+```no-highlight
+...  success
+true
+```
+
+The new disk should show up.
+
+```ruby
+>> vm.disks
+  <Fog::Compute::VcloudDirector::Disks
+    vm=    <Fog::Compute::VcloudDirector::Vm
+      id="vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+      vapp_id="vapp-11c7102f-443d-40fd-b1da-cca981fb44b6",
+      name="DEVWEB",
+      type="application/vnd.vmware.vcloud.vm+xml",
+      href="https://example.com/api/vApp/vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+      status="off",
+      operating_system="Microsoft Windows Server 2008 R2 (64-bit)",
+      ip_address="10.192.0.144",
+      cpu=4,
+      memory=4096,
+      hard_disks=[{"Hard disk 1"=>163840}]
+    >
+    [
+      <Fog::Compute::VcloudDirector::Disk
+        id=2,
+        address=0,
+        description="SCSI Controller",
+        name="SCSI Controller 0",
+        resource_sub_type="lsilogicsas",
+        resource_type=6,
+        address_on_parent=nil,
+        parent=nil,
+        capacity=nil,
+        bus_sub_type=nil,
+        bus_type=nil
+      >,
+      <Fog::Compute::VcloudDirector::Disk
+        id=2000,
+        address=nil,
+        description="Hard disk",
+        name="Hard disk 1",
+        resource_sub_type=nil,
+        resource_type=17,
+        address_on_parent=0,
+        parent=2,
+        capacity=163840,
+        bus_sub_type="lsilogicsas",
+        bus_type=6
+      >,
+      <Fog::Compute::VcloudDirector::Disk
+        id=2001,
+        address=nil,
+        description="Hard disk",
+        name="Hard disk 2",
+        resource_sub_type=nil,
+        resource_type=17,
+        address_on_parent=1,
+        parent=2,
+        capacity=1024,
+        bus_sub_type="lsilogicsas",
+        bus_type=6
+      >,
+      <Fog::Compute::VcloudDirector::Disk
+        id=3,
+        address=0,
+        description="IDE Controller",
+        name="IDE Controller 0",
+        resource_sub_type=nil,
+        resource_type=5,
+        address_on_parent=nil,
+        parent=nil,
+        capacity=nil,
+        bus_sub_type=nil,
+        bus_type=nil
+      >
+    ]
+  >
+```
+
+### Modify the Hard Disk Size
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+disk = vm.disks.get_by_name("Hard disk 2")
+disk.capacity = 2048
+```
+```no-highlight
+...  success
+true
+```
+
+### Destroy a Hard Disk
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+disk = vm.disks.get_by_name("Hard disk 2")
+disk.destroy
+```
+```no-highlight
+...  success
+true
+```
+
+## VM Tags
+
+### List VM Tags
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.tags
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Tags
+    vm=    <Fog::Compute::VcloudDirector::Vm
+      id="vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+      vapp_id="vapp-11c7102f-443d-40fd-b1da-cca981fb44b6",
+      name="DEVWEB",
+      type="application/vnd.vmware.vcloud.vm+xml",
+      href="https://example.com/api/vApp/vm-2ddeea36-ac71-470f-abc5-c6e3c2aca192",
+      status="off",
+      operating_system="Microsoft Windows Server 2008 R2 (64-bit)",
+      ip_address="10.192.0.144",
+      cpu=4,
+      memory=4096,
+      hard_disks=[{"Hard disk 1"=>163840}]
+    >
+    [
+      <Fog::Compute::VcloudDirector::Tag
+        id="environment",
+        value="devlab"
+      >,
+      <Fog::Compute::VcloudDirector::Tag
+        id="product",
+        value="devlabtest"
+      >,
+      <Fog::Compute::VcloudDirector::Tag
+        id="hello",
+        value="ddd"
+      >,
+      <Fog::Compute::VcloudDirector::Tag
+        id="uno",
+        value="jander"
+      >
+    ]
+  >
+```
+
+### Create a Tag
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.tags.create('this_is_a_key', 'this_is_a_value')
+```
+```no-highlight
+ success
+true
+```
+
+### Retrieve a Tag
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.tags.get_by_name('this_is_a_key')
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Tag
+    id="this_is_a_key",
+    value="this_is_a_value"
+  >
+```
+
+### Modify a Tag
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.tags.get_by_name('this_is_a_key').value = 'new_value'
+```
+```no-highlight
+  success
+"new_value"
+```
+
+### Destroy a Tag
+
+```ruby
+org = vcloud.organizations.first
+vdc = org.vdcs.first
+vapp = vdc.vapps.get_by_name("segundo")
+vm = vapp.vms.get_by_name("DEVWEB")
+vm.tags.get_by_name('this_is_a_key').destroy
+```
+```no-highlight
+  success
+true
+```
+
+## Networks
+
+It shows the Organization's Networks.
+
+### List Networks
+
+```ruby
+org = vcloud.organizations.first
+org.networks
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Networks
+    organization=    <Fog::Compute::VcloudDirector::Organization
+      id="c6a4c623-c158-41cf-a87a-dbc1637ad55a",
+      name="DevOps",
+      type="application/vnd.vmware.vcloud.org+xml",
+      href="https://example.com/api/org/c6a4c623-c158-41cf-a87a-dbc1637ad55a",
+      description=NonLoaded
+    >
+    [
+      <Fog::Compute::VcloudDirector::Network
+        id="d5f47bbf-de27-4cf5-aaaa-56772f2ccd17",
+        name="DevOps - Dev Network Connection",
+        type="application/vnd.vmware.vcloud.orgNetwork+xml",
+        href="https://example.com/api/network/d5f47bbf-de27-4cf5-aaaa-56772f2ccd17",
+        description=NonLoaded,
+        is_inherited=NonLoaded,
+        gateway=NonLoaded,
+        netmask=NonLoaded,
+        dns1=NonLoaded,
+        dns2=NonLoaded,
+        dns_suffix=NonLoaded,
+        ip_ranges=NonLoaded
+      >
+    ]
+  >
+```
+
+### Retrieve a Network
+
+```ruby
+org = vcloud.organizations.first
+org.networks.get_by_name("DevOps - Dev Network Connection")
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Network
+    id="d5f47bbf-de27-4cf5-aaaa-56772f2ccd17",
+    name="DevOps - Dev Network Connection",
+    type="application/vnd.vmware.vcloud.orgNetwork+xml",
+    href="https://example.com/api/network/d5f47bbf-de27-4cf5-aaaa-56772f2ccd17",
+    description=nil,
+    is_inherited=true,
+    gateway="10.192.0.1",
+    netmask="255.255.252.0",
+    dns1="10.192.0.11",
+    dns2="10.192.0.12",
+    dns_suffix="dev.ad.mdsol.com",
+    ip_ranges=[{:start_address=>"10.192.0.100", :end_address=>"10.192.3.254"}]
+  >
+```
+
+## Catalogs
+
+It shows the Organization's Catalogs.
+
+### List Catalogs
+
+```ruby
+org = vcloud.organizations.first
+org.catalogs
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Catalogs
+    organization=    <Fog::Compute::VcloudDirector::Organization
+      id="c6a4c623-c158-41cf-a87a-dbc1637ad55a",
+      name="DevOps",
+      type="application/vnd.vmware.vcloud.org+xml",
+      href="https://example.com/api/org/c6a4c623-c158-41cf-a87a-dbc1637ad55a",
+      description=NonLoaded
+    >
+    [
+      <Fog::Compute::VcloudDirector::Catalog
+        id="4ee720e5-173a-41ac-824b-6f4908bac975",
+        name="Public VM Templates",
+        type="application/vnd.vmware.vcloud.catalog+xml",
+        href="https://example.com/api/catalog/4ee720e5-173a-41ac-824b-6f4908bac975",
+        description=NonLoaded,
+        is_published=NonLoaded
+      >,
+      <Fog::Compute::VcloudDirector::Catalog
+        id="ea0c6acf-c9c0-46b7-b19f-4b2d3bf8aa33",
+        name="prueba",
+        type="application/vnd.vmware.vcloud.catalog+xml",
+        href="https://example.com/api/catalog/ea0c6acf-c9c0-46b7-b19f-4b2d3bf8aa33",
+        description=NonLoaded,
+        is_published=NonLoaded
+      >
+    ]
+  >
+```
+
+### Retrieve a Catalog
+
+```ruby
+org = vcloud.organizations.first
+org.catalogs.get("4ee720e5-173a-41ac-824b-6f4908bac975") # or get_by_name("Public VM Templates")
+```
+```ruby
+  <Fog::Compute::VcloudDirector::Catalog
+    id="4ee720e5-173a-41ac-824b-6f4908bac975",
+    name="Public VM Templates",
+    type="application/vnd.vmware.vcloud.catalog+xml",
+    href="https://example.com/api/catalog/4ee720e5-173a-41ac-824b-6f4908bac975",
+    description="",
+    is_published=true
+  >
+```
+
+## Catalog Items
+
+### List Catalog Items
+
+```ruby
+org = vcloud.organizations.first
+catalog = org.catalogs.first
+catalog.catalog_items
+```
+```ruby
+  <Fog::Compute::VcloudDirector::CatalogItems
+    catalog=    <Fog::Compute::VcloudDirector::Catalog
+      id="4ee720e5-173a-41ac-824b-6f4908bac975",
+      name="Public VM Templates",
+      type="application/vnd.vmware.vcloud.catalog+xml",
+      href="https://example.com/api/catalog/4ee720e5-173a-41ac-824b-6f4908bac975",
+      description=NonLoaded,
+      is_published=NonLoaded
+    >
+    [
+      <Fog::Compute::VcloudDirector::CatalogItem
+        id="2bd55629-2734-420c-9068-2ff06a4a8028",
+        name="DEVWIN",
+        type="application/vnd.vmware.vcloud.catalogItem+xml",
+        href="https://example.com/api/catalogItem/2bd55629-2734-420c-9068-2ff06a4a8028",
+        description=NonLoaded,
+        vapp_template_id=NonLoaded
+      >,
+      <Fog::Compute::VcloudDirector::CatalogItem
+        id="5437aa3f-e369-40b2-b985-2e63e1bc9f2e",
+        name="DEVRHL",
+        type="application/vnd.vmware.vcloud.catalogItem+xml",
+        href="https://example.com/api/catalogItem/5437aa3f-e369-40b2-b985-2e63e1bc9f2e",
+        description=NonLoaded,
+        vapp_template_id=NonLoaded
+      >,
+      <Fog::Compute::VcloudDirector::CatalogItem
+        id="54cf5deb-326f-4770-a91a-39048689b6ea",
+        name="DEVAPP",
+        type="application/vnd.vmware.vcloud.catalogItem+xml",
+        href="https://example.com/api/catalogItem/54cf5deb-326f-4770-a91a-39048689b6ea",
+        description=NonLoaded,
+        vapp_template_id=NonLoaded
+      >
+    ]
+  >
+```
+
+### Retrieve a Catalog Item
+
+```ruby
+org = vcloud.organizations.first
+catalog = org.catalogs.first
+catalog.catalog_items.get_by_name('DEVAPP')
+```
+```ruby
+  <Fog::Compute::VcloudDirector::CatalogItem
+    id="54cf5deb-326f-4770-a91a-39048689b6ea",
+    name="DEVAPP",
+    type="application/vnd.vmware.vcloud.catalogItem+xml",
+    href="https://example.com/api/catalogItem/54cf5deb-326f-4770-a91a-39048689b6ea",
+    description="Windows Server 2008 R2 Application Server",
+    vapp_template_id="vappTemplate-b5902d57-7906-49c8-8af5-bbebe0a60a97"
+  >
+```
+
+### Instantiate a vApp Template
+
+It creates a Vapp from a CatalogItem.
+
+```ruby
+org = vcloud.organizations.first
+catalog = org.catalogs.first
+template = catalog.catalog_items.get_by_name('DEVAPP')
+template.instantiate('webserver')
+```
+
+It there were more than one vDC or/and network you'd have to specify it as a
+second param:
+
+```ruby
+template.instantiate('webserver', {
+  vdc_id: "9a06a16b-12c6-44dc-aee1-06aa52262ea3",
+  network_id: "d5f47bbf-de27-4cf5-aaaa-56772f2ccd17"
+}
+```