Configuración de notificaciones de almacén en Amazon S3 Glacier con AWS SDK for .NET - Amazon S3 Glacier
Ejemplo: Configuración de notificaciones en un almacén con AWS SDK for .NET

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

Si busca soluciones de almacenamiento de archivos, le sugerimos que utilice las clases de almacenamiento S3 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 Clases de almacenamiento de S3 Glacier y Almacenamiento de datos a largo plazo con clases de almacenamiento de S3 Glacier en la Guía del usuario de Amazon S3. Estas clases de almacenamiento utilizan Amazon S3API, están disponibles en todas las regiones y se pueden gestionar en la consola de Amazon S3. Ofrecen funciones como el análisis de costos de almacenamiento, Storage Lens, funciones avanzadas de cifrado opcionales y más.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración de notificaciones de almacén en Amazon S3 Glacier con AWS SDK for .NET

A continuación, se indican los pasos necesarios para configurar las notificaciones de un almacén con la API de bajo nivel de AWS SDK for .NET.

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

    Debe especificar la región de AWS en la que se encuentra el almacén. Todas las operaciones que realice con este cliente se aplican a esa región de AWS.

  2. Para facilitar la información de configuración de las notificaciones, cree una instancia de la clase SetVaultNotificationsRequest.

    Debe proporcionar el nombre del almacén, la información de configuración de las notificaciones 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 for .NET con Amazon S3 Glacier.

    Al especificar la configuración de las notificaciones, tiene que proporcionar el nombre de recurso de Amazon (ARN) de un tema de Amazon SNS existente y uno o varios eventos para los que quiere recibir notificaciones. Para obtener una lista de los eventos compatibles, consulte Establecimiento de la configuración de notificación del almacén (PUT configuración-notificaciones).

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

  4. Una vez que la configuración de las notificaciones está establecida en un almacén, puede recuperar esta información llamando al método GetVaultNotifications y eliminarla con el método DeleteVaultNotifications proporcionado por el cliente.

Ejemplo: Configuración de notificaciones en un almacén con AWS SDK for .NET

En el siguiente ejemplo de código C#, se ilustran los pasos anteriores. El ejemplo establece la configuración de las notificaciones del almacén ("examplevault") en la región Oeste de EE. UU. (Oregón), recupera la configuración y, después, la elimina. La configuración solicita a Amazon S3 Glacier (S3 Glacier) que envíe una notificación al tema de Amazon SNS especificado cuando se produzca el evento ArchiveRetrievalCompleted o el evento InventoryRetrievalCompleted.

nota

Para obtener información acerca de la API de REST subyacente, consulte Operaciones de almacén.

Para obtener instrucciones paso a paso acerca de cómo ejecutar el siguiente ejemplo, consulte Ejecución de los ejemplos de código. Es necesario actualizar el código que se muestra y proporcionar el nombre de un almacén existente, así como un tema de Amazon SNS. 

using System;
using System.Collections.Generic;
using Amazon.Glacier;
using Amazon.Glacier.Model;
using Amazon.Runtime;

namespace glacier.amazon.com.rproxy.goskope.com.docsamples
{
  class VaultNotificationSetGetDelete
  {
    static string vaultName   = "examplevault";
    static string snsTopicARN = "*** Provide Amazon SNS topic ARN ***";

    static IAmazonGlacier client;

    public static void Main(string[] args)
    {
      try
      {
        using (client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2))
        {
          Console.WriteLine("Adding notification configuration to the vault.");
          SetVaultNotificationConfig();
          GetVaultNotificationConfig();
          Console.WriteLine("To delete vault notification configuration, press Enter");
          Console.ReadKey();
          DeleteVaultNotificationConfig();
        }
      }
      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 SetVaultNotificationConfig()
    {

      SetVaultNotificationsRequest request = new SetVaultNotificationsRequest()
      {     
        VaultName = vaultName,
        VaultNotificationConfig = new VaultNotificationConfig()
        {
          Events   = new List<string>() { "ArchiveRetrievalCompleted", "InventoryRetrievalCompleted" },
          SNSTopic = snsTopicARN
        }
      };
      SetVaultNotificationsResponse response = client.SetVaultNotifications(request);
    }

    static void GetVaultNotificationConfig()
    {
      GetVaultNotificationsRequest request = new GetVaultNotificationsRequest()
      {
        VaultName = vaultName,
        AccountId = "-"
      };
      GetVaultNotificationsResponse response = client.GetVaultNotifications(request);
      Console.WriteLine("SNS Topic ARN: {0}", response.VaultNotificationConfig.SNSTopic);
      foreach (string s in response.VaultNotificationConfig.Events)
        Console.WriteLine("Event : {0}", s);
    }

    static void DeleteVaultNotificationConfig()
    {
      DeleteVaultNotificationsRequest request = new DeleteVaultNotificationsRequest()
      {  
        VaultName = vaultName
      };
      DeleteVaultNotificationsResponse response = client.DeleteVaultNotifications(request);
    }
  }
}