fog-maestrodev 1.15.0.20130927082724 → 1.18.0.20131111203459

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,133 @@
+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
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Log in and create a Session object.
+        #
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #     * :href<~String> - The URI of the entity.
+        #     * :type<~String> - The MIME type of the entity.
+        #     * :org<~String> - The name of the user's organization.
+        #     * :user<~String> - The name of the user that owns the session
+        #     * :Link<~Array<Hash>]:
+        #       * :href<~String> - Contains the URI to the linked entity.
+        #       * :name<~String> - Contains the name of the linked entity.
+        #       * :type<~String> - Contains the type of the linked entity.
+        #       * :rel<~String> - Defines the relationship of the link to the
+        #         object that contains it.
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-Login-sessions.html
+        # @since vCloud API version 1.5
+        def post_login_session
+          headers = {
+            'Accept' => "application/*+xml;version=#{@api_version}",
+            'Authorization' => "Basic #{Base64.encode64("#{@vcloud_director_username}:#{@vcloud_director_password}").delete("\r\n")}"
+          }
+
+          @connection.request(
+            :expects => 200,
+            :headers => headers,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "#{@path}/sessions"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        extend Fog::Deprecation
+        deprecate :post_vm_poweroff, :post_power_off_vapp
+
+        # Power off a vApp or VM.
+        #
+        # If used on a vApp, powers off all VMs in the vApp. If used on a VM,
+        # powers off the VM. This operation is available only for a vApp or VM
+        # that is powered on.
+        #
+        # 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>:
+        #
+        # @raise [Fog::Compute::VcloudDirector::BadRequest]
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-PowerOffVApp.html
+        # @since vCloud API version 0.9
+        def post_power_off_vapp(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/power/action/powerOff"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        extend Fog::Deprecation
+        deprecate :post_vm_poweron, :post_power_on_vapp
+
+        # Power on a vApp or VM.
+        #
+        # If used on a vApp, powers on all VMs in the vApp. If used on a VM,
+        # powers on the VM. This operation is available only for a vApp or VM
+        # that is powered off.
+        #
+        # 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>:
+        #
+        # @raise [Fog::Compute::VcloudDirector::BadRequest]
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-PowerOnVApp.html
+        # @since vCloud API version 0.9
+        def post_power_on_vapp(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/power/action/powerOn"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Reboot a vApp or VM.
+        #
+        # If used on a vApp, reboots all VMs in the vApp. If used on a VM,
+        # reboots the VM. This operation is available only for a vApp or VM
+        # that is powered on.
+        #
+        # 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>:
+        #
+        # @raise [Fog::Compute::VcloudDirector::BadRequest]
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-RebootVApp.html
+        # @since vCloud API version 0.9
+        def post_reboot_vapp(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/power/action/reboot"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Removes all user created snapshots for a vApp or virtual machine.
+        #
+        # 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 virtual machine.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-RemoveAllSnapshots.html
+        # @since vCloud API version 5.1
+        def post_remove_all_snapshots(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/action/removeAllSnapshots"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Reset a vApp or VM.
+        #
+        # If used on a vApp, resets all VMs in the vApp. If used on a VM,
+        # resets the VM. This operation is available only for a vApp or VM that
+        # is powered on.
+        #
+        # 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>:
+        #
+        # @raise [Fog::Compute::VcloudDirector::BadRequest]
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-ResetVApp.html
+        # @since vCloud API version 0.9
+        def post_reset_vapp(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/power/action/reset"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Reverts a vApp or virtual machine to the current snapshot, if any.
+        #
+        # 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 virtual machine.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-RevertSnapshot.html
+        # @since vCloud API version 5.1
+        def post_revert_snapshot(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/action/revertToCurrentSnapshot"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Shut down a vApp or VM.
+        #
+        # If used on a vApp, shuts down all VMs in the vApp. If used on a VM,
+        # shuts down the VM. This operation is available only for a vApp or VM
+        # that is powered on.
+        #
+        # 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>:
+        #
+        # @raise [Fog::Compute::VcloudDirector::BadRequest]
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-ShutdownVApp.html
+        # @since vCloud API version 0.9
+        def post_shutdown_vapp(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/power/action/shutdown"
+          )
+        end
+      end
+    end
+  end
+end