[vcloud_director] Implement post_create_catalog_item

lib/fog/vcloud_director/compute.rb

@@ -203,6 +203,7 @@ module Fog
       request :post_configure_edge_gateway_services
       request :post_consolidate_vm_vapp
       request :post_consolidate_vm_vapp_template
+      request :post_create_catalog_item
       request :post_create_org_vdc_network
       request :post_deploy_vapp
       request :post_detach_disk

lib/fog/vcloud_director/requests/compute/post_create_catalog_item.rb

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