Obtención de notificaciones del almacén (GET configuración-notificaciones) - Amazon S3 Glacier
DescripciónSolicitudesRespuestasEjemplosSecciones relacionadasVéase también

Esta página es solo para los clientes actuales del servicio S3 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 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 la API de Amazon S3, están disponibles en todas las regiones y se pueden administrar en la consola de Amazon S3. Ofrecen funciones como el análisis de costes de almacenamiento, Lente de almacenamiento características avanzadas de cifrado opcionales y más.

Obtención de notificaciones del almacén (GET configuración-notificaciones)

Descripción

Esta operación recupera el subrecurso notification-configuration definido en el almacén (consulte Establecimiento de la configuración de notificación del almacén (PUT configuración-notificaciones)). Si no se establece la configuración de las notificaciones, la operación devuelve un error 404 Not Found. Para obtener más información sobre las notificaciones de los almacenes, consulte Configuración de las notificaciones de almacén en Amazon S3 Glacier.

Solicitudes

Para recuperar la información de la configuración de las notificaciones, envíe una solicitud GET al URI del subrecurso notification-configuration de un almacén.

Sintaxis

GET /AccountId/vaults/VaultName/notification-configuration HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

nota

El valor AccountId es el ID de la Cuenta de AWS propietaria del almacén. Puede especificar un ID de Cuenta de AWS o, si lo desea, un solo carácter “-” (guion), en cuyo caso, Amazon S3 Glacier usa el ID de la Cuenta de AWS asociada con las credenciales empleadas para firmar la solicitud. Si usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.

Parámetros de la solicitud

Esta operación no usa parámetros de solicitud.

Encabezados de solicitud

Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte Encabezados de solicitudes comunes.

Cuerpo de la solicitud

Esta operación no tiene un cuerpo de la solicitud.

Respuestas

Sintaxis

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
  "Events": [
    String,
    ...
  ],
  "SNSTopic": String
}

Encabezados de respuesta

Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte Encabezados de respuesta comunes.

Cuerpo de respuesta

El cuerpo de la respuesta contiene los siguientes campos JSON.

Eventos

Lista de uno o varios eventos para los que Amazon S3 Glacier (S3 Glacier) enviará una notificación al tema de Amazon SNS especificado. Si desea obtener más información acerca de los eventos de los almacenes para los cuales se puede configurar un almacén para que publique notificaciones, consulte Establecimiento de la configuración de notificación del almacén (PUT configuración-notificaciones).

Tipo: Array

SNSTopic

El nombre de recurso de Amazon (ARN) del tema de Amazon Simple Notification Service (Amazon SNS). Para obtener más información, consulte Introducción a Amazon SNS en la Guía de introducción de Amazon Simple Notification Service.

Tipo: cadena

Errores

Para obtener información acerca de los mensajes de error y las excepciones de Amazon S3 Glacier, consulte Respuestas de error.

Ejemplos

En el ejemplo siguiente, se muestra cómo se recupera la configuración de las notificaciones de un almacén.

Solicitud de ejemplo

En este ejemplo, se envía una solicitud GET al subrecurso notification-configuration de un almacén.

GET /-/vaults/examplevault/notification-configuration HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Respuesta de ejemplo

En una respuesta correcta, el documento de configuración de registro de auditoría aparecerá en el cuerpo de la respuesta en formato JSON. En este ejemplo, la configuración muestra que las notificaciones de los dos eventos (ArchiveRetrievalCompleted e InventoryRetrievalCompleted) se envían al tema de Amazon SNS arn:aws:sns:us-west-2:012345678901:mytopic.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 150
  
{
  "Events": [
    "ArchiveRetrievalCompleted",
    "InventoryRetrievalCompleted"
  ],
  "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"
}

Véase también

Para obtener más información sobre el uso de esta API en uno de los SDK de Amazon específicos de idioma, consulte lo siguiente: