Creación de un almacén en Amazon Glacier con la AWS SDK para .NET - Amazon Glacier

Esta página es solo para los clientes actuales del servicio Amazon Glacier que utilizan Vaults y la API de REST original de 2012.

Si busca soluciones de almacenamiento de archivos, se recomienda que utilice las clases de almacenamiento de Amazon Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información sobre estas opciones de almacenamiento, consulte las clases de almacenamiento de Amazon Glacier.

Amazon Glacier (servicio original independiente basado en almacenes) ya no aceptará nuevos clientes a partir del 15 de diciembre de 2025, sin que ello afecte a los clientes actuales. Amazon Glacier es un servicio independiente con sus propias API que almacena datos en almacenes y es distinto de las clases de almacenamiento Amazon S3 y Amazon S3 Glacier. Sus datos actuales permanecerán seguros y accesibles en Amazon Glacier de forma indefinida. No hay que hacer migraciones. Para un almacenamiento de archivos a largo plazo y de bajo costo, AWS recomienda las clases de almacenamiento Amazon S3 Glacier, que ofrecen una experiencia del cliente superior con las API basadas en buckets de S3, Región de AWS disponibilidad total, costos más bajos e AWS integración de servicios. Si desea mejorar las capacidades, considere la posibilidad de migrar a las clases de almacenamiento de Amazon S3 Glacier mediante nuestra AWSGuía de soluciones para la transferencia de datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier.

Creación de un almacén en Amazon Glacier con la AWS SDK para .NET

Las API de alto y de bajo nivel que proporciona Amazon SDK para .NET ofrecen un método para crear un almacén.

Creación de un almacén con la API de alto nivel de AWS SDK para .NET

La clase ArchiveTransferManager de la API de alto nivel proporciona el método CreateVault, que puede usar para crear un almacén en una región de AWS.

Ejemplo: Operaciones de almacenes con la API de alto nivel de AWS SDK para .NET

En el siguiente ejemplo de código C#, se crea y se elimina un almacén en la región Oeste de EE. UU. (Oregón). Para ver una lista de las Regiones de AWS en las que se pueden crear almacenes, consulte Acceso a Amazon Glacier.

Para obtener instrucciones paso a paso acerca de cómo ejecutar el ejemplo siguiente, consulte Ejecución de los ejemplos de código. Tiene que actualizar el código mostrado con un nombre de almacén.

using System; using Amazon.Glacier; using Amazon.Glacier.Transfer; using Amazon.Runtime; namespace glacier.amazon.com.rproxy.govskope.ca.docsamples { class VaultCreateDescribeListVaultsDeleteHighLevel { static string vaultName = "*** Provide vault name ***"; public static void Main(string[] args) { try { var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2); manager.CreateVault(vaultName); Console.WriteLine("Vault created. To delete the vault, press Enter"); Console.ReadKey(); manager.DeleteVault(vaultName); Console.WriteLine("\nVault deleted. To continue, press Enter"); Console.ReadKey(); } catch (AmazonGlacierException e) { Console.WriteLine(e.Message); } catch (AmazonServiceException e) { Console.WriteLine(e.Message); } catch (Exception e) { Console.WriteLine(e.Message); } Console.WriteLine("To continue, press Enter"); Console.ReadKey(); } } }

Creación de un almacén con la API de bajo nivel de AWS SDK para .NET

La API de bajo nivel dispone de métodos para todas las operaciones de almacén, incluida la creación y eliminación de almacenes, la obtención de una descripción del almacén y la obtención de una lista de almacenes creados en una determinada Región de AWS. A continuación, se indican los pasos que hay que seguir para crear un almacén mediante AWS SDK para .NET.

  1. Cree una instancia de la clase AmazonGlacierClient (el cliente).

    Debe especificar la Región de AWS en la que quiere crear el almacén. Todas las operaciones que realice con este cliente se aplicarán a esa Región de AWS.

  2. Proporcione la información de la solicitud creando una instancia de la clase CreateVaultRequest.

    Amazon Glacier (Amazon Glacier) requiere que proporcione el nombre del almacén y el ID de la cuenta. Si no proporciona el ID de la cuenta, se presumirá que se trata del ID de cuenta asociado a las credenciales proporcionadas para firmar la solicitud. Para obtener más información, consulte Uso de AWS SDK para .NET con Amazon Glacier.

  3. Ejecute el método CreateVault proporcionando el objeto de solicitud como parámetro.

    La respuesta que devuelve Amazon Glacier está disponible en el objeto CreateVaultResponse.

Ejemplo: Operaciones de almacenes con la API de bajo nivel de AWS SDK para .NET

En el siguiente ejemplo de código C#, se ilustran los pasos anteriores. El ejemplo crea un almacén en la región Oeste de EE. UU. (Oregón). Además, el ejemplo de código recupera la información del almacén, enumera todos los almacenes de la misma Región de AWS y, después, elimina el almacén creado. El valor Location que aparece es el URI relativo del almacén, que incluye el ID de la cuenta, la Región de AWS y el nombre del almacén.

nota

Para obtener información acerca de la API de REST subyacente, consulte Creación de un almacén (almacén PUT).

Para obtener instrucciones paso a paso acerca de cómo ejecutar el ejemplo siguiente, consulte Ejecución de los ejemplos de código. Tiene que actualizar el código mostrado con un nombre de almacén.

using System; using Amazon.Glacier; using Amazon.Glacier.Model; using Amazon.Runtime; namespace glacier.amazon.com.rproxy.govskope.ca.docsamples { class VaultCreateDescribeListVaultsDelete { static string vaultName = "*** Provide vault name ***"; static AmazonGlacierClient client; public static void Main(string[] args) { try { using (client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2)) { Console.WriteLine("Creating a vault."); CreateAVault(); DescribeVault(); GetVaultsList(); Console.WriteLine("\nVault created. Now press Enter to delete the vault..."); Console.ReadKey(); DeleteVault(); } } catch (AmazonGlacierException e) { Console.WriteLine(e.Message); } catch (AmazonServiceException e) { Console.WriteLine(e.Message); } catch (Exception e) { Console.WriteLine(e.Message); } Console.WriteLine("To continue, press Enter"); Console.ReadKey(); } static void CreateAVault() { CreateVaultRequest request = new CreateVaultRequest() { VaultName = vaultName }; CreateVaultResponse response = client.CreateVault(request); Console.WriteLine("Vault created: {0}\n", response.Location); } static void DescribeVault() { DescribeVaultRequest describeVaultRequest = new DescribeVaultRequest() { VaultName = vaultName }; DescribeVaultResponse describeVaultResponse = client.DescribeVault(describeVaultRequest); Console.WriteLine("\nVault description..."); Console.WriteLine( "\nVaultName: " + describeVaultResponse.VaultName + "\nVaultARN: " + describeVaultResponse.VaultARN + "\nVaultCreationDate: " + describeVaultResponse.CreationDate + "\nNumberOfArchives: " + describeVaultResponse.NumberOfArchives + "\nSizeInBytes: " + describeVaultResponse.SizeInBytes + "\nLastInventoryDate: " + describeVaultResponse.LastInventoryDate ); } static void GetVaultsList() { string lastMarker = null; Console.WriteLine("\n List of vaults in your account in the specific region ..."); do { ListVaultsRequest request = new ListVaultsRequest() { Marker = lastMarker }; ListVaultsResponse response = client.ListVaults(request); foreach (DescribeVaultOutput output in response.VaultList) { Console.WriteLine("Vault Name: {0} \tCreation Date: {1} \t #of archives: {2}", output.VaultName, output.CreationDate, output.NumberOfArchives); } lastMarker = response.Marker; } while (lastMarker != null); } static void DeleteVault() { DeleteVaultRequest request = new DeleteVaultRequest() { VaultName = vaultName }; DeleteVaultResponse response = client.DeleteVault(request); } } }