fog 1.5.0 → 1.6.0

data/lib/fog/aws/requests/glacier/delete_vault.rb

@@ -0,0 +1,34 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        # Delete a vault. Amazon Glacier will delete a vault only if there are no archives in the vault as per the last inventory
+        # and there have been no writes to the vault since the last inventory
+        #
+        # ==== Parameters
+        # * name<~String> Name of the vault to delete
+        # * options<~Hash>
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-vault-delete.html
+        #
+        def delete_vault(name,options={})
+          account_id = options['account_id'] || '-'
+          path = "/#{account_id}/vaults/#{Fog::AWS.escape(name)}"
+          request(
+            :expects  => 204,
+            :idempotent => true,
+            :headers => {},
+            :method   => :delete,
+            :path     => path
+          )
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/glacier/delete_vault_notification_configuration.rb

@@ -0,0 +1,33 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        # Delete vault's notification configuration
+        #
+        # ==== Parameters
+        # * name<~String> Name of the vault
+        # * options<~Hash>
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-vault-notifications-delete.html
+        #
+        def delete_vault_notification_configuration(name,options={})
+          account_id = options['account_id'] || '-'
+          path = "/#{account_id}/vaults/#{Fog::AWS.escape(name)}/notification-configuration"
+          request(
+            :expects  => 204,
+            :idempotent => true,
+            :headers => {},
+            :method   => :delete,
+            :path     => path
+          )
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/glacier/describe_job.rb

@@ -0,0 +1,35 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        # Complete an upload
+        #
+        # ==== Parameters
+        # * name<~String> Name of the vault
+        # * job_id<~String> The id of the job
+        # * options<~Hash>
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-describe-job-get.html
+        #
+        def describe_job(vault_name, job_id, options={})
+          account_id = options['account_id'] || '-'
+          path = "/#{account_id}/vaults/#{Fog::AWS.escape(vault_name)}/jobs/#{job_id}"
+
+          request(
+            :expects  => 200,
+            :idempotent => true,
+            :headers => {},
+            :method   => :get,
+            :path     => path
+          )
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/glacier/describe_vault.rb

@@ -0,0 +1,34 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        # This operation returns information about a vault
+        #
+        # ==== Parameters
+        # * name<~String> Vault name
+        # * options<~Hash>
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-vault-get.html
+        #
+        def describe_vault(name,options={})
+          account_id = options['account_id'] || '-'
+          path = "/#{account_id}/vaults/#{Fog::AWS.escape(name)}"
+          request(
+            :expects  => 200,
+            :idempotent => true,
+            :headers => {},
+            :method   => :get,
+            :path     => path
+          )
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/glacier/get_job_output.rb

@@ -0,0 +1,41 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        # Get the output from a job
+        #
+        # ==== Parameters
+        # * name<~String> Name of the vault
+        # * job_id<~String> The id of the job
+        # * options<~Hash>
+        #   * Range<~Range> The range to retrieve
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        #   * response_block<~Proc> Proc to use for streaming the response
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-job-output-get.html
+        #
+        def get_job_output(vault_name, job_id, options={})
+          account_id = options.delete('account_id') || '-'
+          path = "/#{account_id}/vaults/#{Fog::AWS.escape(vault_name)}/jobs/#{job_id}/output"
+          headers = {}
+          if range = options.delete('Range')
+            headers['Range'] = "bytes=#{range.begin}-#{range.end}"
+          end
+          request(
+            options.merge(
+            :expects  => [200,206],
+            :idempotent => true,
+            :headers => headers,
+            :method   => :get,
+            :path     => path
+          ))
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/glacier/get_vault_notification_configuration.rb

@@ -0,0 +1,34 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        # Get a vault's notification configuration
+        #
+        # ==== Parameters
+        # * name<~String> Name of the vault
+        # * options<~Hash>
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-vault-notifications-get.html
+        #
+        def get_vault_notification_configuration(name,options={})
+          account_id = options['account_id'] || '-'
+          path = "/#{account_id}/vaults/#{Fog::AWS.escape(name)}/notification-configuration"
+          request(
+            :expects  => 200,
+            :idempotent => true,
+            :headers => {},
+            :method   => :get,
+            :path     => path
+          )
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/glacier/initiate_job.rb

@@ -0,0 +1,41 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        # This operation initates a multipart upload of an archive to a vault
+        #
+        # ==== Parameters
+        # * name<~String> The vault name
+        # * job_specification<~Hash> A specification of the job
+        #    * Type<~String> The job type. Mandatory. Values: archive-retrieval, inventory-retrieval
+        #    * Description<~String> The job description
+        #    * ArchiveId<~String> The id of the archive to retrieve (only for Type==archive-retrieval)
+        #    * Format<~String> The format to return (only for inventory retrieval). Values: CSV, JSON
+        #    * SNSTopic<String> ARN of a topic to publish to when the job is complete
+        # * options<~Hash>
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-initiate-job-post.html
+        #
+        def initiate_job(name, job_specification, options={})
+          account_id = options['account_id'] || '-'
+          path = "/#{account_id}/vaults/#{Fog::AWS.escape(name)}/jobs"
+
+          request({
+            :expects  => 202,
+            :headers => {},
+            :method   => 'POST',
+            :path     => path,
+            :body     => Fog::JSON.encode(job_specification)
+          })
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/glacier/initiate_multipart_upload.rb

@@ -0,0 +1,38 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        # This operation initates a multipart upload of an archive to a vault
+        #
+        # ==== Parameters
+        # * name<~String> The vault name
+        # * part_size<~Integer> The part size to use. Must be a power of 2 multiple of 1MB (1,2,4,8,16,...)
+        # * options<~Hash>
+        #   * description<~String> - The archive description
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-multipart-initiate-upload.html
+        #
+        def initiate_multipart_upload(name, part_size, options={})
+          account_id = options['account_id'] || '-'
+          path = "/#{account_id}/vaults/#{Fog::AWS.escape(name)}/multipart-uploads"
+
+          headers = {'x-amz-part-size' => part_size.to_s}
+          headers['x-amz-archive-description'] = options['description'] if options['description']
+          request(
+            :expects  => 201,
+            :headers => headers,
+            :method   => 'POST',
+            :path     => path
+          )
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/glacier/list_jobs.rb

@@ -0,0 +1,39 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        #  lists in-progress and recently jobs for the specified vault
+        #
+        # ==== Parameters
+        # * name<~String> Name of the vault
+        # * options<~Hash>
+        #   * completed<~Boolean>Specifies the state of the jobs to return. You can specify true or false
+        #   * statuscode<~String> Filter returned jobs by status (InProgress, Succeeded, or Failed)
+        #   * limit<~Integer> - The maximum number of items returned in the response. (default 1000)
+        #   * marker<~String> - marker used for pagination
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        # ==== Returns
+        # * response<~Excon::Response>:
+        # ==== See Also
+        #http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-jobs-get.html
+        #
+        def list_jobs(vault_name, options={})
+          account_id = options.delete('account_id') || '-'
+          path = "/#{account_id}/vaults/#{Fog::AWS.escape(vault_name)}/jobs"
+
+
+          request(
+            :expects  => 200,
+            :idempotent => true,
+            :headers => {},
+            :method   => :get,
+            :path     => path,
+            :query => options
+          )
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/glacier/list_multipart_uploads.rb

@@ -0,0 +1,37 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        #  lists in-progress multipart uploads for the specified vault
+        #
+        # ==== Parameters
+        # * name<~String> Name of the vault
+        # * options<~Hash>
+        #   * limit<~Integer> - The maximum number of items returned in the response. (default 1000)
+        #   * marker<~String> - marker used for pagination
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        # ==== Returns
+        # * response<~Excon::Response>:
+        # ==== See Also
+        # http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-multipart-list-uploads.html
+        #
+        def list_multipart_uploads(vault_name, options={})
+          account_id = options.delete('account_id') || '-'
+          path = "/#{account_id}/vaults/#{Fog::AWS.escape(vault_name)}/multipart-uploads"
+
+
+          request(
+            :expects  => 200,
+            :idempotent => true,
+            :headers => {},
+            :method   => :get,
+            :path     => path,
+            :query => options
+          )
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/glacier/list_parts.rb

@@ -0,0 +1,37 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        #  lists the parts of an archive that have been uploaded in a specific multipart upload
+        #
+        # ==== Parameters
+        # * name<~String> Name of the vault
+        # * upload_id<~String> The id of the upload
+        # * options<~Hash>
+        #   * limit<~Integer> - The maximum number of items returned in the response. (default 1000)
+        #   * marker<~String> - marker used for pagination
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        # ==== Returns
+        # * response<~Excon::Response>:
+        # ==== See Also
+        # http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-multipart-list-parts.html
+        #
+        def list_parts(vault_name, upload_id, options={})
+          account_id = options.delete('account_id') || '-'
+          path = "/#{account_id}/vaults/#{Fog::AWS.escape(vault_name)}/multipart-uploads/#{Fog::AWS.escape(upload_id)}"
+
+          request(
+            :expects  => 200,
+            :idempotent => true,
+            :headers => {},
+            :method   => :get,
+            :path     => path,
+            :query    => options
+          )
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/glacier/list_vaults.rb

@@ -0,0 +1,36 @@
+module Fog
+  module AWS
+    class Glacier
+      class Real
+
+        # This operation lists all vaults owned by the calling user’s account.
+        #
+        # ==== Parameters
+        # * options<~Hash>
+        #   * limit<~Integer> - The maximum number of items returned in the response. (default 1000)
+        #   * marker<~String> - marker used for pagination
+        #   * account_id<~String> - The AWS account id. Defaults to the account owning the credentials making the request
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/amazonglacier/latest/dev/api-vaults-get.html
+        #
+        def list_vaults(options={})
+          account_id = options.delete('account_id') || '-'
+          path = "/#{account_id}/vaults"
+          request(
+            :expects  => 200,
+            :idempotent => true,
+            :headers => {},
+            :method   => 'GET',
+            :path     => path,
+            :query => options
+          )
+        end
+      end
+
+    end
+  end
+end