Deleting a Vault in Amazon S3 Glacier Using the Amazon SDK for .NET - Amazon S3 Glacier
Deleting a Vault Using the High-Level API of the Amazon SDK for .NETDeleting a Vault Using the Low-Level API of the Amazon SDK for .NET
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

This page is only for existing customers of the S3 Glacier service using Vaults and the original REST API from 2012.

If you're looking for archival storage solutions we suggest using the S3 Glacier storage classes in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, and S3 Glacier Deep Archive. To learn more about these storage options, see S3 Glacier storage classes and Long-term data storage using S3 Glacier storage classes in the Amazon S3 User Guide. These storage classes use the Amazon S3 API, are available in all regions, and can be managed within the Amazon S3 console. They offer features like Storage Cost Analysis, Storage Lens, advanced optional encryption features, and more.

Deleting a Vault in Amazon S3 Glacier Using the Amazon SDK for .NET

Both the high-level and low-level APIs provided by the Amazon SDK for .NET provide a method to delete a vault.

Deleting a Vault Using the High-Level API of the Amazon SDK for .NET

The ArchiveTransferManager class of the high-level API provides the DeleteVault method you can use to delete a vault.

Example: Deleting a Vault Using the High-Level API of the Amazon SDK for .NET

For a working code example, see Example: Vault Operations Using the High-Level API of the Amazon SDK for .NET. The C# code example shows basic vault operations including create and delete vault.

Deleting a Vault Using the Low-Level API of the Amazon SDK for .NET

The following are the steps to delete a vault using the Amazon SDK for .NET.

  1. Create an instance of the AmazonGlacierClient class (the client).

    You need to specify an Amazon Region from where you want to delete a vault. All operations you perform using this client apply to that Amazon Region.

  2. Provide request information by creating an instance of the DeleteVaultRequest class.

    You need to provide the vault name and account ID. If you don't provide an account ID, then account ID associated with the credentials you provide to sign the request is assumed. For more information, see Using the Amazon SDK for .NET with Amazon S3 Glacier.

  3. Run the DeleteVault method by providing the request object as a parameter.

    Amazon S3 Glacier (S3 Glacier) deletes the vault only if it is empty. For more information, see Delete Vault (DELETE vault).

The following C# code snippet illustrates the preceding steps. The snippet retrieves metadata information of a vault that exists in the default Amazon Region. 

AmazonGlacier client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USEast1);

DeleteVaultRequest request = new DeleteVaultRequest()
{
  VaultName = "*** provide vault name ***"
};

DeleteVaultResponse response = client.DeleteVault(request);
Note

For information about the underlying REST API, see Delete Vault (DELETE vault).

Example: Deleting a Vault Using the Low-Level API of the Amazon SDK for .NET

For a working code example, see Example: Vault Operations Using the Low-Level API of the Amazon SDK for .NET. The C# code example shows basic vault operations including create and delete vault.