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.
# aws-sns-sqs
Todas las clases están en desarrollo activo y están sujetas a cambios o eliminación no compatibles con versiones anteriores en cualquier versión futura. Estos no están sujetos a la[Versionado semántico](https://semver.org/)El modelo. Esto significa que, aunque puede usarlos, es posible que necesite actualizar el código fuente cuando actualice a una versión más reciente de este paquete.
**Nota:** Para garantizar una funcionalidad adecuada, los paquetes de AWS Solutions Constructs y los paquetes CDK de AWS del proyecto deben tener la misma versión.
| **Idioma** | **Paquete** |
| --- | --- |
|  Python | aws\_solutions\_constructs.aws\_sns\_sqs |
|  Mecanografiado | @aws-solutions-constructs/aws-sns-sqs |
|  Java | software.amazon.awsconstructs.services.snssqs |
## Overview
Este construcción de soluciones de AWS implementa un tema de Amazon SNS conectado a una cola de Amazon SQS.
Aquí hay una definición mínima de patrón implementable en TypeScript:
```
import { SnsToSqs, SnsToSqsProps } from "@aws-solutions-constructs/aws-sns-sqs";
import * as iam from '@aws-cdk/aws-iam';
const snsToSqsStack = new SnsToSqs(this, 'SnsToSqsPattern', {});
// Grant yourself permissions to use the Customer Managed KMS Key
const policyStatement = new iam.PolicyStatement({
actions: ["kms:Encrypt", "kms:Decrypt"],
effect: iam.Effect.ALLOW,
principals: [ new iam.AccountRootPrincipal() ],
resources: [ "*" ]
});
snsToSqsStack.encryptionKey?.addToResourcePolicy(policyStatement);
```
## Initializer
```
new SnsToSqs(scope: Construct, id: string, props: SnsToSqsProps);
```
*Parámetros*
+ scope[`Construct`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html)
+ id`string`
+ props[`SnsToSqsProps`](#pattern-construct-props-28)
## Patrón de construcción
| **Nombre** | **Tipo** | **Descripción** |
| --- | --- | --- |
| ¿ExistentetoPicobj? | [`sns.Topic`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html) | Instancia existente del objeto SNS Topic, proporcionando tanto esto comotopicPropsprovocará un error. |
| ¿TopicProps? | [`sns.TopicProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.TopicProps.html) | Propiedades opcionales proporcionadas por el usuario para anular las propiedades predeterminadas del tema SNS. Se pasa por alto si unexistingTopicObjse encuentra. |
| ExistingQueueObj? | [`sqs.Queue`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html) | Una cola SQS opcional existente que se utilizará en lugar de la cola predeterminada. Proporcionando tanto esto comoqueuePropsprovocará un error. |
| ¿Props en cola? | [`sqs.QueueProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html) | Propiedades opcionales proporcionadas por el usuario para anular las propiedades predeterminadas de la cola SQS. Se pasa por alto si unexistingQueueObjse encuentra. |
| DeployDeadLetterQueue? | boolean | Si se crea una cola de secundaria para utilizarse como cola de mensajes fallidos. El valor predeterminado es true. |
| DeadletterQueueProps? | [`sqs.QueueProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html) | Props opcionales proporcionados por el usuario para anular los apoyos predeterminados para la cola de letras muertas. Solo se usa si eldeployDeadLetterQueuese establece en true. |
| ¿maxReceiveCount? | number | El número de veces que un mensaje se puede quitar sin éxito antes de que se traslade a la cola de mensajes fallidos. El valor predeterminado es 15. |
| EnableEncryptionWithCustomerManagedKey? | boolean | Si desea utilizar una clave de cifrado administrada por el cliente, ya sea administrada por esta aplicación CDK o importada. Si importa una clave de cifrado, debe especificarse en el campoencryptionKeypara esta construcción. |
| encryptionKey | [`kms.Key`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html) | Una clave de cifrado opcional existente que se utilizará en lugar de la clave de cifrado predeterminada. |
| EncryptionKeyProps? | [`kms.KeyProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.KeyProps.html) | Propiedades opcionales proporcionadas por el usuario para anular las propiedades predeterminadas de la clave de cifrado. |
## Propiedades de patrón
| **Nombre** | **Tipo** | **Descripción** |
| --- | --- | --- |
| SNSTopic | [`sns.Topic`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html) | Devuelve una instancia del tema SNS creado por el patrón. |
| encryptionKey | [`kms.Key`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html) | Devuelve una instancia de la clave de cifrado creada por el patrón. |
| SQSqueue | [`sqs.Queue`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html) | Devuelve una instancia de la cola SQS creada por el patrón. |
| DeadLetterQueue? | [`sqs.Queue`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html) | Devuelve una instancia de la cola de letras muertas creada por el patrón, si se implementa una. |
## Configuración predeterminada
La implementación lista para usar de este patrón sin anulación establecerá los siguientes valores predeterminados:
### Tema de Amazon SNS
+ Configurar permisos de acceso de privilegios mínimos para el tema SNS.
+ Habilite el cifrado del lado del servidor mediante la clave KMS administrada por AWS.
+ Aplicación del cifrado de los datos en tránsito.
### Cola de Amazon SQS
+ Configurar permisos de acceso de privilegios mínimos para la cola de SQS.
+ Implemente la cola de mensajes fallidos para la cola de SQS de origen.
+ Habilite el cifrado en el lado de servidor para la cola de SQS mediante la clave KMS administrada por el cliente.
+ Aplicación del cifrado de los datos en tránsito.
## Architecture
## GitHub
Para ver el código de este patrón, crear/ver problemas y solicitudes de extracción, y mucho más:
