MQ - AWS Serverless Application Model
SintaxePropriedadesExemplos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

MQ

O objeto que descreve um tipo de fonte de evento MQ. Para obter mais informações, consulte Uso do Lambda com o Amazon MQ no Guia do desenvolvedor do AWS Lambda.

AWS Serverless Application Model (AWS SAM) gera um recurso AWS::Lambda::EventSourceMapping quando esse tipo de evento é definido.

nota

Para ter uma fila do Amazon MQ em uma nuvem privada virtual (VPC) que se conecta a uma função do Lambda em uma rede pública, a função de execução da sua função deve incluir as seguintes permissões:

  • ec2:CreateNetworkInterface

  • ec2:DeleteNetworkInterface

  • ec2:DescribeNetworkInterfaces

  • ec2:DescribeSecurityGroups

  • ec2:DescribeSubnets

  • ec2:DescribeVpcs

Para obter mais informações, consulte Permissões de função de execução no Guia do desenvolvedor do AWS Lambda.

Sintaxe

Para declarar esta entidade no modelo do AWS SAM, use a seguinte sintaxe:

Propriedades

BatchSize

O número máximo de itens a serem recuperados em um único lote.

Tipo: inteiro

Obrigatório: não

Padrão: 100

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade BatchSize de um recurso AWS::Lambda::EventSourceMapping.

Mínimo: 1

Maximum: 10000

Broker

O nome de recurso da Amazon (ARN) do agente do Amazon MQ.

Tipo: string

Obrigatório: Sim

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade EventSourceArn de um recurso AWS::Lambda::EventSourceMapping.

DynamicPolicyName

Por padrão, o nome da política AWS Identity and Access Management (IAM) é SamAutoGeneratedAMQPolicy para Compatibilidade com versões anteriores. Especifique true o uso de um nome gerado automaticamente para sua política do IAM. Esse nome incluirá o ID lógico da fonte de eventos do Amazon MQ.

nota

Ao usar mais de uma fonte de eventos do Amazon MQ, especifique true para evitar nomes duplicados de políticas do IAM.

Tipo: booliano

Obrigatório: não

Padrão: false

Compatibilidade CloudFormation: Essa propriedade é exclusiva do AWS SAM e não tem CloudFormation equivalente.

Enabled

Se true, o mapeamento da origem do evento estará ativo. Para pausar a sondagem e invocação, defina como false.

Tipo: booliano

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade Enabled de um recurso AWS::Lambda::EventSourceMapping.

FilterCriteria

Um objeto que define os critérios que determinam se o Lambda deve processar um evento. Para obter mais informações, consulte Filtrando eventos do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Tipo: FilterCriteria

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade FilterCriteria de um recurso AWS::Lambda::EventSourceMapping.

KmsKeyArn

O nome do recurso da Amazon (ARN) da chave para criptografar informações relacionadas a esse evento.

Tipo: string

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade KmsKeyArn de um recurso AWS::Lambda::EventSourceMapping.

MaximumBatchingWindowInSeconds

O máximo de tempo para reunir registros antes de invocar a função, em segundos.

Tipo: inteiro

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade MaximumBatchingWindowInSeconds de um recurso AWS::Lambda::EventSourceMapping.

Queues

O nome da fila de destino do agente do Amazon MQ a ser consumido.

Tipo: lista

Obrigatório: Sim

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade Queues de um recurso AWS::Lambda::EventSourceMapping.

SecretsManagerKmsKeyId

O ID da chave AWS Key Management Service (AWS KMS) de uma chave gerenciada pelo cliente deAWS Secrets Manager. Obrigatório quando você usa uma chave gerenciada pelo cliente do Secrets Manager com uma função de execução do Lambda que não inclui a kms:Decrypt permissão.

O valor padrão da propriedade é um UUID. Por exemplo: 1abc23d4-567f-8ab9-cde0-1fab234c5d67.

Tipo: string

Obrigatório: Condicional

Compatibilidade CloudFormation: Essa propriedade é exclusiva do AWS SAM e não tem CloudFormation equivalente.

SourceAccessConfigurations

Uma matriz do protocolo de autenticação ou host virtual. Especifique isso usando o tipo de dados SourceAccessConfigurations.

Para o tipo de fonte do MQ evento, os únicos tipos de configuração válidos são BASIC_AUTH e VIRTUAL_HOST.

  • BASIC_AUTH – O segredo do Secrets Manager que armazena as credenciais do corretor. Para esse tipo, a credencial deverá estar no seguinte formato: {"username": "your-username", "password": "your-password"}. Somente um objeto do tipo BASIC_AUTH é permitido.

  • VIRTUAL_HOST – O nome do host virtual no seu agente do RabbitMQ. O Lambda usará esse host Rabbit MQ como fonte de eventos. Somente um objeto do tipo VIRTUAL_HOST é permitido.

Tipo: lista

Obrigatório: Sim

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade SourceAccessConfigurations de um recurso AWS::Lambda::EventSourceMapping.

Exemplos

Fonte do evento do Amazon MQ

Veja a seguir um exemplo de um tipo de fonte de MQ evento para um agente do 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