fog-maestrodev 1.15.0.20130927082724 → 1.18.0.20131111203459

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

@@ -0,0 +1,25 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Retrieve the runtime info section of a VM.
+        #
+        # @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/GET-RuntimeInfoSectionType.html
+        # @since vCloud API version 1.5
+        def get_runtime_info_section_type(id)
+          request(
+            :expects    => 200,
+            :idempotent => true,
+            :method     => 'GET',
+            :parser     => Fog::ToHashDocument.new,
+            :path       => "vApp/#{id}/runtimeInfoSection"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Retrieve all RASD items that specify serial port properties of a VM.
+        #
+        # @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/GET-SerialPortsItemsList.html
+        # @since vCloud API version 1.5
+        def get_serial_ports_items_list(id)
+          request(
+            :expects    => 200,
+            :idempotent => true,
+            :method     => 'GET',
+            :parser     => Fog::ToHashDocument.new,
+            :path       => "vApp/#{id}/virtualHardwareSection/serialPorts"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Retrieve a shadow VM.
+        #
+        # @param [String] id The object identifier of the shadow VM.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/GET-ShadowVm.html
+        def get_shadow_vm(id)
+          request(
+            :expects    => 200,
+            :idempotent => true,
+            :method     => 'GET',
+            :parser     => Fog::ToHashDocument.new,
+            :path       => "shadowVm/#{id}"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Retrieve SnapshotSection element for a vApp or VM.
+        #
+        # @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/GET-SnapshotSection.html
+        # @since vCloud API version 5.1
+        def get_snapshot_section(id)
+          request(
+            :expects    => 200,
+            :idempotent => true,
+            :method     => 'GET',
+            :parser     => Fog::ToHashDocument.new,
+            :path       => "vApp/#{id}/snapshotSection"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Retrieve the startup section of a vApp.
+        #
+        # @param [String] id Object identifier of the vApp.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/GET-StartupSection.html
+        # @since vCloud API version 0.9
+        def get_startup_section(id)
+          request(
+            :expects    => 200,
+            :idempotent => true,
+            :method     => 'GET',
+            :parser     => Fog::ToHashDocument.new,
+            :path       => "vApp/#{id}/startupSection"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,239 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # List operating systems available for use on virtual machines owned by
+        # this organization.
+        #
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/GET-SupportedSystemsInfo.html
+        # @since vCloud API version 5.1
+        def get_supported_systems_info
+          request(
+            :expects    => 200,
+            :idempotent => true,
+            :method     => 'GET',
+            :parser     => Fog::ToHashDocument.new,
+            :path       => 'supportedSystemsInfo'
+          )
+        end
+      end
+
+      class Mock
+        def get_supported_systems_info
+          body = # this is a subset of the full list
+            {:xmlns=>xmlns,
+             :xmlns_xsi=>xmlns_xsi,
+             :type=>"application/vnd.vmware.vcloud.supportedSystemsInfo+xml",
+             :href=>make_href('supportedSystemsInfo/'),
+             :xsi_schemaLocation=>xsi_schema_location,
+             :OperatingSystemFamilyInfo=>
+              [{:Name=>"Microsoft Windows",
+                :OperatingSystemFamilyId=>"1",
+                :OperatingSystem=>
+                 [{:OperatingSystemId=>"85",
+                   :DefaultHardDiskAdapterType=>"4",
+                   :MinimumHardDiskSizeGigabytes=>"40",
+                   :MinimumMemoryMegabytes=>"512",
+                   :Name=>"Microsoft Windows Server 2012 (64-bit)",
+                   :InternalName=>"windows8Server64Guest",
+                   :Supported=>"true",
+                   :x64=>"true",
+                   :MaximumCpuCount=>"64",
+                   :MinimumHardwareVersion=>"8",
+                   :PersonalizationEnabled=>"true",
+                   :PersonalizationAuto=>"true",
+                   :SysprepPackagingSupported=>"true",
+                   :SupportsMemHotAdd=>"true",
+                   :cimOsId=>"74",
+                   :CimVersion=>"0",
+                   :SupportedForCreate=>"true"},
+                  {:OperatingSystemId=>"3",
+                   :DefaultHardDiskAdapterType=>"4",
+                   :MinimumHardDiskSizeGigabytes=>"40",
+                   :MinimumMemoryMegabytes=>"512",
+                   :Name=>"Microsoft Windows Server 2008 R2 (64-bit)",
+                   :InternalName=>"windows7Server64Guest",
+                   :Supported=>"true",
+                   :x64=>"true",
+                   :MaximumCpuCount=>"64",
+                   :MinimumHardwareVersion=>"4",
+                   :PersonalizationEnabled=>"true",
+                   :PersonalizationAuto=>"true",
+                   :SysprepPackagingSupported=>"true",
+                   :SupportsMemHotAdd=>"true",
+                   :cimOsId=>"102",
+                   :CimVersion=>"0",
+                   :SupportedForCreate=>"true"},
+                  {:OperatingSystemId=>"4",
+                   :DefaultHardDiskAdapterType=>"4",
+                   :MinimumHardDiskSizeGigabytes=>"40",
+                   :MinimumMemoryMegabytes=>"512",
+                   :Name=>"Microsoft Windows Server 2008 (32-bit)",
+                   :InternalName=>"winLonghornGuest",
+                   :Supported=>"true",
+                   :x64=>"false",
+                   :MaximumCpuCount=>"64",
+                   :MinimumHardwareVersion=>"4",
+                   :PersonalizationEnabled=>"true",
+                   :PersonalizationAuto=>"true",
+                   :SysprepPackagingSupported=>"true",
+                   :SupportsMemHotAdd=>"true",
+                   :cimOsId=>"73",
+                   :CimVersion=>"0",
+                   :SupportedForCreate=>"true"}]},
+               {:Name=>"Linux",
+                :OperatingSystemFamilyId=>"2",
+                :OperatingSystem=>
+                 [{:OperatingSystemId=>"48",
+                   :DefaultHardDiskAdapterType=>"3",
+                   :MinimumHardDiskSizeGigabytes=>"8",
+                   :MinimumMemoryMegabytes=>"64",
+                   :Name=>"Ubuntu Linux (64-bit)",
+                   :InternalName=>"ubuntu64Guest",
+                   :Supported=>"true",
+                   :x64=>"true",
+                   :MaximumCpuCount=>"64",
+                   :MinimumHardwareVersion=>"4",
+                   :PersonalizationEnabled=>"true",
+                   :PersonalizationAuto=>"true",
+                   :SysprepPackagingSupported=>"false",
+                   :SupportsMemHotAdd=>"true",
+                   :cimOsId=>"94",
+                   :CimVersion=>"0",
+                   :SupportedForCreate=>"true"},
+                  {:OperatingSystemId=>"47",
+                   :DefaultHardDiskAdapterType=>"3",
+                   :MinimumHardDiskSizeGigabytes=>"8",
+                   :MinimumMemoryMegabytes=>"64",
+                   :Name=>"Ubuntu Linux (32-bit)",
+                   :InternalName=>"ubuntuGuest",
+                   :Supported=>"true",
+                   :x64=>"false",
+                   :MaximumCpuCount=>"64",
+                   :MinimumHardwareVersion=>"4",
+                   :PersonalizationEnabled=>"true",
+                   :PersonalizationAuto=>"true",
+                   :SysprepPackagingSupported=>"false",
+                   :SupportsMemHotAdd=>"true",
+                   :cimOsId=>"93",
+                   :CimVersion=>"0",
+                   :SupportedForCreate=>"true"},
+                  {:OperatingSystemId=>"50",
+                   :DefaultHardDiskAdapterType=>"3",
+                   :MinimumHardDiskSizeGigabytes=>"8",
+                   :MinimumMemoryMegabytes=>"32",
+                   :Name=>"Other 2.6.x Linux (64-bit)",
+                   :InternalName=>"other26xLinux64Guest",
+                   :Supported=>"true",
+                   :x64=>"true",
+                   :MaximumCpuCount=>"64",
+                   :MinimumHardwareVersion=>"7",
+                   :PersonalizationEnabled=>"true",
+                   :PersonalizationAuto=>"true",
+                   :SysprepPackagingSupported=>"false",
+                   :SupportsMemHotAdd=>"true",
+                   :cimOsId=>"100",
+                   :CimVersion=>"0",
+                   :SupportedForCreate=>"true"},
+                  {:OperatingSystemId=>"49",
+                   :DefaultHardDiskAdapterType=>"3",
+                   :MinimumHardDiskSizeGigabytes=>"8",
+                   :MinimumMemoryMegabytes=>"32",
+                   :Name=>"Other 2.6.x Linux (32-bit)",
+                   :InternalName=>"other26xLinuxGuest",
+                   :Supported=>"true",
+                   :x64=>"false",
+                   :MaximumCpuCount=>"64",
+                   :MinimumHardwareVersion=>"7",
+                   :PersonalizationEnabled=>"true",
+                   :PersonalizationAuto=>"true",
+                   :SysprepPackagingSupported=>"false",
+                   :SupportsMemHotAdd=>"true",
+                   :cimOsId=>"99",
+                   :CimVersion=>"0",
+                   :SupportedForCreate=>"true"},
+                  {:OperatingSystemId=>"54",
+                   :DefaultHardDiskAdapterType=>"3",
+                   :MinimumHardDiskSizeGigabytes=>"8",
+                   :MinimumMemoryMegabytes=>"32",
+                   :Name=>"Other Linux (64-bit)",
+                   :InternalName=>"otherLinux64Guest",
+                   :Supported=>"true",
+                   :x64=>"true",
+                   :MaximumCpuCount=>"64",
+                   :MinimumHardwareVersion=>"4",
+                   :PersonalizationEnabled=>"true",
+                   :PersonalizationAuto=>"true",
+                   :SysprepPackagingSupported=>"false",
+                   :SupportsMemHotAdd=>"false",
+                   :cimOsId=>"101",
+                   :CimVersion=>"0",
+                   :SupportedForCreate=>"true"},
+                  {:OperatingSystemId=>"53",
+                   :DefaultHardDiskAdapterType=>"3",
+                   :MinimumHardDiskSizeGigabytes=>"8",
+                   :MinimumMemoryMegabytes=>"32",
+                   :Name=>"Other Linux (32-bit)",
+                   :InternalName=>"otherLinuxGuest",
+                   :Supported=>"true",
+                   :x64=>"false",
+                   :MaximumCpuCount=>"64",
+                   :MinimumHardwareVersion=>"4",
+                   :PersonalizationEnabled=>"true",
+                   :PersonalizationAuto=>"true",
+                   :SysprepPackagingSupported=>"false",
+                   :SupportsMemHotAdd=>"false",
+                   :cimOsId=>"36",
+                   :CimVersion=>"0",
+                   :SupportedForCreate=>"true"}]},
+               {:Name=>"Other",
+                :OperatingSystemFamilyId=>"3",
+                :OperatingSystem=>
+                 [{:OperatingSystemId=>"68",
+                   :DefaultHardDiskAdapterType=>"3",
+                   :MinimumHardDiskSizeGigabytes=>"8",
+                   :MinimumMemoryMegabytes=>"32",
+                   :Name=>"Other (64-bit)",
+                   :InternalName=>"otherGuest64",
+                   :Supported=>"true",
+                   :x64=>"true",
+                   :MaximumCpuCount=>"64",
+                   :MinimumHardwareVersion=>"4",
+                   :PersonalizationEnabled=>"false",
+                   :PersonalizationAuto=>"false",
+                   :SysprepPackagingSupported=>"false",
+                   :SupportsMemHotAdd=>"true",
+                   :cimOsId=>"102",
+                   :CimVersion=>"0",
+                   :SupportedForCreate=>"true"},
+                  {:OperatingSystemId=>"67",
+                   :DefaultHardDiskAdapterType=>"3",
+                   :MinimumHardDiskSizeGigabytes=>"8",
+                   :MinimumMemoryMegabytes=>"32",
+                   :Name=>"Other (32-bit)",
+                   :InternalName=>"otherGuest",
+                   :Supported=>"true",
+                   :x64=>"false",
+                   :MaximumCpuCount=>"64",
+                   :MinimumHardwareVersion=>"4",
+                   :PersonalizationEnabled=>"false",
+                   :PersonalizationAuto=>"false",
+                   :SysprepPackagingSupported=>"false",
+                   :SupportsMemHotAdd=>"true",
+                   :cimOsId=>"1",
+                   :CimVersion=>"0",
+                   :SupportedForCreate=>"true"}]}]}
+
+          Excon::Response.new(
+            :status => 200,
+            :headers => {'Content-Type' => "#{body[:type]};version=#{api_version}"},
+            :body => body
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -2,17 +2,16 @@ module Fog
   module Compute
     class VcloudDirector
       class Real
-        # Retrieve the supported versions.
+        # List all supported versions.
         #
-        # === Returns
-        # * response<~Excon::Response>:
+        # @return [Excon::Response]
         #   * body<~Hash>:
         #
-        # {vCloud API Documentation}[http://pubs.vmware.com/vcd-55/topic/com.vmware.vcloud.api.reference.doc_55/doc/operations/GET-SupportedVersions.html]
+        # @see http://pubs.vmware.com/vcd-55/topic/com.vmware.vcloud.api.reference.doc_55/doc/operations/GET-SupportedVersions.html
+        # @since vCloud API version 0.9
         def get_supported_versions
           @connection.request(
             :expects    => 200,
-            :host       => @host,
             :idempotent => true,
             :method     => 'GET',
             :parser     => Fog::ToHashDocument.new,

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

@@ -1,17 +1,167 @@
+require 'date'
+
 module Fog
   module Compute
     class VcloudDirector
       class Real
+        # Retrieve a task.
+        #
+        # @param [String] id The object identifier of the task.
+        # @return [Excon::Response]
+        #   * body<~Hash>:
+        #     * :href<~String> - The URI of the entity.
+        #     * :type<~String> - The MIME type of the entity.
+        #     * :id<~String> - The entity identifier, expressed in URN format.
+        #       The value of this attribute uniquely identifies the entity,
+        #       persists for the life of the entity, and is never reused.
+        #     * :operationKey<~String> - Optional unique identifier to support
+        #       idempotent semantics for create and delete operations.
+        #     * :name<~String> - The name of the entity.
+        #     * :cancelRequested<~String> - Whether user has requested this
+        #       processing to be canceled.
+        #     * :endTime<~String> - The date and time that processing of the
+        #       task was completed. May not be present if the task is still
+        #       being executed.
+        #     * :expiryTime<~String> - The date and time at which the task
+        #       resource will be destroyed and no longer available for
+        #       retrieval. May not be present if the task has not been executed
+        #       or is still being executed.
+        #     * :operation<~String> - A message describing the operation that
+        #       is tracked by this task.
+        #     * :operationName<~String> - The short name of the operation that
+        #       is tracked by this task.
+        #     * :serviceNamespace<~String> - Identifier of the service that
+        #       created the task.
+        #     * :startTime<~String> - The date and time the system started
+        #       executing the task. May not be present if the task has not been
+        #       executed yet.
+        #     * :status<~String> - The execution status of the task.
+        #     * :Link<~Array<Hash>>:
+        #     * :Description<~String> - Optional description.
+        #     * :Owner<~Hash> - Reference to the owner of the task. This is
+        #       typically the object that the task is creating or updating.
+        #       * :href<~String> - Contains the URI to the entity.
+        #       * :name<~String> - Contains the name of the entity.
+        #       * :type<~String> - Contains the type of the entity.
+        #     * :Error<~Hash> - Represents error information from a failed
+        #       task.
+        #       * :majorErrorCode<~String> - The class of the error. Matches
+        #         the HTTP status code.
+        #       * :message<~String> - An one line, human-readable message
+        #         describing the error that occurred.
+        #       * :minorErrorCode<~String> - Resource-specific error code.
+        #       * :stackTrace<~String> - The stack trace of the exception.
+        #       * :vendorSpecificErrorCode<~String> - A vendor- or
+        #         implementation-specific error code that can reference
+        #         specific modules or source lines for diagnostic purposes.
+        #     * :User<~Hash> - The user who started the task.
+        #       * :href<~String> - Contains the URI to the entity.
+        #       * :name<~String> - Contains the name of the entity.
+        #       * :type<~String> - Contains the type of the entity.
+        #     * :Organization<~Hash> - The organization to which the :User
+        #       belongs.
+        #       * :href<~String> - Contains the URI to the entity.
+        #       * :name<~String> - Contains the name of the entity.
+        #       * :type<~String> - Contains the type of the entity.
+        #     * :Progress<~String> - Read-only indicator of task progress as an
+        #       approximate percentage between 0 and 100. Not available for all
+        #       tasks.
+        #     * :Params
+        #     * :Details<~String> - Detailed message about the task. Also
+        #       contained by the :Owner entity when task status is preRunning.
+        #
+        # @raise [Fog::Compute::VcloudDirector::Forbidden]
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/GET-Task.html
+        # @since vCloud API version 0.9
+        def get_task(id)
+          response = request(
+            :expects    => 200,
+            :idempotent => true,
+            :method     => 'GET',
+            :parser     => Fog::ToHashDocument.new,
+            :path       => "task/#{id}"
+          )
+
+          # vCloud Director bug: Owner may be absent for some tasks, fix
+          # targeted for 5.1.3 (due out at the beginning Q1 2014).
+          #
+          # We'd prefer that Owner is always present; if nothing else, this
+          # let's the tests pass.
+          response.body[:Owner] ||= {:href => '', :name => nil, :type => nil}
+
+          response
+        end
+      end
+
+      class Mock
+        def get_task(id)
+          unless data[:tasks][id]
+            raise Fog::Compute::VcloudDirector::Forbidden.new(
+              'This operation is denied.'
+            )
+          end
 
-        def get_task(task_id)
-          request(
-            :expects => 200,
-            :method  => 'GET',
-            :parser  => Fog::ToHashDocument.new,
-            :path    => "task/#{task_id}"
+          body = {
+            :xmlns => xmlns,
+            :xmlns_xsi => xmlns_xsi,
+            :xsi_schemaLocation => xsi_schema_location
+          }.merge(task_body(id))
+
+          Excon::Response.new(
+            :status => 200,
+            :headers => {'Type' => "application/#{body[:type]};version=#{api_version}"},
+            :body => body
           )
         end
 
+        private
+
+        # @param [String] id Object identifier of the task.
+        # @return [Hash]
+        def task_body(id)
+          task = data[:tasks][id]
+
+          body = {
+            :href => make_href("tasks/#{id}"),
+            :type => 'application/vnd.vmware.vcloud.task+xml',
+            :id => "urn:vcloud:tasl:#{id}",
+            :name => task[:name],
+            :cancelRequested => task[:cancel_requested].to_s,
+            :expiryTime => task[:expiry_time].strftime('%Y-%m-%dT%H:%M:%S%z'),
+            :operation => task[:operation],
+            :operationName => task[:operation_name],
+            :serviceNamespace => task[:service_namespace],
+            :status => task[:status],
+            :Link => [],
+            :Owner => task[:owner],
+            :User => { # for now, always the current user
+              :href => make_href("admin/user/#{user_uuid}"),
+              :name => user_name,
+              :type => 'application/vnd.vmware.admin.user+xml',
+            },
+            :Organization => { # for now, always the current org
+              :href => make_href("org/#{data[:org][:uuid]}"),
+              :name => data[:org][:name],
+              :type => 'application/vnd.vmware.vcloud.org+xml',
+            },
+            :Progress => task[:progress].to_s,
+            :Details => task[:details] || '',
+          }
+          body[:endTime] = task[:end_time].strftime('%Y-%m-%dT%H:%M:%S%z') if task[:end_time]
+          body[:startTime] = task[:start_time].strftime('%Y-%m-%dT%H:%M:%S%z') if task[:start_time]
+          body[:Description] = task[:description] if task[:description]
+
+          if task[:status] == 'running'
+            body[:Link] << {
+              :href => make_href("task/#{id}/action/cancel"),
+              :type => 'application/vnd.vmware.vcloud.task+xml',
+              :rel => 'cancel',
+            }
+          end
+
+          body
+        end
       end
     end
   end