Get all available regions for the Amazon Glacier service.
Return type: | list |
---|---|
Returns: | A list of boto.regioninfo.RegionInfo |
Glacier API version.
Call this to abort a multipart upload identified by the upload ID.
Parameters: |
---|
Call this to inform Amazon Glacier that all of the archive parts have been uploaded and Amazon Glacier can now assemble the archive from the uploaded parts.
Parameters: |
|
---|
This operation creates a new vault with the specified name. The name of the vault must be unique within a region for an AWS account. You can create up to 1,000 vaults per account. For information on creating more vaults, go to the Amazon Glacier product detail page.
You must use the following guidelines when naming a vault.
Names can be between 1 and 255 characters long.
Allowed characters are a–z, A–Z, 0–9, ‘_’ (underscore), ‘-‘ (hyphen), and ‘.’ (period).
This operation is idempotent, you can send the same request multiple times and it has no further effect after the first time Amazon Glacier creates the specified vault.
Parameters: | vault_name (str) – The name of the new vault |
---|
This operation deletes an archive from a vault.
Parameters: |
---|
This operation deletes 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. If either of these conditions is not satisfied, the vault deletion fails (that is, the vault is not removed) and Amazon Glacier returns an error.
This operation is idempotent, you can send the same request multiple times and it has no further effect after the first time Amazon Glacier delete the specified vault.
Parameters: | vault_name (str) – The name of the new vault |
---|
This operation deletes the notification-configuration subresource set on the vault.
Parameters: | vault_name (str) – The name of the new vault |
---|
This operation returns information about a job you previously initiated, including the job initiation date, the user who initiated the job, the job status code/message and the Amazon Simple Notification Service (Amazon SNS) topic to notify after Amazon Glacier completes the job.
Parameters: |
---|
This operation returns information about a vault, including the vault Amazon Resource Name (ARN), the date the vault was created, the number of archives contained within the vault, and the total size of all the archives in the vault. The number of archives and their total size are as of the last vault inventory Amazon Glacier generated. Amazon Glacier generates vault inventories approximately daily. This means that if you add or remove an archive from a vault, and then immediately send a Describe Vault request, the response might not reflect the changes.
Parameters: | vault_name (str) – The name of the new vault |
---|
This operation downloads the output of the job you initiated using Initiate a Job. Depending on the job type you specified when you initiated the job, the output will be either the content of an archive or a vault inventory.
You can download all the job output or download a portion of the output by specifying a byte range. In the case of an archive retrieval job, depending on the byte range you specify, Amazon Glacier returns the checksum for the portion of the data. You can compute the checksum on the client and verify that the values match to ensure the portion you downloaded is the correct data.
Parameters: |
|
---|
This operation retrieves the notification-configuration subresource set on the vault.
Parameters: | vault_name (str) – The name of the new vault |
---|
This operation initiates a job of the specified type. Retrieving an archive or a vault inventory are asynchronous operations that require you to initiate a job. It is a two-step process:
The retrieval is executed asynchronously. When you initiate a retrieval job, Amazon Glacier creates a job and returns a job ID in the response.
Parameters: |
|
---|
Initiate a multipart upload. Amazon Glacier creates a multipart upload resource and returns it’s ID. You use this ID in subsequent multipart upload operations.
Parameters: |
|
---|
This operation lists jobs for a vault including jobs that are in-progress and jobs that have recently finished.
Parameters: |
|
---|
Lists in-progress multipart uploads for the specified vault.
Parameters: |
|
---|
Lists in-progress multipart uploads for the specified vault.
Parameters: |
|
---|
This operation lists all vaults owned by the calling user’s account. The list returned in the response is ASCII-sorted by vault name.
By default, this operation returns up to 1,000 items. If there are more vaults to list, the marker field in the response body contains the vault Amazon Resource Name (ARN) at which to continue the list with a new List Vaults request; otherwise, the marker field is null. In your next List Vaults request you set the marker parameter to the value Amazon Glacier returned in the responses to your previous List Vaults request. You can also limit the number of vaults returned in the response by specifying the limit parameter in the request.
Parameters: |
|
---|
This operation retrieves the notification-configuration subresource set on the vault.
Parameters: |
|
---|
This operation adds an archive to a vault. For a successful upload, your data is durably persisted. In response, Amazon Glacier returns the archive ID in the x-amz-archive-id header of the response. You should save the archive ID returned so that you can access the archive later.
Parameters: |
|
---|
Lists in-progress multipart uploads for the specified vault.
Parameters: |
|
---|
Provides a more pythonic and friendly interface to Glacier based on Layer1
Creates a vault.
Parameters: | name (str) – The name of the vault |
---|---|
Return type: | boto.glacier.vault.Vault |
Returns: | A Vault object representing the vault. |
Delete a vault.
This operation deletes 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. If either of these conditions is not satisfied, the vault deletion fails (that is, the vault is not removed) and Amazon Glacier returns an error.
This operation is idempotent, you can send the same request multiple times and it has no further effect after the first time Amazon Glacier delete the specified vault.
Parameters: | vault_name (str) – The name of the vault to delete. |
---|
Get an object representing a named vault from Glacier. This operation does not check if the vault actually exists.
Parameters: | name (str) – The name of the vault |
---|---|
Return type: | boto.glacier.vault.Vault |
Returns: | A Vault object representing the vault. |
Return a list of all vaults associated with the account ID.
Return type: | List of boto.glacier.vault.Vault |
---|---|
Returns: | A list of Vault objects. |
Create a new archive from a file and upload the given file.
This is a convenience method around the boto.glacier.concurrent.ConcurrentUploader class. This method will perform a multipart upload and upload the parts of the file concurrently.
Parameters: | filename (str) – A filename to upload |
---|---|
Raises: | boto.glacier.exception.UploadArchiveError is an error occurs during the upload process. |
Return type: | str |
Returns: | The archive id of the newly created archive |
Create a new archive and upload the data from the given file or file-like object.
Parameters: | |
---|---|
Return type: | str |
Returns: | The archive id of the newly created archive |
Create a new archive and begin a multi-part upload to it. Returns a file-like object to which the data for the archive can be written. Once all the data is written the file-like object should be closed, you can then call the get_archive_id method on it to get the ID of the created archive.
Parameters: | part_size (int) – The part size for the multipart upload. |
---|---|
Return type: | boto.glaicer.writer.Writer |
Returns: | A Writer object that to which the archive data should be written. |
Delete’s this vault. WARNING!
This operation deletes an archive from the vault.
Parameters: | archive_id (str) – The ID for the archive to be deleted. |
---|
Get an object representing a job in progress.
Parameters: | job_id (str) – The ID of the job |
---|---|
Return type: | boto.glaicer.job.Job |
Returns: | A Job object representing the job. |
Return a list of Job objects related to this vault.
Parameters: |
|
---|---|
Return type: | list of boto.glaicer.job.Job |
Returns: | A list of Job objects related to this vault. |
Initiate a archive retrieval job to download the data from an archive. You will need to wait for the notification from Amazon (via SNS) before you can actually download the data, this takes around 4 hours.
Parameters: | |
---|---|
Return type: | |
Returns: | A Job object representing the retrieval job. |
Initiate a inventory retrieval job to list the items in the vault. You will need to wait for the notification from Amazon (via SNS) before you can actually download the data, this takes around 4 hours.
Parameters: | |
---|---|
Return type: | |
Returns: | A Job object representing the retrieval job. |
Download an archive to a file.
Parameters: |
---|
This operation downloads the output of the job. Depending on the job type you specified when you initiated the job, the output will be either the content of an archive or a vault inventory.
You can download all the job output or download a portion of the output by specifying a byte range. In the case of an archive retrieval job, depending on the byte range you specify, Amazon Glacier returns the checksum for the portion of the data. You can compute the checksum on the client and verify that the values match to ensure the portion you downloaded is the correct data.
Parameters: | range – A tuple of integer specifying the slice (in bytes) of the archive you want to receive |
---|
Presents a file-like object for writing to a Amazon Glacier Archive. The data is written using the multi-part upload API.
Compute the linear and tree hash from a fileobj.
This function will compute the linear/tree hash of a fileobj in a single pass through the fileobj.
Parameters: |
|
---|---|
Return type: | tuple |
Returns: | A tuple of (linear_hash, tree_hash). Both hashes are returned in hex. |
Given a hash of each 1MB chunk (from chunk_hashes) this will hash together adjacent hashes until it ends up with one big one. So a tree of hashes.