MQ - AWS Serverless Application Model
SintassiProprietàEsempi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

MQ

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

AWS Serverless Application Model (AWS SAM) genera un 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 le autorizzazioni dei ruoli di esecuzione nella Guida per gli sviluppatori.AWS Lambda

Sintassi

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

Proprietà

BatchSize

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

Tipo: integer

Required: No

Impostazione predefinita: 100

CloudFormation compatibilità: 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ì

CloudFormation compatibilità: 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

CloudFormation compatibilità: questa proprietà è unica AWS SAM e non ha un 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

CloudFormation compatibilità: 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 Lambda sviluppatori.

Tipo: FilterCriteria

Required: No

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

KmsKeyArn

L'Amazon Resource Name (ARN) della chiave per crittografare le informazioni relative a questo evento.

Tipo: Stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla KmsKeyArn 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

CloudFormation compatibilità: 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ì

CloudFormation compatibilità: 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 da Gestione dei segreti AWS. 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

CloudFormation compatibilità: questa proprietà è unica AWS SAM e non ha un 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ì

CloudFormation compatibilità: 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