AWS SDK Version 2 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

.NET Framework 4.5
 
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.dll
Version: (assembly version)

Syntax

C#
public class ArchiveTransferManager : Object
         IDisposable

The ArchiveTransferManager type exposes the following members

Constructors

NameDescription
Public Method 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>
             
Public Method ArchiveTransferManager(IAmazonGlacier) Constructs an ArchiveTransferManager object using an existing Amazon Glacier client.
Public Method ArchiveTransferManager(AWSCredentials, RegionEndpoint) Constructs an ArchiveTransferManager object using the specified AWS credentials and Amazon Glacier region endpoint.
Public Method ArchiveTransferManager(string, string, RegionEndpoint) Constructs an ArchiveTransferManager object with the specified AWS Access Key ID, AWS Secret Key, and Amazon Glacier region endpoint.

Methods

NameDescription
Public Method CreateVault(string) Creates a vault.
Public Method DeleteArchive(string, string) Deletes an archive specified by vault name and archive ID.
Public Method DeleteVault(string) Deletes the specified vault. Before deletion, the vault must be empty of all archives.
Public Method Dispose() Disposes of all managed and unmanaged resources.
Public Method Download(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.

Public Method 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.

Public Method 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.

Public Method 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.

Public Method 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
Public Method 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
Public Method 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.
Public Method 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.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5