From 9c024d77b09bdc881c8845465ce82d696aac2c22 Mon Sep 17 00:00:00 2001 From: Nick Osborn Date: Sun, 13 Oct 2013 22:10:30 +0100 Subject: [PATCH] [vcloud_director] Add post_instantiate_vapp_template request. --- lib/fog/vcloud_director/compute.rb | 3 +- .../compute/post_instantiate_vapp_template.rb | 124 ++++++++++++++++++ 2 files changed, 126 insertions(+), 1 deletion(-) create mode 100644 lib/fog/vcloud_director/requests/compute/post_instantiate_vapp_template.rb diff --git a/lib/fog/vcloud_director/compute.rb b/lib/fog/vcloud_director/compute.rb index 7b711cbd6..5c3f5733e 100644 --- a/lib/fog/vcloud_director/compute.rb +++ b/lib/fog/vcloud_director/compute.rb @@ -178,7 +178,7 @@ module Fog request :get_vms_by_metadata request :get_vms_disks_attached_to request :get_vms_in_lease_from_query - request :instantiate_vapp_template + request :instantiate_vapp_template # to be deprecated request :post_acquire_ticket request :post_attach_disk request :post_cancel_task @@ -201,6 +201,7 @@ module Fog request :post_exit_maintenance_mode request :post_insert_cd_rom request :post_install_vmware_tools + request :post_instantiate_vapp_template request :post_login_session request :post_power_off_vapp request :post_power_on_vapp diff --git a/lib/fog/vcloud_director/requests/compute/post_instantiate_vapp_template.rb b/lib/fog/vcloud_director/requests/compute/post_instantiate_vapp_template.rb new file mode 100644 index 000000000..552dba2d8 --- /dev/null +++ b/lib/fog/vcloud_director/requests/compute/post_instantiate_vapp_template.rb @@ -0,0 +1,124 @@ +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>: + # + # @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].iso8601 + end + if section.key?(:StorageLeaseExpiration) + StorageLeaseExpiration section[:StorageLeaseExpiration].iso8601 + 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 + + 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" + ) + end + end + end + end +end