fog-maestrodev 1.15.0.20130927082724 → 1.18.0.20131111203459

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

@@ -0,0 +1,51 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Attach a disk to 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.
+        # @param [Hash] options
+        # @option options [Integer] :BusNumber Bus number on which to place the
+        #   disk controller. If empty or missing, the system assigns a bus
+        #   number and a unit number on that bus.
+        # @option options [Integer] :BusNumber Unit number (slot) on the bus
+        #   specified by :BusNumber. Ignored if :BusNumber is empty or missing.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-AttachDisk.html
+        # @since vCloud API version 5.1
+        def post_attach_disk(id, disk_id, options={})
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5'
+            }
+            DiskAttachOrDetachParams(attrs) {
+              Disk(:href => "#{@end_point}disk/#{media_id}")
+              if options.key?(:BusNumber)
+                BusNumber options[:BusNumber]
+              end
+              if options.key?(:UnitNumber)
+                BusNumber options[:UnitNumber]
+              end
+            }
+          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/attach"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,43 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        extend Fog::Deprecation
+        deprecate :post_task_cancel, :post_cancel_task
+
+        # Cancel a task.
+        #
+        # @param [String] id Object identifier of the task.
+        # @return [Excon::Response]
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-CancelTask.html
+        # @since vCloud API version 1.5
+        def post_cancel_task(id)
+          request(
+            :expects => 204,
+            :method  => 'POST',
+            :path    => "task/#{id}/action/cancel"
+          )
+        end
+      end
+
+      class Mock
+        def post_cancel_task(id)
+          unless task = data[:tasks][id]
+            raise Fog::Compute::VcloudDirector::Forbidden.new(
+              'No access to entity "com.vmware.vcloud.entity.task:%s"' % id
+            )
+          end
+
+          # @note Tasks don't actually get cancelled (confirmed VCloud Director
+          #   bug) so we'll emulate that. Set the flag and we're done!
+          task[:cancel_requested] = true
+
+          Excon::Response.new(
+            :status => 204
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,46 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Create a vApp template from a vApp.
+        #
+        # The response includes a Task element. You can monitor the task to to
+        # track the creation of the vApp template.
+        #
+        # @param [String] vdc_id Object identifier of the vDC.
+        # @param [String] name Name of the vApp template.
+        # @param [String] source_id Object identifier of the vApp to capture.
+        # @param [Hash] options
+        # @option options [String] :Description Optional description.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-CaptureVApp.html
+        # @since vCloud API version 0.9
+        def post_capture_vapp(vdc_id, name, source_id, options={})
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5',
+              :name => name
+            }
+            CaptureVAppParams(attrs) {
+              if options.key?(:Description)
+                Description options[:Description]
+              end
+              Source(:href => "#{end_point}vApp/#{source_id}")
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 201,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.captureVAppParams+xml'},
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vdc/#{vdc_id}/action/captureVApp"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Perform storage profile compliance check on a VM.
+        #
+        # This operation is asynchronous and return a task. When the task
+        # completes, the compliance check on the VM has been completed and the
+        # results can be retrieved.
+        #
+        # @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-CheckVmCompliance.html
+        # @since vCloud API version 5.1
+        def post_check_vm_compliance(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/action/checkCompliance"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,102 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Create a copy of a media object.
+        #
+        # The response includes a Task element. You can monitor the task to to
+        # track the creation of the vApp template.
+        #
+        # @param [String] vdc_id Object identifier of the vDC.
+        # @param [String] source_id Object identifier of the source media
+        #   object.
+        # @param [Hash] options
+        # @option options [String] :Description Optional description.
+        # @option options [Boolean] :IsSourceDelete A value of true deletes the
+        #   Source object after successful completion of the copy operation.
+        #   Defaults to false if empty or missing.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-CloneMedia.html
+        # @since vCloud API version 0.9
+        def post_clone_media(vdc_id, source_id, options={})
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5'
+            }
+            CloneMediaParams(attrs) {
+              if options.key?(:Description)
+                Description options[:Description]
+              end
+              Source(:href => "#{end_point}media/#{source_id}")
+              if options.key?(:IsSourceDelete)
+                IsSourceDelete options[:IsSourceDelete]
+              end
+            }
+          end.to_xml
+
+          response = request(
+            :body    => body,
+            :expects => 201,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.cloneMediaParams+xml'},
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vdc/#{vdc_id}/action/cloneMedia"
+          )
+          ensure_list! response.body, :Files, :File
+          response
+        end
+      end
+
+      class Mock
+        def post_clone_media(vdc_id, source_id, options={})
+          # TODO: check this happens.
+          unless source_media = data[:medias][source_id]
+            raise Fog::Compute::VcloudDirector::Forbidden.new(
+              "No access to entity \"(com.vmware.vcloud.entity.media:#{source_id})\"."
+            )
+          end
+          unless data[:vdcs][vdc_id]
+            raise Fog::Compute::VcloudDirector::Forbidden.new(
+              "No access to entity \"(com.vmware.vcloud.entity.vdc:#{vdc_id})\"."
+            )
+          end
+
+          media_id = uuid
+          media_name = "#{source_media[:name]}-copy-#{uuid}"
+
+          owner = {
+            :href => make_href("media/#{media_id}"),
+            :type => 'application/vnd.vmware.vcloud.media+xml'
+          }
+          task_id = enqueue_task(
+            "Copy Media File #{media_name}(#{media_id})", 'vdcCopyMedia', owner,
+            :on_success => lambda do
+              data[:medias][media_id][:status] = 1
+            end
+          )
+
+          media = source_media.dup.merge(
+            :name => media_name,
+            :status => 0,
+            :tasks => [task_id]
+          )
+          data[:medias][media_id] = media
+
+          body = {
+            :xmlns => xmlns,
+            :xmlns_xsi => xmlns_xsi,
+            :xsi_schemaLocation => xsi_schema_location
+          }.merge(media_body(media_id))
+
+          Excon::Response.new(
+            :status => 201,
+            :headers => {'Content-Type' => "#{body[:type]};version=#{api_version}"},
+            :body => body
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,62 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Create a copy of a vApp.
+        #
+        # The response includes a Task element. You can monitor the task to to
+        # track the creation of the vApp template.
+        #
+        # @param [String] vdc_id Object identifier of the vDC.
+        # @param [String] name Name of the new vApp.
+        # @param [String] source_id Object identifier of the source vApp.
+        # @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.
+        # @option options [Boolean] :IsSourceDelete Set to true to delete the
+        #   source object after the operation completes.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-CloneVApp.html
+        # @since vCloud API version 0.9
+        def post_clone_vapp(vdc_id, name, source_id, options={})
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5',
+              :name => name
+            }
+            attrs[:deploy] = options[:deploy] if options.key?(:deploy)
+            attrs[:powerOn] = options[:powerOn] if options.key?(:powerOn)
+            CloneVAppParams(attrs) {
+              if options.key?(:Description)
+                Description options[:Description]
+              end
+              InstantiationParams {
+                # TODO
+              }
+              Source(:href => "#{end_point}vApp/#{source_id}")
+              if options.key?(:IsSourceDelete)
+                IsSourceDelete options[:IsSourceDelete]
+              end
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 201,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.cloneVAppParams+xml'},
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vdc/#{vdc_id}/action/cloneVApp"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,52 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Create a copy of a vApp template.
+        #
+        # The response includes a Task element. You can monitor the task to to
+        # track the creation of the vApp template.
+        #
+        # @param [String] vdc_id Object identifier of the vDC.
+        # @param [String] name Name of the new vApp template.
+        # @param [String] source_id Object identifier of the source vApp
+        #   template.
+        # @param [Hash] options
+        # @option options [String] :Description Optional description.
+        # @option options [Boolean] :IsSourceDelete Set to true to delete the
+        #   source object after the operation completes.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-CloneVAppTemplate.html
+        # @since vCloud API version 0.9
+        def post_clone_vapp_template(vdc_id, name, source_id, options={})
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5',
+              :name => name
+            }
+            CloneVAppTemplateParams(attrs) {
+              if options.key?(:Description)
+                Description options[:Description]
+              end
+              Source(:href => "#{end_point}vAppTemplate/#{source_id}")
+              if options.key?(:IsSourceDelete)
+                IsSourceDelete options[:IsSourceDelete]
+              end
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 201,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.cloneVAppTemplateParams+xml'},
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vdc/#{vdc_id}/action/cloneVAppTemplate"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,70 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+
+        require 'fog/vcloud_director/generators/compute/edge_gateway_service_configuration'
+
+        # Configure edge gateway services like firewall, nat and load balancer.
+        #
+        # The response includes a Task element. You can monitor the task to
+        # track the configuration of edge gateway services.
+        #
+        # @param [String] id Object identifier of the edge gateway.
+        # @param [Hash] configuration
+        # @configuration firewall_service [Hash] - configurations for firewall service.
+        # @configuration nat_service [Hash] - configurations for NAT network service.
+        # @configuration load_balancer_service [Hash] - configurations for load balancer service
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        # @see https://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-ConfigureEdgeGatewayServices.html
+        #   vCloud API Documentaion
+        # @since vCloud API version 5.1
+        def post_configure_edge_gateway_services(id, configuration)
+          body = Fog::Generators::Compute::VcloudDirector::EdgeGatewayServiceConfiguration.new(configuration).generate_xml
+
+          request(
+              :body => body,
+              :expects => 202,
+              :headers => {'Content-Type' => 'application/vnd.vmware.admin.edgeGatewayServiceConfiguration+xml'},
+              :method => 'POST',
+              :parser => Fog::ToHashDocument.new,
+              :path => "admin/edgeGateway/#{id}/action/configureServices"
+          )
+        end
+
+      end
+
+      class Mock
+        def post_configure_edge_gateway_services(id, configuration)
+          unless data[:edge_gateways][id]
+            raise Fog::Compute::VcloudDirector::Forbidden.new(
+                      "No access to entity \"(com.vmware.vcloud.entity.edgegateway:#{id})\"."
+                  )
+          end
+
+          owner = {:href => '', :name => nil, :type => nil} #known-bug: admin-api does not return owner.
+          task_id = enqueue_task(
+              "Configuring edgegateway(#{id})", 'networkConfigureEdgeGatewayServices', owner,
+              :on_success => lambda do
+                data[:edge_gateways][id][:Configuration][:EdgeGatewayServiceConfiguration] = configuration
+              end
+          )
+
+          body = {
+              :xmlns => xmlns,
+              :xmlns_xsi => xmlns_xsi,
+              :xsi_schemaLocation => xsi_schema_location,
+          }.merge(task_body(task_id))
+
+          Excon::Response.new(
+              :status => 202,
+              :headers => {'Content-Type' => "#{body[:type]};version=#{api_version}"},
+              :body => body
+          )
+        end
+      end
+    end
+  end
+end
+

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

@@ -0,0 +1,27 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Consolidate VM snapshots.
+        #
+        # 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-ConsolidateVm-vApp.html
+        # @since vCloud API version 1.5
+        def post_consolidate_vm_vapp(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/action/consolidate"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Consolidate VM snapshots.
+        #
+        # 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-ConsolidateVm-vAppTemplate.html
+        # @since vCloud API version 1.5
+        def post_consolidate_vm_vapp_template(id)
+          request(
+            :expects => 202,
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vAppTemplate/#{id}/action/consolidate"
+          )
+        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'
+            }
+            attr[:deploymentLeaseSeconds] = options[:deploymentLeaseSeconds] if options.key?(:deploymentLeaseSeconds)
+            attr[:forceCustomization] = options[:forceCustomization] if options.key?(:forceCustomization)
+            attr[: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/#{media_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