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.

Archivo de mensajes de Amazon SNS para propietarios de temas FIFO

El archivo de mensajes proporciona la posibilidad de archivar una sola copia de todos los mensajes publicados en el tema. Puede almacenar los mensajes publicados en el tema habilitando la política de archivo de mensajes correspondiente en el tema, que permite archivar los mensajes de todas las suscripciones vinculadas a ese tema. Los mensajes se pueden archivar durante un mínimo de un día y un máximo de 365 días.

Se aplican cargos adicionales al establecer una política de archivo. Para obtener información acerca de los precios, consulte Precios de Amazon SNS.

Crea una política de archivado de mensajes mediante el AWS Management Console

Para consultar, editar y desactivar una política de temas de archivo de mensajes

Crear una política de archivo de mensajes con la API

Para crear una política de archivo de mensajes mediante la API, debe agregar el atributo ArchivePolicy al tema. Puede configurar ArchivePolicy con las acciones de la API CreateTopic y SetTopicAttributes. ArchivePolicy tiene un valor único, MessageRetentionPeriod, que representa el número de días que Amazon SNS retiene los mensajes. Para activar el archivo de mensajes para el tema, establezca MessageRetentionPeriod en un valor entero mayor que cero. Por ejemplo, para retener mensajes en el archivo durante 30 días, establezca ArchivePolicy en:

{
    "ArchivePolicy": {
        "MessageRetentionPeriod": "30"
    }
}

Para desactivar el archivo de mensajes para el tema y borrar el archivo, desactive ArchivePolicy, de la siguiente manera:

{}

Crear una política de archivo de mensajes mediante el SDK

Para usar un AWS SDK, debe configurarlo con sus credenciales. Para obtener más información, consulte credentialsArchivos config y compartidos en la Guía de referencia de herramientas AWS SDKs y herramientas.

En el siguiente ejemplo de código, se muestra cómo configurar ArchivePolicy para que un tema de Amazon SNS retenga todos los mensajes publicados en ese tema durante 30 días.

// Specify the ARN of the Amazon SNS topic to set the ArchivePolicy for.
String topicArn =
    "arn:aws:sns:us-east-2:123456789012:MyArchiveTopic.fifo";

// Set the MessageRetentionPeriod to 30 days for the ArchivePolicy.
String archivePolicy =
    "{\"MessageRetentionPeriod\":\"30\"}";

// Set the ArchivePolicy for the Amazon SNS topic
SetTopicAttributesRequest request = new SetTopicAttributesRequest()
    .withTopicArn(topicArn)
    .withAttributeName("ArchivePolicy")
    .withAttributeValue(archivePolicy);
sns.setTopicAttributes(request);

Cree una política de archivado de mensajes mediante AWS CloudFormation

Para crear una política de archivado utilizando, AWS CloudFormation consulte AWS::SNS::Topicla Guía del AWS CloudFormation usuario.

Conceder acceso a un archivo cifrado

Antes de que un suscriptor pueda empezar a reproducir mensajes de un tema cifrado, debe completar los siguientes pasos. Como los mensajes anteriores se reproducen, Amazon SNS debe disponer de acceso de Decrypt a la clave de KMS que se utilizó para cifrar los mensajes del archivo.

Conceder permisos de descifrado a Amazon SNS

Para que Amazon SNS acceda a los mensajes cifrados desde el archivo del tema y los reproduzca en los puntos de conexión suscritos, debe habilitar el principio del servicio de Amazon SNS para descifrar estos mensajes.

A continuación, se muestra una política de ejemplo que se requiere para permitir que la entidad principal del servicio de Amazon SNS descifre los mensajes almacenados durante una reproducción del historial de mensajes dentro del tema.

{
    "Sid": "Allow SNS to decrypt archived messages",
    "Effect": "Allow",
    "Principal": {
        "Service": "sns.amazonaws.com"
    },
    "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
    ],
    "Resource": "*"
}

Supervisa las métricas del archivo de mensajes con Amazon CloudWatch

Puedes monitorizar los mensajes archivados con Amazon CloudWatch con las siguientes métricas. Para recibir notificaciones de anomalías en tus cargas de trabajo y evitar que se vean afectadas, puedes configurar las CloudWatch alarmas de Amazon en función de estas métricas. Para obtener más información, consulta Registro y monitoreo en Amazon SNS.

La API GetTopicAttributes tiene una propiedad BeginningArchiveTime que representa la marca temporal más antigua en la que un suscriptor puede iniciar una reproducción. A continuación, se muestra una respuesta de ejemplo para esta acción de la API:

{
 "ArchivePolicy": {
    "MessageRetentionPeriod": "<integer>"
  },
  "BeginningArchiveTime": "<timestamp>",
  ...
}