MQ

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

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

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 le autorizzazioni dei ruoli di esecuzione nella Guida per gli sviluppatori. AWS Lambda

Sintassi

Per dichiarare questa entità nel AWS SAM modello, utilizza la seguente sintassi.

YAML

  BatchSize: Integer
  Broker: String
  DynamicPolicyName: Boolean
  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.

Tipo: integer

Required: No

Impostazione predefinita: 100

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla BatchSize proprietà di una AWS::Lambda::EventSourceMapping risorsa.

Minimum: 1

Maximum: 10000

Broker

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

Tipo: stringa

Campo obbligatorio: sì

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla EventSourceArn proprietà di una AWS::Lambda::EventSourceMapping risorsa.

DynamicPolicyName

Per impostazione predefinita, il nome della policy AWS Identity and Access Management (IAM) serve SamAutoGeneratedAMQPolicy per la compatibilità con le versioni precedenti. Specificate true di utilizzare un nome generato automaticamente per la vostra policy IAM. Questo nome includerà l'ID logico dell'origine dell'evento Amazon MQ.

Nota

Quando utilizzi più di una fonte di eventi Amazon MQ, specifica true per evitare nomi di policy IAM duplicati.

Tipo: Booleano

Required: No

Default: false

AWS CloudFormationcompatibilità: questa proprietà è unica AWS SAM e non ha un AWS CloudFormation equivalente.

Enabled

Setrue, la mappatura della fonte dell'evento è attiva. Per mettere in pausa il polling e la chiamata, imposta su. false

Tipo: Booleano

Required: No

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla Enabled proprietà di una risorsa. AWS::Lambda::EventSourceMapping

FilterCriteria

Un oggetto che definisce i criteri che determinano se Lambda deve elaborare un evento. Per ulteriori informazioni, consulta il filtro AWS Lambda degli eventi nella Guida per gli AWS Lambdasviluppatori.

Tipo: FilterCriteria

Required: No

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla FilterCriteria proprietà di una AWS::Lambda::EventSourceMapping risorsa.

MaximumBatchingWindowInSeconds

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

Tipo: integer

Required: No

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla MaximumBatchingWindowInSeconds proprietà di una AWS::Lambda::EventSourceMapping risorsa.

Queues

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

Tipo: Elenco

Campo obbligatorio: sì

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla Queues proprietà di una AWS::Lambda::EventSourceMapping risorsa.

SecretsManagerKmsKeyId

L'ID della chiave AWS Key Management Service (AWS KMS) di una chiave gestita dal cliente daAWS Secrets Manager. Richiesto 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.

Tipo: stringa

Required: Conditional

AWS CloudFormationcompatibilità: questa proprietà è unica AWS SAM e non ha un AWS CloudFormation equivalente.

SourceAccessConfigurations

Una matrice del protocollo di autenticazione o dell'host virtuale. Specificalo utilizzando il tipo di SourceAccessConfigurationsdati.

Per il tipo di origine MQ dell'evento, gli unici tipi di configurazione validi sono BASIC_AUTH eVIRTUAL_HOST.

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

• VIRTUAL_HOST— Il nome dell'host virtuale nel tuo broker RabbitMQ. Lambda utilizzerà l'host di questo Rabbit MQ come origine dell'evento. È consentito un solo oggetto di tipoVIRTUAL_HOST.

Tipo: Elenco

Campo obbligatorio: sì

AWS CloudFormationcompatibilità: questa proprietà viene passata direttamente alla SourceAccessConfigurations proprietà di una AWS::Lambda::EventSourceMapping risorsa.

Esempi

Fonte di eventi Amazon MQ

Di seguito è riportato un esempio di tipo di origine di MQ 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