ArchiveTransferManager Class | AWS SDK for .NET V3

Provides a high level API for managing transfers to and from Amazon Glacier. This removes complexities such as breaking files into parts and computing check sums.

Inheritance Hierarchy

System.Object
Amazon.Glacier.Transfer.ArchiveTransferManager

Namespace: Amazon.Glacier.Transfer
Assembly: AWSSDK.Glacier.dll
Version: 3.x.y.z

Syntax

public class ArchiveTransferManager
         IDisposable

The ArchiveTransferManager type exposes the following members

Constructors

	Name	Description
	ArchiveTransferManager(RegionEndpoint)	Constructs an ArchiveTransferManager object for the specified Amazon Glacier region endpoint using the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set. <?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="AWSProfileName" value="AWS Default"/> </appSettings> </configuration>
	ArchiveTransferManager(IAmazonGlacier)	Constructs an ArchiveTransferManager object using an existing Amazon Glacier client.
	ArchiveTransferManager(AWSCredentials, RegionEndpoint)	Constructs an ArchiveTransferManager object using the specified AWS credentials and Amazon Glacier region endpoint.
	ArchiveTransferManager(string, string, RegionEndpoint)	Constructs an ArchiveTransferManager object with the specified AWS Access Key ID, AWS Secret Key, and Amazon Glacier region endpoint.

Methods

Note:

Asynchronous operations (methods ending with Async) in the table below are for .NET 4.5 or higher. For .NET 3.5 the SDK follows the standard naming convention of BeginMethodName and EndMethodName to indicate asynchronous operations - these method pairs are not shown in the table below.

	Name	Description
	CreateVault(string)	Creates a vault.
	CreateVaultAsync(string)	Creates a vault.
	DeleteArchive(string, string)	Deletes an archive specified by vault name and archive ID.
	DeleteArchiveAsync(string, string)	Deletes an archive specified by vault name and archive ID.
	DeleteVault(string)	Deletes the specified vault. Before deletion, the vault must be empty of all archives.
	DeleteVaultAsync(string)	Deletes the specified vault. Before deletion, the vault must be empty of all archives.
	Dispose()	Disposes of all managed and unmanaged resources.
	Download(string, string, string)	Downloads an archive from Amazon Glacier from the specified vault for the current user's account. Saves the archive to the specified file. This method creates an Amazon SNS topic, and an Amazon SQS queue that is subscribed to that topic. It then initiates the archive retrieval job and polls the queue for the archive to be available. This polling takes about 4 hours. Once the archive is available, download will begin. Additional options can be set using the UploadDirectoryOptions object. For example, you can set the FilesTransferProgress property to a delegate to track progress.
	Download(string, string, string, DownloadOptions)	Downloads an archive from Amazon Glacier from the specified vault for the current user's account. Saves the archive to the specified file. This method creates an Amazon SNS topic, and an Amazon SQS queue that is subscribed to that topic. It then initiates the archive retrieval job and polls the queue for the archive to be available. This polling takes about 4 hours. Once the archive is available, download will begin. Additional options can be set using the UploadDirectoryOptions object. For example, you can set the FilesTransferProgress property to a delegate to track progress.
	DownloadAsync(string, string, string)	Downloads an Amazon Glacier archive from the specified vault for the current user's account. Saves the archive to the specified file. This method creates an Amazon SNS topic, and an Amazon SQS queue that is subscribed to that topic. It then initiates the archive retrieval job and polls the queue for the archive to be available. This polling takes about 4 hours. Once the archive is available, download will begin.
	DownloadAsync(string, string, string, DownloadOptions)	Downloads an archive from Amazon Glacier from the specified vault for the current user's account. Saves the archive to the specified file. This method creates an Amazon SNS topic, and an Amazon SQS queue that is subscribed to that topic. It then initiates the archive retrieval job and polls the queue for the archive to be available. This polling takes about 4 hours. Once the archive is available, download will begin. Additional options can be set using the UploadDirectoryOptions object. For example, you can set the FilesTransferProgress property to a delegate to track progress.
	DownloadJob(string, string, string)	Downloads the results from a completed archive retrieval. Saves the job output to the specified file. If there is an error during download the download will be retried from the last point read. Once the download is complete the checksum will be compared.
	DownloadJob(string, string, string, DownloadOptions)	Downloads the results from a completed archive retrieval. Saves the job output to the specified file. If there is an error during download the download will be retried from the last point read. Once the download is complete the checksum will be compared.
	DownloadJobAsync(string, string, string)	Downloads the results from a completed archive retrieval. Saves the job output to the specified file. If there is an error during download the download will be retried from the last point read. Once the download is complete the checksum will be compared.
	DownloadJobAsync(string, string, string, DownloadOptions)	Downloads the results from a completed archive retrieval. Saves the job output to the specified file. If there is an error during download the download will be retried from the last point read. Once the download is complete the checksum will be compared.
	InitiateArchiveRetrievalJob(string, string)	This method initiates an archive retieval job for the specified archive and returns back the job id. Once the job is complete
	InitiateArchiveRetrievalJob(string, string, InitiateArchiveRetrievalOptions)	This method initiates an archive retieval job for the specified archive and returns back the job id. Once the job is complete
	InitiateArchiveRetrievalJobAsync(string, string)	This method initiates an archive retieval job for the specified archive and returns back the job id. Once the job is complete
	InitiateArchiveRetrievalJobAsync(string, string, InitiateArchiveRetrievalOptions)	This method initiates an archive retieval job for the specified archive and returns back the job id. Once the job is complete
	Upload(string, string, string)	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 uploads the archive directly to Glacier. For larger archives, this method uses 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.
	Upload(string, string, string, UploadOptions)	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 uploads the archive directly to Glacier. For larger archives, this method uses 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.
	UploadAsync(string, string, string)	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 uploads the archive directly to Glacier. For larger archives, this method uses 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.
	UploadAsync(string, string, string, UploadOptions)	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 uploads the archive directly to Glacier. For larger archives, this method uses 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.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5 and newer, 3.5