Inviare un evento personalizzato a un bus EventBridge eventi - AWS Step Functions

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à.

Inviare un evento personalizzato a un bus EventBridge eventi

Questo progetto di esempio dimostra come utilizzare Step Functions per inviare un evento personalizzato a un bus di eventi che corrisponde a una regola con più destinazioni (Amazon EventBridge, AWS Lambda, Amazon Simple Notification Service, Amazon Simple Queue Service).

Per ulteriori informazioni sulle integrazioni dei servizi Step Functions e Step Functions, consulta quanto segue:

Nota

Questo progetto di esempio potrebbe comportare costi.

Per nuove AWS per gli utenti, è disponibile un piano di utilizzo gratuito. In questo piano, i servizi sono gratuiti al di sotto di un determinato livello di utilizzo. Per ulteriori informazioni sull' AWS costi e il piano gratuito, vedi EventBridge Prezzi.

Fase 1: Creare la macchina a stati

  1. Apri la console Step Functions e scegli Crea macchina a stati.

  2. Digita Send a custom event to EventBridge nella casella di ricerca, quindi scegli Invia un evento personalizzato a EventBridgedai risultati di ricerca restituiti.

  3. Seleziona Successivo per continuare.

  4. Scegli Esegui una demo per creare un ready-to-deploy flusso di lavoro di sola lettura o scegli Crea su di esso per creare una definizione di macchina a stati modificabile su cui basarti e distribuire in un secondo momento.

    Questo progetto di esempio utilizza le seguenti risorse:

    • Un record Amazon EventBridge evento

    • Un record Amazon SNS topic

    • Un record Amazon SQS coda

    • A Lambda funzione

    • Un record AWS Step Functions macchina a stati

    • Correlati AWS Identity and Access Management (IAM) ruoli

    L'immagine seguente mostra il grafico del flusso di lavoro per l'evento Invia un evento personalizzato a EventBridgeprogetto di esempio:

    Grafico del flusso di lavoro del programma Invia un evento personalizzato a EventBridgeprogetto di esempio.
  5. Scegli Usa modello per continuare con la selezione.

I passaggi successivi dipendono dalla scelta precedente:

  1. Esegui una demo: puoi esaminare la macchina a stati prima di creare un progetto di sola lettura con risorse distribuite da AWS CloudFormation al tuo Account AWS.

    Puoi visualizzare la definizione della macchina a stati e, quando sei pronto, scegli Implementa ed esegui per distribuire il progetto e creare le risorse.

    La creazione di risorse e autorizzazioni può richiedere fino a 10 minuti per la distribuzione. Puoi utilizzare il link Stack ID per monitorare i progressi in AWS CloudFormation.

    Una volta completata la distribuzione, dovresti vedere la tua nuova macchina a stati nella console.

  2. Sviluppala: puoi rivedere e modificare la definizione del flusso di lavoro. Potrebbe essere necessario impostare i valori per i segnaposto nel progetto di esempio prima di provare a eseguire il flusso di lavoro personalizzato.

Nota

Potrebbero essere applicati costi standard per i servizi distribuiti sul tuo account.

Passaggio 2: Esegui la macchina a stati

  1. Nella pagina Macchine a stati, scegli il tuo progetto di esempio.

  2. Nella pagina del progetto di esempio, scegli Avvia esecuzione.

  3. Nella finestra di dialogo Avvia esecuzione, effettuate le seguenti operazioni:

    1. (Facoltativo) Immettete un nome di esecuzione personalizzato per sovrascrivere il valore predefinito generato.

      ASCIINomi diversi e registrazione

      Step Functions accetta nomi per macchine a stati, esecuzioni, attività ed etichette che contengono non ASCII caratteri. Poiché tali caratteri non funzioneranno con Amazon CloudWatch, ti consigliamo di utilizzare solo ASCII caratteri in modo da poter tenere traccia delle metriche. CloudWatch

    2. (Facoltativo) Nella casella Input, inserisci i valori di input comeJSON. Puoi saltare questo passaggio se stai eseguendo una demo.

    3. Selezionare Start execution (Avvia esecuzione).

    La console Step Functions ti indirizzerà a una pagina dei dettagli di esecuzione in cui puoi scegliere gli stati nella vista Graph per esplorare le informazioni correlate nel Dettagli del passaggio riquadro.

Esempio di codice della macchina a stati

La macchina a stati di questo progetto di esempio si integra EventBridge inviando un evento personalizzato a un bus di EventBridge eventi. L'evento inviato al bus degli eventi corrisponde a una EventBridge regola che attiva una funzione Lambda che invia messaggi a un argomento Amazon e a una coda SNS AmazonSQS.

Sfoglia questo esempio di macchina a stati per vedere come funziona Step Functions EventBridge.

Per ulteriori informazioni su come AWS Step Functions può controllarne altri AWS servizi, vediIntegrazione dei servizi con Step Functions.

{ "Comment": "An example of the Amazon States Language for sending a custom event to Amazon EventBridge", "StartAt": "Send a custom event", "States": { "Send a custom event": { "Resource": "arn:<PARTITION>:states:::events:putEvents", "Type": "Task", "Parameters": { "Entries": [{ "Detail": { "Message": "Hello from Step Functions!" }, "DetailType": "MessageFromStepFunctions", "EventBusName": "<EVENT_BUS_NAME>", "Source": "my.statemachine" }] }, "End": true } } }

Per informazioni su come configurare l'IAMutilizzo di Step Functions con altri AWS servizi, vediIn che modo Step Functions genera IAM politiche per servizi integrati.

IAMEsempio

Questi esempi AWS Identity and Access Management (IAM) le politiche generate dal progetto di esempio includono il minimo privilegio necessario per eseguire la macchina a stati e le risorse correlate. Ti consigliamo di includere solo le autorizzazioni necessarie nelle tue IAM politiche.

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "events:PutEvents" ], "Resource": [ "arn:aws:events:us-east-1:1234567890:event-bus/stepfunctions-sampleproject-eventbus" ], "Effect": "Allow" } ] }

Per informazioni su come configurare l'IAMutilizzo di Step Functions con altri AWS servizi, vediIn che modo Step Functions genera IAM politiche per servizi integrati.