com.amazonaws.services.glacier.transfer
Class ArchiveTransferManager

java.lang.Object
  com.amazonaws.services.glacier.transfer.ArchiveTransferManager

public class ArchiveTransferManager
extends Object

Utilities for uploading and downloading data to and from AWS Glacier.

Constructor Summary

ArchiveTransferManager(AWSCredentials credentials)
Constructs a new ArchiveTransferManager, using the specified AWS credentials to authenticate requests.

ArchiveTransferManager(AWSCredentialsProvider credentialsProvider, ClientConfiguration clientConfiguration)
Constructs a new ArchiveTransferManager, using the specified AWS credentials provider and client configuration.

Method Summary

void	download(String vaultName, String archiveId, File file) Downloads an archive from Amazon Glacier in the specified vault for the current user's account, and saves it to the specified file.
void	download(String accountId, String vaultName, String archiveId, File file) Downloads an archive from Amazon Glacier in the specified vault in the specified user's account, and saves it to the specified file.
UploadResult	upload(String vaultName, String archiveDescription, File file) Uploads the specified file to Amazon Glacier for archival storage in the specified vault for the user's current account.
UploadResult	upload(String accountId, String vaultName, String archiveDescription, File file) Uploads the specified file to Amazon Glacier for archival storage in the specified vault in the specified user's account.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ArchiveTransferManager

public ArchiveTransferManager(AWSCredentials credentials)

Constructs a new ArchiveTransferManager, using the specified AWS credentials to authenticate requests.

Parameters:

credentials - The AWS credentials used to authenticate requests.

ArchiveTransferManager

public ArchiveTransferManager(AWSCredentialsProvider credentialsProvider,
                              ClientConfiguration clientConfiguration)

Constructs a new ArchiveTransferManager, using the specified AWS credentials provider and client configuration.

Parameters:

credentialsProvider - The AWS credentials provider used to authenticate requests.

clientConfiguration - Client specific options, such as proxy settings, retries, and timeouts.

Method Detail

upload

public UploadResult upload(String vaultName,
                           String archiveDescription,
                           File file)
                    throws AmazonServiceException,
                           AmazonClientException,
                           FileNotFoundException

Uploads the specified file to Amazon Glacier for archival storage in the specified vault for the user's current account. For small archives, this method will upload the archive directly to Glacier. For larger archives, this method will use Glacier's multipart upload API to split the upload into multiple parts for better error recovery if any errors are encountered while streaming the data to Amazon Glacier.

Parameters:

vaultName - The name of the vault to upload to.

archiveDescription - The description of the new archive being uploaded.

file - The file to upload to Amazon Glacier.

Returns:

The result of the upload, including the archive ID needed to access the upload later.

Throws:

AmazonServiceException - If any problems were encountered while communicating with AWS.

AmazonClientException - If any problems were encountered inside the AWS SDK for Java client code in making requests or processing responses from AWS.

FileNotFoundException - If the specified file to upload doesn't exist.

upload

public UploadResult upload(String accountId,
                           String vaultName,
                           String archiveDescription,
                           File file)
                    throws AmazonServiceException,
                           AmazonClientException,
                           FileNotFoundException

Uploads the specified file to Amazon Glacier for archival storage in the specified vault in the specified user's account. For small archives, this method will upload the archive directly to Glacier. For larger archives, this method will use Glacier's multipart upload API to split the upload into multiple parts for better error recovery if any errors are encountered while streaming the data to Amazon Glacier.

Parameters:

accountId - The ID for the account which owns the Glacier vault being uploaded to. To use the same account the developer is using to make requests to AWS, the value "-" can be used instead of the full account ID.

vaultName - The name of the vault to upload to.

archiveDescription - The description of the new archive being uploaded.

file - The file to upload to Amazon Glacier.

Returns:

The result of the upload, including the archive ID needed to access the upload later.

Throws:

AmazonServiceException - If any problems were encountered while communicating with AWS.

AmazonClientException - If any problems were encountered inside the AWS SDK for Java client code in making requests or processing responses from AWS.

FileNotFoundException - If the specified file to upload doesn't exist.

download

public void download(String vaultName,
                     String archiveId,
                     File file)
              throws AmazonServiceException,
                     AmazonClientException

Downloads an archive from Amazon Glacier in the specified vault for the current user's account, and saves it to the specified file. Amazon Glacier is optimized for long term storage of data that isn't needed quickly. This method will first make a request to Amazon Glacier to prepare the archive to be downloaded. Once Glacier has finished preparing the archive to be downloaded, this method will start downloading the data and storing it in the specified file.

Parameters:

vaultName - The name of the vault to download the archive from.

archiveId - The unique ID of the archive to download.

file - The file save the archive to.

Throws:

AmazonServiceException - If any problems were encountered while communicating with AWS.

AmazonClientException - If any problems were encountered inside the AWS SDK for Java client code in making requests or processing responses from AWS.

download

public void download(String accountId,
                     String vaultName,
                     String archiveId,
                     File file)
              throws AmazonServiceException,
                     AmazonClientException

Downloads an archive from Amazon Glacier in the specified vault in the specified user's account, and saves it to the specified file. Amazon Glacier is optimized for long term storage of data that isn't needed quickly. This method will first make a request to Amazon Glacier to prepare the archive to be downloaded. Once Glacier has finished preparing the archive to be downloaded, this method will start downloading the data and storing it in the specified file.

Parameters:

accountId - The ID for the account which owns the Glacier vault where the archive is being downloaded from. To use the same account the developer is using to make requests to AWS, the value "-" can be used instead of the full account ID.

vaultName - The name of the vault to download the archive from.

archiveId - The unique ID of the archive to download.

file - The file save the archive to.

Throws:

AmazonServiceException - If any problems were encountered while communicating with AWS.

AmazonClientException - If any problems were encountered inside the AWS SDK for Java client code in making requests or processing responses from AWS.