fog-vcloud-director 0.1.0

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_compose_vapp.rb

@@ -0,0 +1,45 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        require 'fog/vcloud_director/generators/compute/compose_vapp'
+        # Compose a vApp from existing virtual machines.
+        #
+        # 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 vdc.
+        # @param [Hash] options
+        # @option options [Boolean] :powerOn Used to specify whether to power
+        #   on vApp on deployment, if not set default value is true.
+        # @option options [Boolean] :deploy Used to specify whether to deploy
+        #   the vApp, if not set default value is true.
+        # @option options [String] :name Used to identify the vApp.
+        # @option options [String] :networkName Used to conect the vApp and VMs to a VDC network, which has
+        # to exist beforehand.
+        # @option options [String] :networkHref Used to conect the vApp and VMs to a VDC network, which has
+        # to exist beforehand.
+        # @option options [String] :fenceMode Used to configure the network Mode (briged, isolated).
+        # @option options [String] :source_vms Array with VMs to be used to compose the vApp, each containing -
+        # :name, :href, :isGuestCustomizationEnabled, :computer_name and :ipAllocationMode (e.g. 'DHCP').
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-ComposeVApp.html
+        # @since vCloud API version 0.9
+        def post_compose_vapp(id, options={})
+          body = Fog::Generators::Compute::VcloudDirector::ComposeVapp.new(options).generate_xml
+
+          request(
+            :body => body,
+            :expects => 201,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.composeVAppParams+xml'},
+            :method => 'POST',
+            :parser => Fog::ToHashDocument.new,
+            :path => "vdc/#{id}/action/composeVApp"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,73 @@
+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 => make_href("admin/edgeGateway/#{id}"),
+            :type => 'application/vnd.vmware.vcloud.gateway+xml'
+          }
+          task_id = enqueue_task(
+              "Configuring edgegateway(#{id})", 'networkConfigureEdgeGatewayServices', owner,
+              :on_success => lambda do
+                data[:edge_gateways][id][:Configuration][:EdgeGatewayServiceConfiguration] = configuration
+              end
+          )
+
+          task = task_body(task_id)
+          task.delete(:Owner)  # known bug - admin tasks do not return Owner
+
+          body = {
+              :xmlns => xmlns,
+              :xmlns_xsi => xmlns_xsi,
+              :xsi_schemaLocation => xsi_schema_location,
+          }.merge(task)
+
+          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_create_catalog_item.rb

@@ -0,0 +1,56 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Add an item to a catalog.
+        #
+        # @param [String] id Object identifier of the catalog.
+        # @param [String] name The name of the entity.
+        # @param [Hash] entity A reference to a VAppTemplate or Media object.
+        #   * href<~String> - Contains the URI to the entity.
+        # @param [Hash] options
+        # @option options [String] :operationKey Optional unique identifier to
+        #   support idempotent semantics for create and delete operations.
+        # @option options [String] :Description Optional description.
+        # @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-CreateCatalogItem.html
+        # @since vCloud API version 0.9
+        def post_create_catalog_item(id, name, entity, options={})
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5',
+              :name => name,
+            }
+            attrs[:operationKey] = options[:operationKey] if options.key?(:operationKey)
+            CatalogItem(attrs) {
+              if options.key?(:Description)
+                Description options[:Description]
+              end
+              Entity(entity)
+            }
+          end.to_xml
+
+          begin
+            request(
+              :body    => body,
+              :expects => 201,
+              :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.catalogItem+xml'},
+              :method  => 'POST',
+              :parser  => Fog::ToHashDocument.new,
+              :path    => "catalog/#{id}/catalogItems"
+            )
+          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_create_org_vdc_network.rb

@@ -0,0 +1,171 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        require 'fog/vcloud_director/generators/compute/org_vdc_network'
+
+        # Create an Org vDC network.
+        #
+        # This operation is asynchronous and returns a task that you can
+        # monitor to track the progress of the request.
+        #
+        # Produce media type(s):
+        # application/vnd.vmware.vcloud.orgVdcNetwork+xml
+        # Output type:
+        # OrgVdcNetworkType
+        #
+        # @param [String] vdc_id Object identifier of the vDC
+        # @param [String] name   The name of the entity.
+        # @param [Hash] options
+        # @option options [String] :Description Optional description.
+        # @option options [Hash] :Configuration Network configuration.
+        # @option options [Hash] :EdgeGateway  EdgeGateway that connects this
+        #   Org vDC network. Applicable only for routed networks.
+        # @option options [Hash] :ServiceConfig Specifies the service
+        #   configuration for an isolated Org vDC networks.
+        # @option options [Boolean] :IsShared True if this network is shared
+        #   to multiple Org vDCs.
+        #   * :Configuration<~Hash>: NetworkConfigurationType
+        #     * :IpScopes<~Hash>:
+        #       * :IpScope<~Hash>:
+        #         * :IsInherited<~Boolean>: ?
+        #         * :Gateway<~String>: IP address of gw
+        #         * :Netmask<~String>: Subnet mask of network
+        #         * :Dns1<~String>: Primary DNS server.
+        #         * :Dns2<~String>: Secondary DNS server.
+        #         * :DnsSuffix<~String>: DNS suffix.
+        #         * :IsEnabled<~String>: Indicates if subnet is enabled or not.
+        #                                Default value is True.
+        #         * :IpRanges<~Array>: IP ranges used for static pool allocation
+        #                             in the network. Array of Hashes of:
+        #                               * :StartAddress - start IP in range
+        #                               * :EndAddress - end IP in range
+        #   * :EdgeGateway<~Hash>: EdgeGateway that connects this Org vDC
+        #                          network. Applicable only for routed networks.
+        #   * :ServiceConfig<~Hash>: Specifies the service configuration for an
+        #                            isolated network
+        #
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-CreateOrgVdcNetwork.html
+        # @since vCloud API version 5.1
+        def post_create_org_vdc_network(vdc_id, name, options={})
+          body = Fog::Generators::Compute::VcloudDirector::OrgVdcNetwork.new(options.merge(:name => name)).generate_xml
+
+          request(
+            :body    => body,
+            :expects => 201,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.orgVdcNetwork+xml'},
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "admin/vdc/#{vdc_id}/networks"
+          )
+        end
+      end
+
+      class Mock
+        def post_create_org_vdc_network(vdc_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 = 'network'
+          id = uuid
+
+          # Description
+          # Configuration
+          #   IpScopes
+          #     IpScope
+          #       IsInherited
+          #       Gateway
+          #       Netmask
+          #       Dns1
+          #       Dns2
+          #       DnsSuffix
+          #       IsEnabled
+          #       IpRanges
+          #         IpRange
+          #           StartAddress
+          #           EndAddress
+          #   FenceMode
+          # EdgeGateway
+          # IsShared
+
+          network_body = {
+            :name           => name,
+            :vdc            => vdc_id,
+          }
+
+          [:Description, :IsShared].each do |key|
+            network_body[key] = options[key] if options.key?(key)
+          end
+
+          if options.key?(:EdgeGateway)
+            network_body[:EdgeGateway] =
+              options[:EdgeGateway][:href].split('/').last
+          end
+
+          if configuration = options[:Configuration]
+            if ip_scopes = configuration[:IpScopes]
+              if ip_scope = ip_scopes[:IpScope]
+                [:IsInherited, :Gateway, :Netmask,
+                  :Dns1, :Dns2, :DnsSuffix, :IsEnabled].each do |key|
+                    network_body[key] = ip_scope[key] if ip_scope.key?(key)
+                end
+                if ip_ranges = ip_scope[:IpRanges]
+                  network_body[:IpRanges] = []
+                  ip_ranges.each do |ipr|
+                    network_body[:IpRanges] << {
+                      :StartAddress => ipr[:IpRange][:StartAddress],
+                      :EndAddress   => ipr[:IpRange][:EndAddress]
+                    }
+                  end
+                end
+              end
+            end
+            network_body[:FenceMode] = configuration[:FenceMode] if ip_scope.key?(:FenceMode)
+          end
+
+          owner = {
+            :href => make_href("#{type}/#{id}"),
+            :type => "application/vnd.vmware.vcloud.#{type}+xml"
+          }
+          task_id = enqueue_task(
+            "Adding #{type} #{name} (#{id})", 'CreateOrgVdcNetwork', owner,
+            :on_success => lambda do
+              data[:networks][id] = network_body
+            end
+          )
+
+          body = {
+            :xmlns => xmlns,
+            :xmlns_xsi => xmlns_xsi,
+            :xsi_schemaLocation => xsi_schema_location,
+            :href => make_href("admin/network/#{id}"),
+            :name => name,
+            :id => "urn:vcloud:network:#{id}",
+            :type => "application/vnd.vmware.vcloud.orgVdcNetwork+xml",
+            :Link => [
+              {:rel=>"up", :type=>"application/vnd.vmware.vcloud.vdc+xml", :href=>make_href("vdc/#{vdc_id}")},
+              {:rel=>"down", :type=>"application/vnd.vmware.vcloud.metadata+xml", :href=>make_href("admin/network/#{id}/metadata")},
+              {:rel=>"down", :type=>"application/vnd.vmware.vcloud.allocatedNetworkAddress+xml", :href=>make_href("admin/network/#{id}/allocatedAddresses/")},
+            ],
+          }.merge(options)
+
+          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