fog-maestrodev 1.15.0.20130927082724 → 1.18.0.20131111203459

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

@@ -0,0 +1,462 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # REST API General queries handler.
+        #
+        # @param [String] type The type of the query. Type names are
+        #   case-sensitive. You can retrieve a summary list of all typed
+        #   queries types accessible to the currently authenticated user by
+        #   making a request with type=nil.
+        # @param [Hash] options
+        # @option options [String] :sortAsc (Sorted by database ID) Sort
+        #   results by attribute-name in ascending order. attribute-name cannot
+        #   include metadata.
+        # @option options [String] :sortDesc (Sorted by database ID) Sort
+        #   results by attribute-name in descending order. attribute-name
+        #   cannot include metadata.
+        # @option options [Integer] :page (1) If the query results span
+        #   multiple pages, return this page.
+        # @option options [Integer] :pageSize (25) Number of results per page,
+        #   to a maximum of 128.
+        # @option options [String] :format (records) One of the following
+        #   types:
+        #   - *references* Returns a reference to each object, including its
+        #     :name, :type, and :href attributes.
+        #   - *records* Returns all database records for each object, with each
+        #     record as an attribute.
+        #   - *idrecords* Identical to the records format, except that object
+        #     references are returned in :id format rather than :href format.
+        # @option options [Array<String>] :fields (all static attribute names)
+        #   List of attribute names or metadata key names to return.
+        # @option options [Integer] :offset (0) Integer value specifying the
+        #   first record to return. Record numbers < offset are not returned.
+        # @option options [String] :filter (none) Filter expression.
+        # @return [Excon::Response] if type is specified.
+        #   * hash<~Hash>:
+        #     * :href<~String> - The URI of the entity.
+        #     * :type<~String> - The MIME type of the entity.
+        #     * :name<~String> - Query name that generated this result set.
+        #     * :page<~String> - Page of the result set that this container
+        #       holds. The first page is page number 1.
+        #     * :pageSize<~String> - Page size, as a number of records or
+        #       references.
+        #     * :total<~String> - Total number of records or references in the
+        #       container.
+        #     * :Link<~Array<Hash>>:
+        #       * :href<~String> - Contains the URI to the entity.
+        #       * :type<~String> - Contains the type of the entity.
+        #       * :rel<~String> - Defines the relationship of the link to the
+        #         object that contains it.
+        #     * :Record<~Array<Hash>> - The name and content of this item
+        #       varies according to the type and format of the query.
+        #     * :firstPage<~Integer> - First page in the result set.
+        #     * :previousPage<~Integer> - Previous page in the result set.
+        #     * :nextPage<~Integer> - Next page in the result set.
+        #     * :lastPage<~Integer> - Last page in the result set.
+        # @return [Excon::Response] if type is nil.
+        #   * hash<~Hash>:
+        #     * :href<~String> - The URI of the entity.
+        #     * :type<~String> - The MIME type of the entity.
+        #     * :Link<~Array<Hash>>:
+        #       * :href<~String> - Contains the URI to the entity.
+        #       * :name<~String> - Contains the name of the entity.
+        #       * :type<~String> - Contains the type of the entity.
+        #       * :rel<~String> - Defines the relationship of the link to the
+        #         object that contains it.
+        #
+        # @see http://pubs.vmware.com/vcd-55/topic/com.vmware.vcloud.api.reference.doc_55/doc/operations/GET-ExecuteQuery.html
+        # @since vCloud API version 1.5
+        def get_execute_query(type=nil, options={})
+          if type.nil?
+            response = request(
+              :expects    => 200,
+              :idempotent => true,
+              :method     => 'GET',
+              :parser     => Fog::ToHashDocument.new,
+              :path       => 'query'
+            )
+          else
+            query = ["type=#{type}"]
+            query << "sortAsc=#{options[:sortAsc]}" if options[:sortAsc]
+            query << "sortDesc=#{options[:sortDesc]}" if options[:sortDesc]
+            query << "page=#{options[:page]}" if options[:page]
+            query << "pageSize=#{options[:pageSize]}" if options[:pageSize]
+            query << "format=#{options[:format]}" if options[:format]
+            query << "fields=#{Array(options[:fields]).join(',')}" if options[:fields]
+            query << "offset=#{options[:offset]}" if options[:offset]
+            query << "filter=#{options[:filter]}" if options[:filter]
+
+            response = request(
+              :expects    => 200,
+              :idempotent => true,
+              :method     => 'GET',
+              :parser     => Fog::ToHashDocument.new,
+              :path       => 'query',
+              :query      => query.map {|q| URI.escape(q)}.join('&')
+            )
+            ensure_list! response.body, :Link
+            # TODO: figure out the right key (this isn't it)
+            #ensure_list! response.body,
+            #  response.body[:type] == 'application/vnd.vmware.vcloud.query.references+xml' ?
+            #    "#{response.body[:name]}Reference".to_sym :
+            #    "#{response.body[:name]}Record".to_sym
+
+            %w[firstPage previousPage nextPage lastPage].each do |rel|
+              if link = response.body[:Link].detect {|l| l[:rel] == rel}
+                href = Nokogiri::XML.fragment(link[:href])
+                query = CGI.parse(URI.parse(href.text).query)
+                response.body[rel.to_sym] = query['page'].first.to_i
+                response.body[:pageSize] ||= query['pageSize'].first.to_i
+              end
+            end
+
+            response
+          end
+        end
+      end
+
+      class Mock
+        def get_execute_query(type=nil, options={})
+          if type.nil?
+            body =
+              {:xmlns=>xmlns,
+               :xmlns_xsi=>xmlns_xsi,
+               :type=>"application/vnd.vmware.vcloud.query.queryList+xml",
+               :href=>make_href('query'),
+               :xsi_schemaLocation=>xsi_schema_location,
+               :Link=>
+                [{:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"organization",
+                  :href=>make_href('query?type=organization&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"organization",
+                  :href=>make_href('query?type=organization&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"organization",
+                  :href=>make_href('query?type=organization&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"orgVdc",
+                  :href=>make_href('query?type=orgVdc&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"orgVdc",
+                  :href=>make_href('query?type=orgVdc&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"orgVdc",
+                  :href=>make_href('query?type=orgVdc&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"media",
+                  :href=>make_href('query?type=media&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"media",
+                  :href=>make_href('query?type=media&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"media",
+                  :href=>make_href('query?type=media&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"vAppTemplate",
+                  :href=>make_href('query?type=vAppTemplate&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"vAppTemplate",
+                  :href=>make_href('query?type=vAppTemplate&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"vAppTemplate",
+                  :href=>make_href('query?type=vAppTemplate&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"vApp",
+                  :href=>make_href('query?type=vApp&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"vApp",
+                  :href=>make_href('query?type=vApp&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"vApp",
+                  :href=>make_href('query?type=vApp&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"vm",
+                  :href=>make_href('query?type=vm&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"vm",
+                  :href=>make_href('query?type=vm&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"vm",
+                  :href=>make_href('query?type=vm&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"orgNetwork",
+                  :href=>make_href('query?type=orgNetwork&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"orgNetwork",
+                  :href=>make_href('query?type=orgNetwork&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"orgNetwork",
+                  :href=>make_href('query?type=orgNetwork&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"vAppNetwork",
+                  :href=>make_href('query?type=vAppNetwork&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"vAppNetwork",
+                  :href=>make_href('query?type=vAppNetwork&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"vAppNetwork",
+                  :href=>make_href('query?type=vAppNetwork&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"catalog",
+                  :href=>make_href('query?type=catalog&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"catalog",
+                  :href=>make_href('query?type=catalog&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"catalog",
+                  :href=>make_href('query?type=catalog&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"group",
+                  :href=>make_href('query?type=group&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"group",
+                  :href=>make_href('query?type=group&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"group",
+                  :href=>make_href('query?type=group&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"user",
+                  :href=>make_href('query?type=user&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"user",
+                  :href=>make_href('query?type=user&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"user",
+                  :href=>make_href('query?type=user&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"strandedUser",
+                  :href=>make_href('query?type=strandedUser&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"strandedUser",
+                  :href=>make_href('query?type=strandedUser&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"strandedUser",
+                  :href=>make_href('query?type=strandedUser&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"role",
+                  :href=>make_href('query?type=role&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"role",
+                  :href=>make_href('query?type=role&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"role",
+                  :href=>make_href('query?type=role&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"allocatedExternalAddress",
+                  :href=>make_href('query?type=allocatedExternalAddress&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"allocatedExternalAddress",
+                  :href=>make_href('query?type=allocatedExternalAddress&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"event",
+                  :href=>make_href('query?type=event&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"event",
+                  :href=>make_href('query?type=event&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"right",
+                  :href=>make_href('query?type=right&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"right",
+                  :href=>make_href('query?type=right&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"right",
+                  :href=>make_href('query?type=right&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"vAppOrgNetworkRelation",
+                  :href=>make_href('query?type=vAppOrgNetworkRelation&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"vAppOrgNetworkRelation",
+                  :href=>make_href('query?type=vAppOrgNetworkRelation&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"vAppOrgNetworkRelation",
+                  :href=>make_href('query?type=vAppOrgNetworkRelation&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"catalogItem",
+                  :href=>make_href('query?type=catalogItem&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"catalogItem",
+                  :href=>make_href('query?type=catalogItem&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"catalogItem",
+                  :href=>make_href('query?type=catalogItem&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"task",
+                  :href=>make_href('query?type=task&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"task",
+                  :href=>make_href('query?type=task&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"task",
+                  :href=>make_href('query?type=task&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"disk",
+                  :href=>make_href('query?type=disk&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"disk",
+                  :href=>make_href('query?type=disk&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"disk",
+                  :href=>make_href('query?type=disk&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"vmDiskRelation",
+                  :href=>make_href('query?type=vmDiskRelation&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"vmDiskRelation",
+                  :href=>make_href('query?type=vmDiskRelation&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"service",
+                  :href=>make_href('query?type=service&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"service",
+                  :href=>make_href('query?type=service&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"service",
+                  :href=>make_href('query?type=service&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"orgVdcStorageProfile",
+                  :href=>make_href('query?type=orgVdcStorageProfile&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"orgVdcStorageProfile",
+                  :href=>make_href('query?type=orgVdcStorageProfile&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"orgVdcStorageProfile",
+                  :href=>make_href('query?type=orgVdcStorageProfile&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"apiDefinition",
+                  :href=>make_href('query?type=apiDefinition&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"apiDefinition",
+                  :href=>make_href('query?type=apiDefinition&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"apiDefinition",
+                  :href=>make_href('query?type=apiDefinition&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"fileDescriptor",
+                  :href=>make_href('query?type=fileDescriptor&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"fileDescriptor",
+                  :href=>make_href('query?type=fileDescriptor&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"edgeGateway",
+                  :href=>make_href('query?type=edgeGateway&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"edgeGateway",
+                  :href=>make_href('query?type=edgeGateway&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"edgeGateway",
+                  :href=>make_href('query?type=edgeGateway&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"orgVdcNetwork",
+                  :href=>make_href('query?type=orgVdcNetwork&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"orgVdcNetwork",
+                  :href=>make_href('query?type=orgVdcNetwork&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"orgVdcNetwork",
+                  :href=>make_href('query?type=orgVdcNetwork&#38;format=idrecords')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.references+xml",
+                  :name=>"vAppOrgVdcNetworkRelation",
+                  :href=>make_href('query?type=vAppOrgVdcNetworkRelation&#38;format=references')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.records+xml",
+                  :name=>"vAppOrgVdcNetworkRelation",
+                  :href=>make_href('query?type=vAppOrgVdcNetworkRelation&#38;format=records')},
+                 {:rel=>"down",
+                  :type=>"application/vnd.vmware.vcloud.query.idrecords+xml",
+                  :name=>"vAppOrgVdcNetworkRelation",
+                  :href=>make_href('query?type=vAppOrgVdcNetworkRelation&#38;format=idrecords')}]}
+
+            Excon::Response.new(
+              :status  => 200,
+              :headers => {'Content-Type' => "#{body[:type]};version=#{api_version}"},
+              :body    => body
+            )
+          else
+            Fog::Mock.not_implemented
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,95 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Retrieves a list of groups for organization the org admin belongs to
+        # by using REST API general QueryHandler.
+        #
+        # @param [Hash] options
+        # @option options [String] :sortAsc (Sorted by database ID) Sort
+        #   results by attribute-name in ascending order. attribute-name cannot
+        #   include metadata.
+        # @option options [String] :sortDesc (Sorted by database ID) Sort
+        #   results by attribute-name in descending order. attribute-name
+        #   cannot include metadata.
+        # @option options [Integer] :page (1) If the query results span
+        #   multiple pages, return this page.
+        # @option options [Integer] :pageSize (25) Number of results per page,
+        #   to a maximum of 128.
+        # @option options [String] :format (records) One of the following
+        #   types:
+        #   - *references* Returns a reference to each object, including its
+        #     :name, :type, and :href attributes.
+        #   - *records* Returns all database records for each object, with each
+        #     record as an attribute.
+        #   - *idrecords* Identical to the records format, except that object
+        #     references are returned in :id format rather than :href format.
+        # @option options [Array<String>] :fields (all static attribute names)
+        #   List of attribute names or metadata key names to return.
+        # @option options [Integer] :offset (0) Integer value specifying the
+        #   first record to return. Record numbers < offset are not returned.
+        # @option options [String] :filter (none) Filter expression.
+        # @return [Excon::Response]
+        #   * hash<~Hash>:
+        #     * :href<~String> - The URI of the entity.
+        #     * :type<~String> - The MIME type of the entity.
+        #     * :name<~String> - Query name that generated this result set.
+        #     * :page<~String> - Page of the result set that this container
+        #       holds. The first page is page number 1.
+        #     * :pageSize<~String> - Page size, as a number of records or
+        #       references.
+        #     * :total<~String> - Total number of records or references in the
+        #       container.
+        #     * :Link<~Array<Hash>>:
+        #       * :href<~String> - Contains the URI to the entity.
+        #       * :type<~String> - Contains the type of the entity.
+        #       * :rel<~String> - Defines the relationship of the link to the
+        #         object that contains it.
+        #     * :GroupRecord<~Array<Hash>>:
+        #       * TODO
+        #     * :firstPage<~Integer> - First page in the result set.
+        #     * :previousPage<~Integer> - Previous page in the result set.
+        #     * :nextPage<~Integer> - Next page in the result set.
+        #     * :lastPage<~Integer> - Last page in the result set.
+        #
+        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/GET-GroupsFromQuery.html
+        # @since vCloud API version 1.5
+        def get_groups_from_query(options={})
+          query = []
+          query << "sortAsc=#{options[:sortAsc]}" if options[:sortAsc]
+          query << "sortDesc=#{options[:sortDesc]}" if options[:sortDesc]
+          query << "page=#{options[:page]}" if options[:page]
+          query << "pageSize=#{options[:pageSize]}" if options[:pageSize]
+          query << "format=#{options[:format]}" if options[:format]
+          query << "fields=#{Array(options[:fields]).join(',')}" if options[:fields]
+          query << "offset=#{options[:offset]}" if options[:offset]
+          query << "filter=#{options[:filter]}" if options[:filter]
+
+          response = request(
+            :expects    => 200,
+            :idempotent => true,
+            :method     => 'GET',
+            :parser     => Fog::ToHashDocument.new,
+            :path       => 'admin/groups/query',
+            :query      => query.map {|q| URI.escape(q)}.join('&')
+          )
+          ensure_list! response.body, :Link
+          ensure_list! response.body,
+            response.body[:type] == 'application/vnd.vmware.vcloud.query.references+xml' ?
+              :GroupReference : :GroupRecord
+
+          %w[firstPage previousPage nextPage lastPage].each do |rel|
+            if link = response.body[:Link].detect {|l| l[:rel] == rel}
+              href = Nokogiri::XML.fragment(link[:href])
+              query = CGI.parse(URI.parse(href.text).query)
+              response.body[rel.to_sym] = query['page'].first.to_i
+              response.body[:pageSize] ||= query['pageSize'].first.to_i
+            end
+          end
+
+          response
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Retrieves the guest customization 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-GuestCustomizationSystemSection-vApp.html
+        # @since vCloud API version 1.0
+        def get_guest_customization_system_section_vapp(id)
+          request(
+            :expects    => 200,
+            :idempotent => true,
+            :method     => 'GET',
+            :parser     => Fog::ToHashDocument.new,
+            :path       => "vApp/#{id}/guestCustomizationSection"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Retrieves the guest customization 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-GuestCustomizationSystemSection-vAppTemplate.html
+        # @since vCloud API version 1.0
+        def get_guest_customization_system_section_vapp_template(id)
+          request(
+            :expects    => 200,
+            :idempotent => true,
+            :method     => 'GET',
+            :parser     => Fog::ToHashDocument.new,
+            :path       => "vAppTemplate/#{id}/guestCustomizationSection"
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -2,17 +2,19 @@ module Fog
   module Compute
     class VcloudDirector
       class Real
-
+        # This is used for manual testing.
+        #
+        # @api private
         def get_href(href)
           request(
             :expects       => 200,
+            :idempotent    => true,
             :method        => 'GET',
             :parser        => Fog::ToHashDocument.new,
             :override_path => true,
             :path          => URI.parse(href).path
           )
         end
-
       end
     end
   end

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

@@ -0,0 +1,25 @@
+module Fog
+  module Compute
+    class VcloudDirector
+      class Real
+        # Retrieves the lease settings 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-LeaseSettingsSection-vApp.html
+        # @since vCloud API version 1.0
+        def get_lease_settings_section_vapp(id)
+          request(
+            :expects    => 200,
+            :idempotent => true,
+            :method     => 'GET',
+            :parser     => Fog::ToHashDocument.new,
+            :path       => "vApp/#{id}/leaseSettingsSection"
+          )
+        end
+      end
+    end
+  end
+end