fog-maestrodev 1.15.0.20130927082724 → 1.18.0.20131111203459

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

@@ -0,0 +1,46 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Upload an OVF package to create a vApp template
+        #
+        # The response includes an upload link for the OVF descriptor.
+        #
+        # @param [String] vdc_id Object identifier of the vDC.
+        # @param [String] name The name of the vApp template.
+        # @param [Hash] options
+        # @option options [Boolean] :manifestRequired True if an OVF manifest
+        #   is included in the upload. Default value is false.
+        # @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-UploadVAppTemplate.html
+        # @since vCloud API version 0.9
+        def post_upload_vapp_template(vdc_id, name, options={})
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5',
+              :name => name
+            }
+            attrs[:manifestRequired] = options[:manifestRequired] if options.key?(:manifestRequired)
+            UploadVAppTemplateParams(attrs) {
+              if options.key?(:Description)
+                Description options[:Description]
+              end
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 201,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.vAppTemplateParams+xml'},
+            :method  => 'POST',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vdc/#{vdc_id}/action/uploadVAppTemplate"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,50 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Set the metadata value for the specified key to the value provided,
+        # overwriting any existing value.
+        #
+        # @param [String] id Object identifier of the catalog item.
+        # @param [String] key Key of the metadata item.
+        # @param [Boolean,DateTime,Fixnum,String] value Value of the metadata
+        #   item.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/PUT-CatalogItemMetadataItem-metadata.html
+        # @since vCloud API version 1.5
+        def put_catalog_item_metadata_item_metadata(id, key, value)
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5',
+              'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance'
+            }
+            MetadataValue(attrs) {
+              if api_version.to_f < 5.1
+                Value value
+              else
+                type = case value
+                       when TrueClass, FalseClass then 'MetadataBooleanValue';
+                       when DateTime then 'MetadataDateTimeValue';
+                       when Fixnum then 'MetadataNumberValue';
+                       else 'MetadataStringValue'
+                       end
+                TypedValue('xsi:type' => type) { Value value }
+              end
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.metadata.value+xml'},
+            :method  => 'PUT',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "catalogItem/#{id}/metadata/#{URI.escape(key)}"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,47 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        extend Fog::Deprecation
+        deprecate :put_vm_cpu, :put_cpu
+
+        # Update the RASD item that specifies CPU properties of 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 [Integer] num_cpus
+        # @return [Excon:Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/PUT-Cpu.html
+        # @since vCloud API version 0.9
+        def put_cpu(id, num_cpus)
+          data = <<EOF
+          <Item xmlns="http://www.vmware.com/vcloud/v1.5" xmlns:rasd="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns12="http://www.vmware.com/vcloud/v1.5" ns12:href="#{end_point}vApp/#{id}/virtualHardwareSection/cpu" ns12:type="application/vnd.vmware.vcloud.rasdItem+xml" xsi:schemaLocation="http://www.vmware.com/vcloud/v1.5 http://10.194.1.65/api/v1.5/schema/master.xsd http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2.22.0/CIM_ResourceAllocationSettingData.xsd">
+            <rasd:AllocationUnits>hertz * 10^6</rasd:AllocationUnits>
+            <rasd:Description>Number of Virtual CPUs</rasd:Description>
+            <rasd:ElementName>#{num_cpus} virtual CPU(s)</rasd:ElementName>
+            <rasd:InstanceID>4</rasd:InstanceID>
+            <rasd:Reservation>0</rasd:Reservation>
+            <rasd:ResourceType>3</rasd:ResourceType>
+            <rasd:VirtualQuantity>#{num_cpus}</rasd:VirtualQuantity>
+            <rasd:Weight>0</rasd:Weight>
+            <Link rel="edit" type="application/vnd.vmware.vcloud.rasdItem+xml" href="#{end_point}vApp/#{id}/virtualHardwareSection/cpu"/>
+          </Item>
+EOF
+
+          request(
+            :body    => data,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.rasdItem+xml'},
+            :method  => 'PUT',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/virtualHardwareSection/cpu"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,46 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Set the value for the specified metadata key to the value provided,
+        # overwriting any existing value.
+        #
+        # @param [String] id Object identifier of the disk.
+        # @param [String] key Key of the metadata item.
+        # @param [Boolean,DateTime,Fixnum,String] value Value of the metadata
+        #   item.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/PUT-DiskMetadataItem-metadata.html
+        # @since vCloud API version 5.1
+        def put_disk_metadata_item_metadata(id, key, value)
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5',
+              'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance'
+            }
+            MetadataValue(attrs) {
+              type = case value
+                     when TrueClass, FalseClass then 'MetadataBooleanValue';
+                     when DateTime then 'MetadataDateTimeValue';
+                     when Fixnum then 'MetadataNumberValue';
+                     else 'MetadataStringValue'
+                     end
+              TypedValue('xsi:type' => type) { Value value }
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.metadata.value+xml'},
+            :method  => 'PUT',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "disk/#{id}/metadata/#{URI.escape(key)}"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        extend Fog::Deprecation
+        deprecate :put_vm_disks, :put_disks
+
+        require 'fog/vcloud_director/generators/compute/disks'
+
+        # Update all RASD items that specify hard disk and hard disk controller
+        # properties of 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 [Array] disks
+        #   * disks is the body of #get_vm_disks
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/PUT-Disks.html
+        # @since vCloud API version 0.9
+        def put_disks(id, disks=[])
+          data = Fog::Generators::Compute::VcloudDirector::Disks.new(disks)
+
+          request(
+            :body    => data.generate_xml,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.rasdItemsList+xml'},
+            :method  => 'PUT',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/virtualHardwareSection/disks"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,139 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        extend Fog::Deprecation
+        deprecate :put_vm_customization, :put_guest_customization_section_vapp
+
+        # Updates the guest customization section of 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 [Hash] options
+        # @option options [Boolean] :Enabled True if guest customization is
+        #   enabled.
+        # @option options [Boolean] :ChangeSid True if customization can change
+        #   the Windows SID of this virtual machine.
+        # @option options [Boolean] :JoinDomainEnabled True if this virtual
+        #   machine can join a Windows Domain.
+        # @option options [Boolean] :UseOrgSettings True if customization
+        #   should use organization settings (OrgGuestPersonalizationSettings)
+        #   when joining a Windows Domain.
+        # @option options [String] :DomainName The name of the Windows Domain
+        #   to join.
+        # @option options [String] :DomainUserName User name to specify when
+        #   joining a Windows Domain.
+        # @option options [String] :DomainUserPassword Password to use with
+        #   :DomainUserName.
+        # @option options [String] :MachineObjectOU The name of the Windows
+        #   Domain Organizational Unit (OU) in which the computer account for
+        #   this virtual machine will be created.
+        # @option options [Boolean] :AdminPassword_enabled True if guest
+        #   customization can modify administrator password settings for this
+        #   virtual machine.
+        # @option options [Boolean] :AdminPassword_auto True if the
+        #   administrator password for this virtual machine should be
+        #   automatically generated.
+        # @option options [String] :AdminPassword True if the administrator
+        #   password for this virtual machine should be set to this string.
+        #   (:AdminPasswordAuto must be false.)
+        # @option options [Boolean] :ResetPasswordRequired True if the
+        #   administrator password for this virtual machine must be reset after
+        #   first use.
+        # @option customization [String] :CustomizationScript Script to run on
+        #  guest customization. The entire script must appear in this element.
+        # @option customization [String] :ComputerName Computer name to assign
+        #   to this virtual machine.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #     * :Tasks<~Hash>:
+        #       * :Task<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/PUT-GuestCustomizationSection-vApp.html
+        # @since vCloud API version 1.0
+        def put_guest_customization_section_vapp(id, options={})
+          options = options.dup
+
+          # Mutate options to new format.
+          deprecated = {
+            :enabled => :Enabled,
+            :change_sid => :ChangeSid,
+            :join_domain_enabled => :JoinDomainEnabled,
+            :use_org_settings => :UseOrgSettings,
+            :admin_password_enabled => :AdminPasswordEnabled,
+            :admin_password_auto => :AdminPasswordAuto,
+            :reset_password_required => :ResetPasswordRequired,
+            :customization_script => :CustomizationScript,
+            :computer_name => :ComputerName
+          }
+          deprecated.each do |from, to|
+            options[to] = options.delete(from) if options.key?(from)
+          end
+
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5',
+              'xmlns:ovf' => 'http://schemas.dmtf.org/ovf/envelope/1'
+            }
+            GuestCustomizationSection(attrs) {
+              self['ovf'].Info 'Specifies Guest OS Customization Settings'
+              if options.key?(:Enabled)
+                Enabled options[:Enabled]
+              end
+              if options.key?(:ChangeSid)
+                ChangeSid options[:ChangeSid]
+              end
+              if options.key?(:JoinDomainEnabled)
+                JoinDomainEnabled options[:JoinDomainEnabled]
+              end
+              if options.key?(:UseOrgSettings)
+                UseOrgSettings options[:UseOrgSettings]
+              end
+              if options.key?(:DomainName)
+                DomainName options[:DomainName]
+              end
+              if options.key?(:DomainUser)
+                DomainUser options[:DomainUser]
+              end
+              if options.key?(:DomainUserPassword)
+                DomainUserPassword options[:DomainUserPassword]
+              end
+              if options.key?(:MachineObjectOU)
+                MachineObjectOU options[:MachineObjectOU]
+              end
+              if options.key?(:AdminPasswordEnabled)
+                AdminPasswordEnabled options[:AdminPasswordEnabled]
+              end
+              if options.key?(:AdminPasswordAuto)
+                AdminPasswordAuto options[:AdminPasswordAuto]
+              end
+              if options.key?(:AdminPassword)
+                AdminPassword options[:AdminPassword]
+              end
+              if options.key?(:ResetPasswordRequired)
+                ResetPasswordRequired options[:ResetPasswordRequired]
+              end
+              if options.key?(:CustomizationScript)
+                CustomizationScript options[:CustomizationScript]
+              end
+              if options.key?(:ComputerName)
+                ComputerName options[:ComputerName]
+              end
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.guestCustomizationSection+xml'},
+            :method  => 'PUT',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/guestCustomizationSection"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,50 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Set the value for the specified metadata key to the value provided,
+        # overwriting any existing value.
+        #
+        # @param [String] id Object identifier of the media object.
+        # @param [String] key Key of the metadata item.
+        # @param [Boolean,DateTime,Fixnum,String] value Value of the metadata
+        #   item.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/PUT-MediaMetadataItem-metadata.html
+        # @since vCloud API version 1.5
+        def put_media_metadata_item_metadata(id, key, value)
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5',
+              'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance'
+            }
+            MetadataValue(attrs) {
+              if api_version.to_f < 5.1
+                Value value
+              else
+                type = case value
+                       when TrueClass, FalseClass then 'MetadataBooleanValue';
+                       when DateTime then 'MetadataDateTimeValue';
+                       when Fixnum then 'MetadataNumberValue';
+                       else 'MetadataStringValue'
+                       end
+                TypedValue('xsi:type' => type) { Value value }
+              end
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.metadata.value+xml'},
+            :method  => 'PUT',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "media/#{id}/metadata/#{URI.escape(key)}"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,47 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        extend Fog::Deprecation
+        deprecate :put_vm_memory, :put_memory
+
+        # Update the RASD item that specifies memory properties of 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 [Integer] memory Memory size in Megabytes.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/PUT-Memory.html
+        # @since vCloud API version 0.9
+        def put_memory(id, memory)
+          data = <<EOF
+          <Item xmlns="http://www.vmware.com/vcloud/v1.5" xmlns:rasd="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns12="http://www.vmware.com/vcloud/v1.5" ns12:href="#{end_point}vApp/#{id}/virtualHardwareSection/memory" ns12:type="application/vnd.vmware.vcloud.rasdItem+xml" xsi:schemaLocation="http://www.vmware.com/vcloud/v1.5 http://10.194.1.65/api/v1.5/schema/master.xsd http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2.22.0/CIM_ResourceAllocationSettingData.xsd">
+            <rasd:AllocationUnits>byte * 2^20</rasd:AllocationUnits>
+            <rasd:Description>Memory Size</rasd:Description>
+            <rasd:ElementName>#{memory} MB of memory</rasd:ElementName>
+            <rasd:InstanceID>5</rasd:InstanceID>
+            <rasd:Reservation>0</rasd:Reservation>
+            <rasd:ResourceType>4</rasd:ResourceType>
+            <rasd:VirtualQuantity>#{memory}</rasd:VirtualQuantity>
+            <rasd:Weight>0</rasd:Weight>
+            <Link rel="edit" type="application/vnd.vmware.vcloud.rasdItem+xml" href="#{end_point}vApp/#{id}/virtualHardwareSection/memory"/>
+          </Item>
+EOF
+
+          request(
+            :body    => data,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.rasdItem+xml'},
+            :method  => 'PUT',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/virtualHardwareSection/memory"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -2,8 +2,10 @@ module Fog
   module Compute
     class VcloudDirector
       class Real
-
+        # deprecated Use {#put_vapp_metadata_item_metadata} instead.
         def put_metadata_value(vm_id, metadata_key, metadata_value)
+          Fog::Logger.deprecation("#{self} => ##{put_metadata_value} is deprecated, use ##{put_vapp_metadata_item_metadata} instead [light_black](#{caller.first})[/]")
+
           body="
           <MetadataValue xmlns=\"http://www.vmware.com/vcloud/v1.5\">
               <Value>#{metadata_value}</Value>
@@ -12,13 +14,12 @@ module Fog
           request(
             :body    => body,
             :expects => 202,
-            :headers => { 'Content-Type' => "application/vnd.vmware.vcloud.metadata.value+xml" },
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.metadata.value+xml'},
             :method  => 'PUT',
             :parser  => Fog::ToHashDocument.new,
             :path    => "vApp/#{vm_id}/metadata/#{URI.escape(metadata_key)}"
           )
         end
-
       end
     end
   end

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

@@ -0,0 +1,121 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        extend Fog::Deprecation
+        deprecate :put_vm_network, :put_network_connection_system_section_vapp
+
+        # Update the network connection section of 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 [Hash] options Container for the network connections of this
+        #   virtual machine.
+        # @option options [Integer] :PrimaryNetworkConnectionIndex (0)
+        #   Virtual slot number associated with the NIC that should be
+        #   considered this virtual machine's primary network connection.
+        #   Defaults to slot 0.
+        # @option options [Array<Hash>] :NetworkConnection
+        #   * :needsCustomization<~Boolean> - True if this NIC needs
+        #     customization.
+        #   * :network<~String> - Name of the network to which this NIC is
+        #     connected.
+        #   * :NetworkConnectionIndex<~Integer> - Virtual slot number
+        #     associated with this NIC. First slot number is 0.
+        #   * :IpAddress<~String> - IP address assigned to this NIC.
+        #   * :IsConnected<~Boolean> - If the virtual machine is undeployed,
+        #     this value specifies whether the NIC should be connected upon
+        #     deployment. If the virtual machine is deployed, this value
+        #     reports the current status of this NIC's connection, and can be
+        #     updated to change that connection status.
+        #   * :MACAddress<~String> - MAC address associated with the NIC.
+        #   * :IpAddressAllocationMode<~String> - IP address allocation mode
+        #     for this connection. One of:
+        #     - POOL (A static IP address is allocated automatically from a
+        #       pool of addresses.)
+        #     - DHCP (The IP address is obtained from a DHCP service.)
+        #     - MANUAL (The IP address is assigned manually in the :IpAddress
+        #       element.)
+        #     - NONE (No IP addressing mode specified.)
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #     * :Tasks<~Hash>:
+        #       * :Task<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/PUT-NetworkConnectionSystemSection-vApp.html
+        # @since vCloud API version 0.9
+        def put_network_connection_system_section_vapp(id, options={})
+          options = options.dup
+
+          # Mutate options to new format.
+          deprecated = {
+            :needs_customization => :needsCustomization,
+            :network => :network,
+            :network_connection_index => :NetworkConnectionIndex,
+            :ip_address => :IpAddress,
+            :is_connected => :IsConnected,
+            :mac_address => :MACAddress,
+            :ip_address_allocation_mode => :IpAddressAllocationMode
+          }
+          option = options.delete(:primary_network_connection_index)
+          options[:PrimaryNetworkConnectionIndex] ||= option unless option.nil?
+          unless options.key?(:NetworkConnection)
+            deprecated.each do |from, to|
+              if options.key?(from)
+                options[:NetworkConnection] ||= [{}]
+                options[:NetworkConnection].first[to] = options.delete(from)
+              end
+            end
+          end
+
+          options[:NetworkConnection] = [options[:NetworkConnection]] if options[:NetworkConnection].is_a?(Hash)
+
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5',
+              'xmlns:ovf' => 'http://schemas.dmtf.org/ovf/envelope/1'
+            }
+            NetworkConnectionSection(attrs) {
+              self[:ovf].Info 'Specifies the available VM network connections'
+              if options.key?(:PrimaryNetworkConnectionIndex)
+                PrimaryNetworkConnectionIndex options[:PrimaryNetworkConnectionIndex]
+              end
+              if network_connection = options[:NetworkConnection]
+               network_connection.each do |nic|
+                  attrs = {
+                    :network => nic[:network]
+                  }
+                  if nic.key?(:needsCustomization)
+                    attrs[:needsCustomization] = nic[:needsCustomization]
+                  end
+                  NetworkConnection(attrs) {
+                    NetworkConnectionIndex nic[:NetworkConnectionIndex]
+                    if nic.key?(:IpAddress)
+                      IpAddress nic[:IpAddress]
+                    end
+                    IsConnected nic[:IsConnected]
+                    if nic.key?(:MACAddress)
+                      MACAddress nic[:MACAddress]
+                    end
+                    IpAddressAllocationMode nic[:IpAddressAllocationMode]
+                  }
+                end
+              end
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.networkConnectionSection+xml'},
+            :method  => 'PUT',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/networkConnectionSection/"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,50 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Set the value for the specified metadata key to the value provided,
+        # overwriting any existing value.
+        #
+        # @param [String] id Object identifier of the vApp or VM.
+        # @param [String] key Key of the metadata item.
+        # @param [Boolean,DateTime,Fixnum,String] value Value of the metadata
+        #   item.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/PUT-VAppMetadataItem-metadata.html
+        # @since vCloud API version 1.5
+        def put_vapp_metadata_item_metadata(id, key, value)
+          body = Nokogiri::XML::Builder.new do
+            attrs = {
+              :xmlns => 'http://www.vmware.com/vcloud/v1.5',
+              'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance'
+            }
+            MetadataValue(attrs) {
+              if api_version.to_f < 5.1
+                Value value
+              else
+                type = case value
+                       when TrueClass, FalseClass then 'MetadataBooleanValue';
+                       when DateTime then 'MetadataDateTimeValue';
+                       when Fixnum then 'MetadataNumberValue';
+                       else 'MetadataStringValue'
+                       end
+                TypedValue('xsi:type' => type) { Value value }
+              end
+            }
+          end.to_xml
+
+          request(
+            :body    => body,
+            :expects => 202,
+            :headers => {'Content-Type' => 'application/vnd.vmware.vcloud.metadata.value+xml'},
+            :method  => 'PUT',
+            :parser  => Fog::ToHashDocument.new,
+            :path    => "vApp/#{id}/metadata/#{URI.escape(key)}"
+          )
+        end
+      end
+    end
+  end
+end