MQ

L'oggetto che descrive un tipo di origineMQ dell'evento. Per maggiori informazioni, consulta Using Lambda with Amazon MQ nella AWS LambdaDeveloper Guide.

AWS Serverless Application Model(AWS SAM) genera una AWS::Lambda::EventSourceMappingrisorsa quando questo tipo di evento è impostato.

Nota

Per avere una coda Amazon MQ in un cloud privato virtuale (VPC) che si connette a una funzione Lambda in una rete pubblica, il ruolo di esecuzione della funzione deve includere le seguenti autorizzazioni:

• ec2:CreateNetworkInterface

• ec2:DeleteNetworkInterface

• ec2:DescribeNetworkInterfaces

• ec2:DescribeSecurityGroups

• ec2:DescribeSubnets

• ec2:DescribeVpcs

Per ulteriori informazioni, consulta Autorizzazioni del ruolo di esecuzione nella Guida perAWS Lambda gli sviluppatori.

Sintassi

Per dichiarare questa entità nelAWS SAM modello, utilizzare la sintassi seguente:

YAML

  BatchSize: Integer
  Broker: String
  Enabled: Boolean
  FilterCriteria: FilterCriteria
  MaximumBatchingWindowInSeconds: Integer
  Queues: List
  SecretsManagerKmsKeyId: String
  SourceAccessConfigurations: List

Proprietà

BatchSize

Il numero massimo di elementi da recuperare in un singolo batch.

Type: Numero intero

Richiesto: No

Default: 100

AWS CloudFormationcompatibilità: Questa proprietà viene passata direttamente allaBatchSize proprietà di unaAWS::Lambda::EventSourceMapping risorsa.

Minimum: 1

Maximum: 10000

Broker

L'Amazon Resource Name (ARN) del gestore di identità di Amazon MQ.

Type: Stringa

Richiesto: Sì

AWS CloudFormationcompatibilità: Questa proprietà viene passata direttamente allaEventSourceArn proprietà di unaAWS::Lambda::EventSourceMapping risorsa.

Enabled

Setrue, la mappatura delle origini eventi è attiva. Per mettere in pausa polling e invocazione, imposta sufalse.

Type: Boolean

Richiesto: No

AWS CloudFormationcompatibilità: Questa proprietà viene passata direttamente allaEnabled proprietà di unaAWS::Lambda::EventSourceMapping risorsa.

FilterCriteria

Un oggetto che definisce i criteri che determinano se Lambda debba elaborare un evento. Per ulteriori informazioni, consulta il filtroAWS Lambda degli eventi nella Guida per gliAWS Lambda sviluppatori.

Tipo: FilterCriteria

Richiesto: No

AWS CloudFormationcompatibilità: Questa proprietà viene passata direttamente allaFilterCriteria proprietà di unaAWS::Lambda::EventSourceMapping risorsa.

MaximumBatchingWindowInSeconds

Il tempo massimo in secondi per la raccolta dei record prima di richiamare la funzione.

Type: Numero intero

Richiesto: No

AWS CloudFormationcompatibilità: Questa proprietà viene passata direttamente allaMaximumBatchingWindowInSeconds proprietà di unaAWS::Lambda::EventSourceMapping risorsa.

Queues

Il nome della coda di destinazione del broker Amazon MQ da utilizzare.

Type: Elenco

Richiesto: Sì

AWS CloudFormationcompatibilità: Questa proprietà viene passata direttamente allaQueues proprietà di unaAWS::Lambda::EventSourceMapping risorsa.

SecretsManagerKmsKeyId

L'ID chiaveAWS Key Management Service (AWS KMS) di una chiave gestita dal cliente daAWS Secrets Manager. Obbligatorio quando si utilizza una chiave gestita dal cliente di Secrets Manager con un ruolo di esecuzione Lambda che non include l'kms:Decryptautorizzazione.

Il valore di questa proprietà è un UUID. Ad esempio: 1abc23d4-567f-8ab9-cde0-1fab234c5d67.

Type: Stringa

Richiesto: Condizionale

AWS CloudFormationcompatibilità: Questa proprietà è unicaAWS SAM e non ha unAWS CloudFormation equivalente.

SourceAccessConfigurations

Un array del protocollo di autenticazione o dell'host virtuale. Specificalo utilizzando il tipo di SourceAccessConfigurationsdati.

Per il tipo di origineMQ dell'evento, gli unici tipi di configurazione validi sonoBASIC_AUTH eVIRTUAL_HOST.

• BASIC_AUTH— Il segreto di Secrets Manager che memorizza le credenziali del broker. Per questo tipo, la credenziale deve avere il seguente formato: {"username": "your-username", "password": "your-password"}. È consentito un solo oggettoBASIC_AUTH di tipo.

• VIRTUAL_HOST— Il nome dell'host virtuale nel broker RabbitMQ. Lambda utilizzerà l'host di questo Rabbit MQ come origine eventi. È consentito un solo oggettoVIRTUAL_HOST di tipo.

Type: Elenco

Richiesto: Sì

AWS CloudFormationcompatibilità: Questa proprietà viene passata direttamente allaSourceAccessConfigurations proprietà di unaAWS::Lambda::EventSourceMapping risorsa.

Examples (Esempi)

Fonte eventi Amazon MQ

Di seguito è riportato un esempio di tipo di origineMQ degli eventi per un broker 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