fog-vcloud-director 0.1.0

data/lib/fog/vcloud_director/requests/compute/post_create_snapshot.rb

@@ -0,0 +1,21 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        require 'fog/vcloud_director/generators/compute/create_snapshot'
+        def post_create_snapshot(id, options={})
+          body = Fog::Generators::Compute::VcloudDirector::CreateSnapshot.new(options).generate_xml
+
+          request(
+            :body => body,
+            :expects => 202,
+            :headers => { 'Content-Type' => 'application/vnd.vmware.vcloud.createSnapshotParams+xml' },
+            :method => 'POST',
+            :parser => Fog::ToHashDocument.new,
+            :path => "vApp/#{id}/action/createSnapshot"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_deploy_vapp.rb

@@ -0,0 +1,51 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Deploy a vApp or VM.
+        #
+        # Deployment allocates all resources for the vApp and the virtual
+        # machines it contains.
+        #
+        # This operation is asynchronous and returns a task that you can
+        # monitor to track the progress of the request.
+        #
+        # @param [String] id Object identifier of the vApp.
+        # @param [Hash] options
+        # @option options [Integer] :deploymentLeaseSeconds Lease in seconds
+        #   for deployment. A value of 0 is replaced by the organization
+        #   default deploymentLeaseSeconds value.
+        # @option options [Boolean] :forceCustomization Used to specify whether
+        #   to force customization on deployment, if not set default value is
+        #   false.
+        # @option options [Boolean] :powerOn Used to specify whether to power
+        #   on vApp on deployment, if not set default value is true.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-DeployVApp.html
+        # @since vCloud API version 0.9
+        def post_deploy_vapp(id, options={})
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5'
+            }
+            attrs[:deploymentLeaseSeconds] = options[:deploymentLeaseSeconds] if options.key?(:deploymentLeaseSeconds)
+            attrs[:forceCustomization] = options[:forceCustomization] if options.key?(:forceCustomization)
+            attrs[:powerOn] = options[:powerOn] if options.key?(:powerOn)
+            DeployVAppParams(attrs)
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.deployVAppParams+xml'},
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/action/deploy"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_detach_disk.rb

@@ -0,0 +1,39 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Detach a disk from a VM.
+        #
+        # This operation is asynchronous and returns a task that you can
+        # monitor to track the progress of the request.
+        #
+        # @param [String] id Object identifier of the VM.
+        # @param [String] disk_id Object identifier of the disk.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-DetachDisk.html
+        # @since vCloud API version 5.1
+        def post_detach_disk(id, disk_id)
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5'
+            }
+            DiskAttachOrDetachParams(attrs) {
+              Disk(:href => "#{end_point}disk/#{disk_id}")
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.diskAttachOrDetachParams+xml'},
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/disk/action/detach"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_disable_nested_hv.rb

@@ -0,0 +1,27 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Hide hardware-assisted CPU virtualization from guest OS.
+        #
+        # This operation is asynchronous and returns a task that you can
+        # monitor to track the progress of the request.
+        #
+        # @param [String] id Object identifier of the VM.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-DisableNestedHv.html
+        # @since vCloud API version 5.1
+        def post_disable_nested_hv(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/action/disableNestedHypervisor"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_disable_vapp_template_download.rb

@@ -0,0 +1,24 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Disable a vApp template for download.
+        #
+        # @param [String] id Object identifier of the VM.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-DisableVAppTemplateDownload.html
+        # @since vCloud API version 0.9
+        def post_disable_vapp_template_download(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vAppTemplate/#{id}/action/disableDownload"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_discard_vapp_state.rb

@@ -0,0 +1,30 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Discard suspended state of a vApp or VM.
+        #
+        # Discarding the suspended state of a vApp discards the suspended state
+        # of all VMs it contains.
+        #
+        # This operation is asynchronous and returns a task that you can
+        # monitor to track the progress of the request.
+        #
+        # @param [String] id Object identifier of the vApp or VM.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-DiscardVAppState.html
+        # @since vCloud API version 0.9
+        def post_discard_vapp_state(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/action/discardSuspendedState"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_eject_cd_rom.rb

@@ -0,0 +1,39 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Eject virtual media.
+        #
+        # This operation is asynchronous and returns a task that you can
+        # monitor to track the progress of the request.
+        #
+        # @param [String] id Object identifier of the VM.
+        # @param [String] media_id Object identifier of the media object.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-EjectCdRom.html
+        # @since vCloud API version 0.9
+        def post_eject_cd_rom(id, media_id)
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5'
+            }
+            MediaInsertOrEjectParams(attrs) {
+              Media(:href => "#{end_point}media/#{media_id}")
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.mediaInsertOrEjectParams+xml'},
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/media/action/ejectMedia"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_enable_nested_hv.rb

@@ -0,0 +1,27 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Expose hardware-assisted CPU virtualization to guest OS.
+        #
+        # This operation is asynchronous and returns a task that you can
+        # monitor to track the progress of the request.
+        #
+        # @param [String] id Object identifier of the VM.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-EnableNestedHv.html
+        # @since vCloud API version 5.1
+        def post_enable_nested_hv(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/action/enableNestedHypervisor"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_enable_vapp_template_download.rb

@@ -0,0 +1,24 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Enable a vApp template for download.
+        #
+        # @param [String] id Object identifier of the VM.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-EnableVAppTemplateDownload.html
+        # @since vCloud API version 0.9
+        def post_enable_vapp_template_download(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vAppTemplate/#{id}/action/enableDownload"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_enter_maintenance_mode.rb

@@ -0,0 +1,26 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Place the vApp in maintenance mode.
+        #
+        # When a vApp is in maintenance mode, it is read-only to users. Only a
+        # system administrator can modify it. User-initiated tasks that are
+        # running when the vApp enters maintenance mode continue to run.
+        #
+        # @param [String] id Object identifier of the vApp.
+        # @return [Excon::Response]
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-EnterMaintenanceMode.html
+        # @since vCloud API version 1.5
+        def post_enter_maintenance_mode(id)
+          request(
+            :expects => 204,
+            :method  => 'POST',
+            :path    => "vApp/#{id}/action/enterMaintenanceMode"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_exit_maintenance_mode.rb

@@ -0,0 +1,22 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Take the vApp out of maintenance mode.
+        #
+        # @param [String] id Object identifier of the vApp.
+        # @return [Excon::Response]
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-ExitMaintenanceMode.html
+        # @since vCloud API version 1.5
+        def post_exit_maintenance_mode(id)
+          request(
+            :expects => 204,
+            :method  => 'POST',
+            :path    => "vApp/#{id}/action/exitMaintenanceMode"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_insert_cd_rom.rb

@@ -0,0 +1,39 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Insert virtual media.
+        #
+        # This operation is asynchronous and returns a task that you can
+        # monitor to track the progress of the request.
+        #
+        # @param [String] id Object identifier of the VM.
+        # @param [String] media_id Object identifier of the media object.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-InsertCdRom.html
+        # @since vCloud API version 0.9
+        def post_insert_cd_rom(id, media_id)
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5'
+            }
+            MediaInsertOrEjectParams(attrs) {
+              Media(:href => "#{end_point}media/#{media_id}")
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.mediaInsertOrEjectParams+xml'},
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/media/action/insertMedia"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_install_vmware_tools.rb

@@ -0,0 +1,27 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Install VMware Tools on a running VM.
+        #
+        # This operation is asynchronous and returns a task that you can
+        # monitor to track the progress of the request.
+        #
+        # @param [String] id Object identifier of the VM.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-InstallVMwareTools.html
+        # @since vCloud API version 1.5
+        def post_install_vmware_tools(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/action/installVMwareTools"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/vcloud_director/requests/compute/post_instantiate_vapp_template.rb

@@ -0,0 +1,196 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Create a vApp from a vApp template.
+        #
+        # The response includes a Task element. You can monitor the task to to
+        # track the creation of the vApp.
+        #
+        # @note This may not work at all or may work only under certain
+        #   circumstances.
+        #
+        # @param [String] id Object identifier of the vDC.
+        # @param [String] vapp_template_id Object identifier of the vApp
+        #   template.
+        # @param [String] name
+        # @param [Hash] options
+        # @option options [Boolean] :deploy True if the vApp should be deployed
+        #   at instantiation. Defaults to true.
+        # @option options [Boolean] :powerOn True if the vApp should be
+        #   powered-on at instantiation. Defaults to true.
+        # @option options [String] :Description Optional description.
+        # @option options [Hash] :InstantiationParams Instantiation parameters
+        #   for the composed vApp.
+        #   * :LeaseSettingsSection<~Hasn>:
+        #     * :DeploymentLeaseTimeInSeconds<~Integer> - Deployment lease in
+        #       seconds.
+        #     * :StorageLeaseTimeInSeconds<~Integer> - Storage lease in
+        #       seconds.
+        #     * :DeploymentLeaseExpiration<~Integer> - Expiration date/time of
+        #       deployment lease.
+        #     * :StorageLeaseExpiration<~Integer> - Expiration date/time of
+        #       storage lease.
+        #   * :NetworkConfigSection<~Hash>:
+        #     * :NetworkConfig<~Hash>:
+        #       * :networkName<~String> - The name of the vApp network.
+        #       * :Configuration<~Hash>:
+        #         * :ParentNetwork<~Hash>:
+        #           * :href<~String> -
+        #         * :FenceMode<~String> - Isolation type of the network.
+        # @option options [Boolean] :IsSourceDelete Set to true to delete the
+        #   source object after the operation completes.
+        # @option options [Boolean] :AllEULAsAccepted True confirms acceptance
+        #   of all EULAs in a vApp template.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @raise Fog::Compute::VcloudDirector::DuplicateName
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-InstantiateVAppTemplate.html
+        # @since vCloud API version 0.9
+        def post_instantiate_vapp_template(id, vapp_template_id, name, options={})
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              'xmlns' => 'http://www.vmware.com/vcloud/v1.5',
+              'xmlns:ovf' => 'http://schemas.dmtf.org/ovf/envelope/1',
+              :name => name
+            }
+            attrs[:deploy] = options[:deploy] if options.key?(:deploy)
+            attrs[:powerOn] = options[:powerOn] if options.key?(:powerOn)
+            InstantiateVAppTemplateParams(attrs) {
+              if options.key?(:Description)
+                Description options[:Description]
+              end
+              if instantiation_params = options[:InstantiationParams]
+                InstantiationParams {
+                  if section = instantiation_params[:LeaseSettingsSection]
+                    LeaseSettingsSection {
+                      self['ovf'].Info 'Lease settings section'
+                      if section.key?(:DeploymentLeaseInSeconds)
+                        DeploymentLeaseInSeconds section[:DeploymentLeaseInSeconds]
+                      end
+                      if section.key?(:StorageLeaseInSeconds)
+                        StorageLeaseInSeconds section[:StorageLeaseInSeconds]
+                      end
+                      if section.key?(:DeploymentLeaseExpiration)
+                        DeploymentLeaseExpiration section[:DeploymentLeaseExpiration].strftime('%Y-%m-%dT%H:%M:%S%z')
+                      end
+                      if section.key?(:StorageLeaseExpiration)
+                        StorageLeaseExpiration section[:StorageLeaseExpiration].strftime('%Y-%m-%dT%H:%M:%S%z')
+                      end
+                    }
+                  end
+                  if section = instantiation_params[:NetworkConfigSection]
+                    NetworkConfigSection {
+                      self['ovf'].Info 'Configuration parameters for logical networks'
+                      if network_configs = section[:NetworkConfig]
+                        network_configs = [network_configs] if network_configs.is_a?(Hash)
+                        network_configs.each do |network_config|
+                          NetworkConfig(:networkName => network_config[:networkName]) {
+                            if configuration = network_config[:Configuration]
+                              Configuration {
+                                ParentNetwork(configuration[:ParentNetwork])
+                                FenceMode configuration[:FenceMode]
+                              }
+                            end
+                          }
+                        end
+                      end
+                    }
+                  end
+                }
+              end
+              Source(:href => "#{end_point}vAppTemplate/#{vapp_template_id}")
+              if options.key?(:IsSourceDelete)
+                IsSourceDelete options[:IsSourceDelete]
+              end
+              if options.key?(:AllEULAsAccepted)
+                AllEULAsAccepted options[:AllEULAsAccepted]
+              end
+            }
+          end.to_xml
+
+          begin
+            request(
+              :body    => body,
+              :expects => 201,
+              :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.instantiateVAppTemplateParams+xml'},
+              :method  => 'POST',
+              :parser  => Fog::ToHashDocument.new,
+              :path    => "vdc/#{id}/action/instantiateVAppTemplate"
+            )
+          rescue Fog::Compute::VcloudDirector::BadRequest => e
+            if e.minor_error_code == 'DUPLICATE_NAME'
+              raise Fog::Compute::VcloudDirector::DuplicateName.new(e.message)
+            end
+            raise
+          end
+        end
+      end
+
+      class Mock
+
+        def post_instantiate_vapp_template(vdc_id, vapp_template_id, name, options={})
+          unless data[:vdcs][vdc_id]
+            raise Fog::Compute::VcloudDirector::Forbidden.new(
+              "No access to entity \"(com.vmware.vcloud.entity.vdc:#{vdc_id})\"."
+            )
+          end
+
+          type = 'vApp'
+          vapp_id = "vapp-#{uuid}"
+          vm_id = "vm-#{uuid}"
+
+          data[:vapps][vapp_id] = {
+            :name => name,
+            :vdc_id => vdc_id,
+            :description => options.fetch(:description, "vApp created from #{vapp_template_id}"),
+            :networks => [],
+            :metadata => {:'vapp_key' => 'vapp_value'},
+            :status => "0",
+          }
+
+          data[:vms][vm_id] = {
+            :name => 'vm-template-name',
+            :parent_vapp => vapp_id,
+            :memory_in_mb => "1024",
+            :cpu_count => "2",
+            :metadata => {:'vm_key' => 'vm_value'},
+            :nics => [
+              {
+              :network_name => 'Default Network',
+              :mac_address => "00:50:56:00:00:00",
+              :ip_address => "192.168.0.1",
+              }
+            ],
+          }
+
+          owner = {
+            :href => make_href("#{type}/#{vapp_id}"),
+            :type => "application/vnd.vmware.vcloud.#{type}+xml"
+          }
+          task_id = enqueue_task(
+            "Creating Virtual Application #{name}(#{vapp_id})", 'vdcInstantiateVapp', owner,
+            :on_success => lambda do
+              data[:vapps][vapp_id][:status] = "8"
+            end
+          )
+
+          body = get_vapp(vapp_id).body
+
+          body[:Tasks] = {
+            :Task => task_body(task_id)
+          }
+
+          Excon::Response.new(
+            :status => 201,
+            :headers => {'Content-Type' => "#{body[:type]};version=#{api_version}"},
+            :body => body
+          )
+        end
+
+      end
+    end
+  end
+end