MQ - AWS Serverless Application Model
SintaxisPropiedadesEjemplos

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.

MQ

El objeto que describe un tipo de fuente de evento de MQ. Para obtener más información, consulte Uso de Lambda con Amazon MQ en la Guía para desarrolladores de AWS Lambda .

AWS Serverless Application Model (AWS SAM) genera un AWS::Lambda::EventSourceMappingrecurso cuando se establece este tipo de evento.

nota

Para tener una cola de Amazon MQ en una nube privada virtual (VPC) que se conecte a una función de Lambda en una red pública, la función de ejecución de la función debe incluir los siguientes permisos:

  • ec2:CreateNetworkInterface

  • ec2:DeleteNetworkInterface

  • ec2:DescribeNetworkInterfaces

  • ec2:DescribeSecurityGroups

  • ec2:DescribeSubnets

  • ec2:DescribeVpcs

Para obtener más información, consulte Permisos del rol de ejecución en la Guía para desarrolladores de AWS Lambda .

Sintaxis

Para declarar esta entidad en la AWS SAM plantilla, utilice la siguiente sintaxis.

Propiedades

BatchSize

El número máximo de elementos que se recuperan en un único lote.

Tipo: entero

Obligatorio: no

Valor predeterminado: 100

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la BatchSize propiedad de un AWS::Lambda::EventSourceMapping recurso.

Mínimo: 1

Máximo: 10000

Broker

El nombre del recurso de Amazon (ARN) del agente Amazon MQ.

Tipo: cadena

Obligatorio: sí

AWS CloudFormation compatibilidad: esta propiedad se transfiere directamente a la EventSourceArn propiedad de un AWS::Lambda::EventSourceMapping recurso.

DynamicPolicyName

De forma predeterminada, el nombre de la política AWS Identity and Access Management (IAM) es SamAutoGeneratedAMQPolicy de compatibilidad con versiones anteriores. trueEspecifica el uso de un nombre generado automáticamente para tu IAM política. Este nombre incluirá el ID lógico del origen del evento de Amazon MQ.

nota

Si utilizas más de una fuente de eventos de Amazon MQ, especifica que no se dupliquen true los nombres de las IAM políticas.

Tipo: Booleano

Obligatorio: no

Valor predeterminado: false

AWS CloudFormation compatibilidad: esta propiedad es exclusiva de AWS SAM y no tiene un AWS CloudFormation equivalente.

Enabled

Si es true, la asignación de orígenes de eventos está activa. Establézcalo en false para poner en pausa el sondeo y la invocación.

Tipo: Booleano

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la Enabled propiedad de un AWS::Lambda::EventSourceMapping recurso.

FilterCriteria

Un objeto que define los criterios que determinan si Lambda debe procesar un evento o no. Para obtener más información, consulte Filtrado de eventos de AWS Lambda en la Guía para desarrolladores de AWS Lambda .

Tipo: FilterCriteria

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la FilterCriteria propiedad de un AWS::Lambda::EventSourceMapping recurso.

KmsKeyArn

El nombre del recurso de Amazon (ARN) de la clave para cifrar la información relacionada con este evento.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se transfiere directamente a la KmsKeyArn propiedad de un AWS::Lambda::EventSourceMapping recurso.

MaximumBatchingWindowInSeconds

La cantidad de tiempo máxima para recopilar registros antes de invocar la función, en segundos.

Tipo: Entero

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la MaximumBatchingWindowInSeconds propiedad de un AWS::Lambda::EventSourceMapping recurso.

Queues

Nombre de la cola de destino del agente de Amazon MQ que se va a consumir.

Tipo: lista

Obligatorio: sí

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la Queues propiedad de un AWS::Lambda::EventSourceMapping recurso.

SecretsManagerKmsKeyId

El identificador de clave AWS Key Management Service (AWS KMS) de una clave gestionada por el cliente desde AWS Secrets Manager. Se requiere cuando se utiliza una clave gestionada por el cliente de Secrets Manager con una función de ejecución de Lambda que no incluye el permiso de kms:Decrypt.

El valor de esta propiedad es unUUID. Por ejemplo: 1abc23d4-567f-8ab9-cde0-1fab234c5d67.

Tipo: cadena

Obligatorio: condicional

AWS CloudFormation compatibilidad: esta propiedad es exclusiva de AWS SAM y no tiene un AWS CloudFormation equivalente.

SourceAccessConfigurations

Una matriz del protocolo de autenticación para un host virtual. Especifique esto mediante el tipo SourceAccessConfigurationsde datos.

Para el tipo de origen del evento de MQ, los únicos tipos de configuración válidos son BASIC_AUTH y VIRTUAL_HOST.

  • BASIC_AUTH: el secreto de Secrets Manager que almacena las credenciales del agente. Para este tipo, la credencial debe tener el siguiente formato: {"username": "your-username", "password": "your-password"}. Solo se permite un objeto de tipo BASIC_AUTH.

  • VIRTUAL_HOST: el nombre del host virtual en el agente de RabbitMQ. Lambda utilizará este host de RabbitMQ como el origen de eventos. Solo se permite un objeto de tipo VIRTUAL_HOST.

Tipo: lista

Obligatorio: sí

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la SourceAccessConfigurations propiedad de un AWS::Lambda::EventSourceMapping recurso.

Ejemplos

Origen de eventos de Amazon MQ

A continuación, se muestra un ejemplo de un tipo de origen de evento MQ para un agente de Amazon MQ.

YAML

Events:
  MQEvent:
    Type: MQ
    Properties:
      Broker: arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9
      Queues: List of queues
      SourceAccessConfigurations:
        - Type: BASIC_AUTH
          URI: arn:aws:secretsmanager:us-east-1:01234567890:secret:MyBrokerSecretName
      BatchSize: 200
      Enabled: true