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

Si aún no se ha familiarizado con el almacenamiento de archivos en Amazon Simple Storage Service (Amazon S3), se recomienda que comience por obtener más información sobre las clases de almacenamiento de S3 Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información, consulte Clases de almacenamiento de S3 Glacier y Clases de almacenamiento para archivar objetos en la Guía del usuario de Amazon S3.

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.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);
    }
  }
}