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à.
# AWS Batch flusso di eventi per Amazon EventBridge
Puoi utilizzare lo stream di AWS Batch eventi per Amazon per EventBridge ricevere notifiche quasi in tempo reale sullo stato attuale dei lavori nelle tue code di lavoro.
Puoi utilizzarlo EventBridge per ottenere ulteriori informazioni sul tuo AWS Batch servizio. Più specificamente, puoi utilizzarlo per controllare lo stato di avanzamento dei lavori, creare flussi di lavoro AWS Batch personalizzati, generare report o metriche sull'utilizzo o creare dashboard personalizzate. Con AWS Batch e EventBridge, non è necessario pianificare e monitorare un codice che effettui continuamente sondaggi AWS Batch per rilevare eventuali modifiche allo stato delle mansioni. Puoi invece gestire le modifiche dello stato del AWS Batch lavoro in modo asincrono utilizzando una varietà di obiettivi Amazon. EventBridge Questi includono AWS Lambda Amazon Simple Queue Service, Amazon Simple Notification Service o Amazon Kinesis Data Streams.
È garantito che AWS Batch gli eventi del flusso di eventi vengano consegnati almeno una volta. Nel caso di invio di eventi duplicati, l'evento fornisce informazioni sufficienti a identificare i duplicati. In questo modo, puoi confrontare la data e l'ora dell'evento e lo stato del lavoro.
AWS Batch i posti di lavoro sono disponibili come EventBridge obiettivi. Utilizzando regole semplici, puoi abbinare gli eventi e inviare AWS Batch lavori in risposta ad essi. Per ulteriori informazioni, consulta [Cos'è EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) nella *Amazon EventBridge User Guide*. Puoi anche usarla EventBridge per pianificare azioni automatiche che si attivano automaticamente in determinati momenti utilizzando **cron** o valuta le espressioni. Per ulteriori informazioni, consulta la sezione [Creazione di una EventBridge regola Amazon che viene eseguita secondo una pianificazione](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) nella *Amazon EventBridge User Guide*. Per un esempio di procedura guidata, consulta [AWS Batch i posti di lavoro come EventBridge obiettivi](batch-cwe-target.md). Per informazioni sull'uso dello EventBridge Scheduler, consulta [Configurazione di Amazon EventBridge Scheduler](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html) nella Amazon EventBridge User Guide.
**Topics**
+ [AWS Batch eventi](batch_cwe_events.md)
+ [Tutorial: utilizzare le notifiche AWS utente con AWS Batch](using-user-notifications.md)
+ [AWS Batch i posti di lavoro come EventBridge obiettivi](batch-cwe-target.md)
+ [Tutorial: ascolta gli eventi AWS Batch di lavoro utilizzando EventBridge](batch_cwet.md)
+ [Tutorial: invio di avvisi di Amazon Simple Notification Service per eventi di lavoro non riusciti](batch_sns_tutorial.md)
# AWS Batch eventi
AWS Batch invia gli eventi di modifica dello stato del lavoro a EventBridge. AWS Batch tiene traccia dello stato dei tuoi lavori. Se lo stato di un lavoro inviato in precedenza cambia, viene richiamato un evento. Ad esempio, se un lavoro nello `RUNNING` stato passa allo `FAILED` stato. Questi eventi vengono classificati come eventi di modifica dello stato del processo.
**Nota**
AWS Batch potrebbe aggiungere altri tipi di eventi, fonti e dettagli in futuro. Se stai deserializzando a livello di codice i dati JSON degli eventi, assicurati che l'applicazione sia pronta a gestire proprietà sconosciute. Questo serve per evitare problemi se e quando vengono aggiunte queste proprietà aggiuntive.
# Eventi di modifica dello stato del lavoro
Ogni volta che un job esistente (inviato in precedenza) cambia stato, viene creato un evento. Per ulteriori informazioni sugli stati AWS Batch lavorativi, vedere[Job stati](job_states.md).
**Nota**
Gli eventi non vengono creati per l'invio iniziale del lavoro.
**Example Evento di modifica dello stato del processo**
Gli eventi di modifica dello stato del lavoro vengono forniti nel seguente formato. La `detail` sezione è simile all'[JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html)oggetto restituito da un'operazione [DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API nell'*AWS Batch API Reference*. Per ulteriori informazioni sui EventBridge parametri, consulta [Events and Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) nella *Amazon EventBridge User Guide*.
```
{
"version": "0",
"id": "c8f9c4b5-76e5-d76a-f980-7011e206042b",
"detail-type": "Batch Job State Change",
"source": "aws.batch",
"account": "123456789012",
"time": "2022-01-11T23:36:40Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8"
],
"detail": {
"jobArn": "arn:aws:batch:us-east-1:123456789012:job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobName": "event-test",
"jobId": "4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobQueue": "arn:aws:batch:us-east-1:123456789012:job-queue/PexjEHappyPathCanary2JobQueue",
"status": "RUNNABLE",
"attempts": [],
"createdAt": 1641944200058,
"retryStrategy": {
"attempts": 2,
"evaluateOnExit": []
},
"dependsOn": [],
"jobDefinition": "arn:aws:batch:us-east-1:123456789012:job-definition/first-run-job-definition:1",
"parameters": {},
"container": {
"image": "137112412989.dkr.ecr.us-east-1.amazonaws.com/amazonlinux:latest",
"command": [
"sleep",
"600"
],
"volumes": [],
"environment": [],
"mountPoints": [],
"ulimits": [],
"networkInterfaces": [],
"resourceRequirements": [
{
"value": "2",
"type": "VCPU"
}, {
"value": "256",
"type": "MEMORY"
}
],
"secrets": []
},
"propagateTags": false,
"platformCapabilities": []
}
}
```
# Eventi bloccati in Job queue
Ogni volta che AWS Batch rileva un lavoro nello `RUNNABLE` stato e quindi blocca una coda, viene creato un evento in Amazon Events. CloudWatch Per ulteriori informazioni sulle cause supportate per le code bloccate, consulta. [Lavori bloccati in uno `RUNNABLE` status](job_stuck_in_runnable.md) Lo stesso motivo è disponibile anche nel `statusReason` campo dell'azione [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API.
**Example Evento bloccato Job queue**
Gli eventi bloccati di Job queue vengono consegnati nel seguente formato. *La `detail` sezione è simile all'[JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html)oggetto restituito da un'operazione [DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API nell'API Reference AWS Batch .* Per ulteriori informazioni sui EventBridge parametri, consulta [Events and Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) nella *Amazon EventBridge User Guide*.
```
{
"version": "0",
"id": "c8f9c4b5-76e5-d76a-f980-7011e206042b",
"detail-type": "Batch Job Queue Blocked",
"source": "aws.batch",
"account": "123456789012",
"time": "2022-01-11T23:36:40Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"arn:aws:batch:us-east-1:123456789012:job-queue/PexjEHappyPathCanary2JobQueue"
],
"detail": {
"jobArn": "arn:aws:batch:us-east-1:123456789012:job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobName": "event-test",
"jobId": "4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobQueue": "arn:aws:batch:us-east-1:123456789012:job-queue/PexjEHappyPathCanary2JobQueue",
"status": "RUNNABLE",
"statusReason": "blocked-reason",
"attempts": [],
"createdAt": 1641944200058,
"retryStrategy": {
"attempts": 2,
"evaluateOnExit": []
},
"dependsOn": [],
"jobDefinition": "arn:aws:batch:us-east-1:123456789012:job-definition/first-run-job-definition:1",
"parameters": {},
"container": {
"image": "137112412989.dkr.ecr.us-east-1.amazonaws.com/amazonlinux:latest",
"command": [
"sleep",
"600"
],
"volumes": [],
"environment": [],
"mountPoints": [],
"ulimits": [],
"networkInterfaces": [],
"resourceRequirements": [
{
"value": "2",
"type": "VCPU"
}, {
"value": "256",
"type": "MEMORY"
}
],
"secrets": []
},
"propagateTags": false,
"platformCapabilities": []
}
}
```
# Eventi di modifica dello stato del lavoro del servizio
Ogni volta che un job di servizio esistente cambia stato, viene creato un evento. Per ulteriori informazioni sugli stati dei processi di assistenza, vedere[Mappatura dello stato AWS Batch del lavoro del servizio allo stato dell' SageMaker IA](service-job-status.md).
**Nota**
Gli eventi non vengono creati per l'invio iniziale del lavoro.
**Example Evento Service Job State Change**
Gli eventi di modifica dello stato del lavoro di servizio vengono forniti nel seguente formato. La `detail` sezione è simile alla risposta restituita da un'operazione [DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API nell'*AWS Batch API Reference*. Per ulteriori informazioni sui EventBridge parametri, consulta [Events and Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) nella *Amazon EventBridge User Guide*.
I `serviceRequestPayload` campi `tags` e non sono inclusi nell'evento`detail`.
```
{
"version": "0",
"id": "c8f9c4b5-76e5-d76a-f980-7011e206042b",
"detail-type": "Batch Service Job State Change",
"source": "aws.batch",
"account": "123456789012",
"time": "2022-01-11T23:36:40Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:service-job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8"
],
"detail": {
"attempts": [
{
"serviceResourceId": {
"name": "TrainingJobArn",
"value": "arn:aws:sagemaker:us-east-1:123456789012:training-job/AWSBatchmy-training-job88b610a69aa8380ca5b0a7aba3f81cb8"
},
"startedAt": 1641944300058,
"stoppedAt": 1641944400058,
"statusReason": "Received status from SageMaker: Training job completed"
}
],
"createdAt": 1641944200058,
"jobArn": "arn:aws:batch:us-east-1:123456789012:service-job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobId": "0bb17543-ece6-4480-b1a7-a556d344746b",
"jobName": "event-test",
"jobQueue": "arn:aws:batch:us-east-1:123456789012:job-queue/HappyPathJobQueue",
"latestAttempt": {
"serviceResourceId": {
"name": "TrainingJobArn",
"value": "arn:aws:sagemaker:us-east-1:123456789012:training-job/AWSBatchmy-training-job88b610a69aa8380ca5b0a7aba3f81cb8"
}
},
"serviceJobType": "SAGEMAKER_TRAINING",
"startedAt": 1641944300058,
"status": "SUCCEEDED",
"statusReason": "Received status from SageMaker: Training job completed",
"stoppedAt": 1641944400058,
"timeoutConfig": {
"attemptDurationSeconds": 60
}
}
}
```
# Eventi bloccati nella coda dei lavori di servizio
Ogni volta che AWS Batch rileva una coda bloccata, viene creato un evento in Amazon Events. CloudWatch Il motivo della coda bloccata è disponibile nel `statusReason` campo dell'azione API. [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)
**Example Evento bloccato Service Job Queue**
Gli eventi bloccati di Service Job Queue vengono forniti nel seguente formato. *La `detail` sezione è simile alla risposta restituita dall'operazione [DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API nell'API Reference AWS Batch .* Per ulteriori informazioni sui EventBridge parametri, consulta [Events and Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) nella *Amazon EventBridge User Guide*.
I `serviceRequestPayload` campi `tags` e non sono inclusi nell'evento`detail`.
```
{
"version": "0",
"id": "c8f9c4b5-76e5-d76a-f980-7011e206042b",
"detail-type": "Batch Service Job Queue Blocked",
"source": "aws.batch",
"account": "123456789012",
"time": "2022-01-11T23:36:40Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:service-job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8"
],
"detail": {
"attempts": [],
"createdAt": 1641944200058,
"jobArn": "arn:aws:batch:us-east-1:123456789012:service-job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobId": "6271dfdf-d8a7-41b1-a4d2-55a2224f5375",
"jobName": "event-test",
"jobQueue": "arn:aws:batch:us-east-1:123456789012:job-queue/HappyPathJobQueue",
"serviceJobType": "SAGEMAKER_TRAINING",
"status": "RUNNABLE",
"statusReason": "blocked-reason",
"timeoutConfig": {
"attemptDurationSeconds": 60
}
}
}
```
# Eventi di prelazione dei posti di lavoro nell'assistenza
Gli eventi di priorità vengono pubblicati ogni volta che una sequenza di priorità inizia o si completa. Un evento iniziato viene creato quando viene attivata per la prima volta la priorità per recuperare la capacità presa in prestito. Un evento completato viene creato al termine della sequenza di priorità e include un riepilogo dei tentativi di prelazione.
**Example Evento Service Job Preemption Started**
Gli eventi avviati da Service Job Preemption vengono forniti nel seguente formato. Per ulteriori informazioni sui EventBridge parametri, consulta [Events and Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) nella *Amazon EventBridge User Guide*.
```
{
"version": "0",
"id": "1b4a511e-2737-226a-a1e7-fc97f1cd9681",
"detail-type": "Batch Service Job Preemption Started",
"source": "aws.batch",
"account": "123456789012",
"time": "2026-03-16T19:57:27Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:service-job/51f245a9-2995-4a53-bced-7b3c00028f84"
],
"detail": {
"statusReason": "PREEMPTION_IN_PROGRESS: Cross-share preemption triggered to reclaim borrowed capacity",
"preemptedJobArn": "arn:aws:batch:us-east-1:123456789012:service-job/51f245a9-2995-4a53-bced-7b3c00028f84",
"status": "RUNNING"
}
}
```
**Example Evento Service Job Preemption completato**
Gli eventi completati di Service Job Preemption vengono forniti nel seguente formato. Il `preemptionSummary` campo contiene dettagli sui tentativi anticipati, incluso il conteggio e le informazioni sui tentativi anticipati più recenti.
```
{
"version": "0",
"id": "2b1c6151-c166-edf5-822c-211b3bfd46b2",
"detail-type": "Batch Service Job Preemption Completed",
"source": "aws.batch",
"account": "123456789012",
"time": "2026-03-16T19:57:47Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:service-job/51f245a9-2995-4a53-bced-7b3c00028f84"
],
"detail": {
"preemptedJobArn": "arn:aws:batch:us-east-1:123456789012:service-job/51f245a9-2995-4a53-bced-7b3c00028f84",
"preemptionSummary": {
"preemptedAttemptCount": 1,
"recentPreemptedAttempts": [
{
"serviceResourceId": {
"name": "TrainingJobArn",
"value": "arn:aws:sagemaker:us-east-1:123456789012:training-job/AWSBatchqm-training-job9b2f08f911cf3dd794c1b3e72ae7ca5f"
},
"startedAt": 1773690923359,
"stoppedAt": 1773691064669,
"statusReason": "Cross-share preemption triggered to reclaim borrowed capacity"
}
]
},
"status": "RUNNABLE"
}
}
```
# Tutorial: utilizzare le notifiche AWS utente con AWS Batch
Puoi utilizzare [le notifiche AWS utente](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html) per configurare i canali di consegna per ricevere notifiche sugli AWS Batch eventi. L'utente riceverà una notifica quando un evento corrisponde a una regola specificata. È possibile ricevere notifiche per gli eventi tramite più canali, tra cui e-mail, [Amazon Q Developer in applicazioni chat](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html), notifiche chat, o notifiche push [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html). È anche possibile visualizzare le notifiche nel [Centro notifiche della console](https://console.aws.amazon.com/notifications/). La funzionalità Notifiche all'utente supporta l'aggregazione, che può ridurre il numero di notifiche ricevute durante eventi specifici.
Per configurare le notifiche utente in AWS Batch:
1. Apri la [AWS Batch console](https://console.aws.amazon.com/batch/home).
1. Seleziona **Dashboard (Pannello di controllo)**.
1. Scegli **Configura notifiche**.
1. In **Notifiche AWS utente**, scegli **Crea configurazione di notifica**.
Per ulteriori informazioni su come configurare e visualizzare le notifiche utente, consulta [Introduzione alle notifiche AWS utente](https://docs.aws.amazon.com/notifications/latest/userguide/getting-started.html).
# AWS Batch i posti di lavoro come EventBridge obiettivi
Amazon EventBridge offre un flusso quasi in tempo reale di eventi di sistema che descrivono i cambiamenti nelle risorse di Amazon Web Services. In genere, AWS Batch su Amazon Elastic Container Service, Amazon Elastic Kubernetes Service AWS e Fargate sono disponibili lavori come obiettivi. EventBridge Utilizzando semplici regole, puoi abbinare gli eventi e inviare AWS Batch lavori in risposta ad essi. Per ulteriori informazioni, vedi [Cos'è EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) nella *Amazon EventBridge User Guide*.
Puoi anche usarlo EventBridge per pianificare azioni automatiche che vengono richiamate in determinati momenti utilizzando **cron** o valuta le espressioni. Per ulteriori informazioni, consulta [Creazione di una EventBridge regola Amazon che viene eseguita secondo una pianificazione](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) nella *Amazon EventBridge User Guide*.
Per informazioni su come creare una regola che viene eseguita quando un evento corrisponde a un modello di evento, consulta [Creazione di EventBridge regole Amazon che reagiscono agli eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) nella *Amazon EventBridge User Guide*.
I casi d'uso più comuni AWS Batch per Job as a EventBridge Target includono i seguenti casi d'uso:
+ Un processo pianificato viene eseguito a intervalli di tempo regolari. Ad esempio, un **cron** processo si verifica solo durante le ore di utilizzo ridotto, quando le istanze Amazon EC2 Spot sono meno costose.
+ Un AWS Batch processo viene eseguito in risposta a un'operazione API che ha effettuato l'accesso. CloudTrail Ad esempio, un lavoro viene inviato ogni volta che un oggetto viene caricato in un bucket Amazon S3 specificato. Ogni volta che ciò accade, il trasformatore EventBridge di input passa il nome del bucket e della chiave dell'oggetto ai parametri. AWS Batch
**Nota**
In questo scenario, tutte le AWS risorse correlate devono trovarsi nella stessa regione. Ciò include risorse come il bucket, le EventBridge regole e i log di Amazon S3. CloudTrail
Prima di poter inviare AWS Batch lavori con EventBridge regole e obiettivi, il EventBridge servizio richiede diverse autorizzazioni per eseguire i lavori. AWS Batch Quando crei una regola nella EventBridge console che specifica un AWS Batch lavoro come destinazione, puoi creare anche questo ruolo. Per ulteriori informazioni sul principale del servizio richiesto e le autorizzazioni IAM per questo ruolo, consulta [EventBridge Ruolo IAM](CWE_IAM_role.md).
**Topics**
+ [Tutorial: Creare un AWS Batch lavoro pianificato](scheduled-batch-job.md)
+ [Tutorial: crea una regola con uno schema di eventi](event-pattern-batch-job.md)
+ [Tutorial: passa le informazioni sugli eventi a un AWS Batch target in base a una pianificazione utilizzando il trasformatore EventBridge di ingresso](cwe-input-transformer.md)
# Tutorial: Creare un AWS Batch lavoro pianificato
La procedura seguente illustra come creare un AWS Batch lavoro pianificato e il ruolo EventBridge IAM richiesto.
**Per creare un AWS Batch lavoro pianificato con EventBridge**
**Nota**
Questa procedura è valida per tutti i AWS Batch job di Amazon ECS, Amazon EKS e AWS Fargate.
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Dalla barra di navigazione, seleziona l'opzione Regione AWS da utilizzare.
1. Nel pannello di navigazione, scegli **Regole**.
1. Scegli **Crea regola**.
1. Per **Nome**, specifica un nome univoco per il tuo ambiente di calcolo. Il nome può contenere fino a 64 caratteri. Deve contenere lettere maiuscole e minuscole, numeri, trattini (-) e caratteri di sottolineatura (\$1).
**Nota**
Una regola non può avere lo stesso nome di un'altra regola nella stessa regione e sullo stesso router di eventi.
1. (Facoltativo) In **Descrizione**, inserisci una descrizione per la regola.
1. Per **Select event bus** (Seleziona bus di eventi), scegli il bus di eventi che desideri associare a questa regola. Se vuoi che questa regola corrisponda agli eventi provenienti dal tuo account, seleziona **Predefinito**. Quando un Servizio AWS utente del tuo account emette un evento, questo passa sempre al bus eventi predefinito del tuo account.
1. (Facoltativo) Disattiva la regola sul bus selezionato se non desideri eseguirla immediatamente.
1. Per **Rule type** (Tipo di regola), scegli **Schedule** (Pianifica).
1. Scegli **Continua per creare la regola** o **Avanti**.
1. Per **Schedule pattern** (Modello di pianificazione), esegui una delle seguenti operazioni:
+ Scegli **Una pianificazione dettagliata che viene eseguita a un'ora specifica, ad esempio alle 8:00. PST il primo lunedì di ogni mese**, quindi inserisci un'espressione cron. Per ulteriori informazioni, consulta [Cron Expressions](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) nella *Amazon EventBridge User Guide*.
+ Scegli **una pianificazione che venga eseguita a una frequenza regolare, ad esempio ogni 10 minuti.** e quindi inserisci un'espressione di frequenza.
1. Scegli **Next (Successivo)**.
1. Per **Target types** (Tipi di target), scegli **Servizio AWS**.
1. Per **Seleziona una destinazione**, scegli **Batch job queue**. Quindi, configura quanto segue:
+ **Job queue** (Coda di processo): inserisci il nome della risorsa Amazon (ARN) della coda di processo in cui pianificare il processo.
+ **Job definition:** (Definizione processo:) Inserisci il nome e la revisione o l'ARN completo della definizione del processo da utilizzare per il processo.
+ **Job name:** (Nome processo:) Inserisci un nome per il processo.
+ **Array size:** (Dimensione array:) (Facoltativo) Inserisci una dimensione di array per il processo per eseguire più di una copia. Per ulteriori informazioni, consulta [Lavori di matrice](array_jobs.md).
+ **Job attempts:** (Tentativi dei processi:) (Facoltativo) Inserisci il numero di tentativi del processo in caso di esito negativo. Per ulteriori informazioni, consulta [Ritentativi di lavoro automatizzati](job_retries.md).
1. Per i tipi di destinazione della **coda di processi Batch**, è EventBridge necessaria l'autorizzazione per inviare eventi alla destinazione. EventBridge può creare il ruolo IAM necessario per l'esecuzione della regola. Esegui una di queste operazioni:
+ Per creare un ruolo IAM automaticamente, seleziona **Crea un nuovo ruolo per questa risorsa specifica**.
+ Per utilizzare un ruolo IAM che hai già creato, scegli **Usa il ruolo esistente**.
1. (Facoltativo) Espandere **Additional settings (Impostazioni aggiuntive)**.
1. Per **Configure target input**, scegli come elaborare il testo di un evento prima che venga passato alla destinazione.
1. Per **Età massima dell'evento**, specificate l'intervallo di tempo per cui vengono conservati gli eventi non elaborati.
1. Per **Riprovare**, inserite il numero di volte in cui un evento viene ripetuto.
1. Per la **coda Dead-letter,** scegliete un'opzione per la gestione degli eventi non elaborati. Se necessario, specifica la coda Amazon SQS da utilizzare come coda di lettere non scritte.
1. (Facoltativo) Scegli **Aggiungi destinazione** per aggiungere un’altra destinazione per questa regola.
1. Scegli **Next (Successivo)**.
1. (Facoltativo) Per i **tag**, scegli **Aggiungi nuovo tag per aggiungere un'etichetta** di risorsa per la regola. Per ulteriori informazioni, consulta [Amazon EventBridge tags](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html).
1. Scegli **Next (Successivo)**.
1. Per **Revisione e creazione**, consulta i passaggi di configurazione. Se devi apportare modifiche, seleziona **Edit** (Modifica). Al termine, scegliere **Create rule** (Crea regola).
Per ulteriori informazioni sulla creazione di regole, consulta [Creazione di una EventBridge regola Amazon che viene eseguita secondo una pianificazione](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) nella *Amazon EventBridge User Guide*.
# Tutorial: crea una regola con uno schema di eventi
La procedura seguente illustra come creare una regola con uno schema di eventi.
**Per creare una regola che invii l'evento a un obiettivo quando l'evento corrisponde a uno schema definito**
**Nota**
Questa procedura è valida per tutti i AWS Batch job di Amazon ECS, Amazon EKS e AWS Fargate.
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Dalla barra di navigazione, seleziona l'opzione Regione AWS da utilizzare.
1. Nel pannello di navigazione, scegli **Regole**.
1. Scegli **Crea regola**.
1. Per **Nome**, specifica un nome univoco per il tuo ambiente di calcolo. Il nome può contenere fino a 64 caratteri. Deve contenere lettere maiuscole e minuscole, numeri, trattini (-) e caratteri di sottolineatura (\$1).
**Nota**
Una regola non può avere lo stesso nome di un'altra regola nella stessa regione e sullo stesso router di eventi.
1. (Facoltativo) In **Descrizione**, inserisci una descrizione per la regola.
1. Per **Select event bus** (Seleziona bus di eventi), scegli il bus di eventi che desideri associare a questa regola. Se vuoi che questa regola corrisponda agli eventi provenienti dal tuo account, seleziona **Predefinito**. Quando un Servizio AWS utente del tuo account emette un evento, questo passa sempre al bus eventi predefinito del tuo account.
1. (Facoltativo) Disattiva la regola sul bus selezionato se non desideri eseguirla immediatamente.
1. Per **Rule type** (Tipo di regola), scegli **Rule with an event pattern** (Regola con un modello di eventi).
1. Scegli **Next (Successivo)**.
1. Per **Event Source**, scegli **AWS l'evento o gli eventi EventBridge partner**.
1. (Facoltativo) Per **un evento di esempio**:
1. Per **Tipo di evento di esempio**, scegli **AWS eventi**.
1. Per **gli eventi Sample**, scegliete **Batch Job State Change**.
1. In **Metodo di creazione** scegli **Utilizza modulo del modello**.
1. Per **Event Pattern**:
1. In **Event source (Origine eventi)**, selezionare **Servizi AWS**.
1. Per **Servizio AWS**, scegli **Batch**.
1. Per **Tipo di evento**, scegliete **Batch Job State Change**.
1. Scegli **Next (Successivo)**.
1. Per **Target types** (Tipi di target), scegli **Servizio AWS**.
1. Per **Seleziona un obiettivo**, scegli un tipo di obiettivo. Ad esempio, scegli **Batch job queue.** Quindi specificate quanto segue:
+ **Job queue** (Coda di processo): inserisci il nome della risorsa Amazon (ARN) della coda di processo in cui pianificare il processo.
+ **Job definition:** (Definizione processo:) Inserisci il nome e la revisione o l'ARN completo della definizione del processo da utilizzare per il processo.
+ **Job name:** (Nome processo:) Inserisci un nome per il processo.
+ **Array size:** (Dimensione array:) (Facoltativo) Inserisci una dimensione di array per il processo per eseguire più di una copia. Per ulteriori informazioni, consulta [Lavori di matrice](array_jobs.md).
+ **Job attempts:** (Tentativi dei processi:) (Facoltativo) Inserisci il numero di tentativi del processo in caso di esito negativo. Per ulteriori informazioni, consulta [Ritentativi di lavoro automatizzati](job_retries.md).
1. Per i tipi di destinazione della **coda di processi Batch**, è EventBridge necessaria l'autorizzazione per inviare eventi alla destinazione. EventBridge può creare il ruolo IAM necessario per l'esecuzione della regola. Esegui una di queste operazioni:
+ Per creare un ruolo IAM automaticamente, seleziona **Create a new role for this specific resource (Crea un nuovo ruolo per questa risorsa specifica)**.
+ Per utilizzare un ruolo IAM creato in precedenza, seleziona **Use existing role (Utilizza un ruolo esistente)**.
1. (Facoltativo) Espandere **Additional settings (Impostazioni aggiuntive)**.
1. Per **Configure target input**, scegli come viene elaborato il testo di un evento.
1. Per **Età massima dell'evento**, specificate l'intervallo di tempo per cui vengono conservati gli eventi non elaborati.
1. Per **Riprovare**, inserite il numero di volte in cui un evento viene ripetuto.
1. Per la **coda Dead-letter,** scegliete un'opzione per la gestione degli eventi non elaborati. Se necessario, specifica la coda Amazon SQS da utilizzare come coda di lettere non scritte.
1. (Facoltativo) Scegli **Aggiungi un altro obiettivo per aggiungere un altro obiettivo**.
1. Scegli **Next (Successivo)**.
1. (Facoltativo) Per **Tag**, scegli **Aggiungi nuovo tag** per aggiungere un'etichetta di risorsa. Per ulteriori informazioni, consulta i [ EventBridge tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) nella *Amazon EventBridge User Guide*.
1. Scegli **Next (Successivo)**.
1. Per **Revisione e creazione**, consulta i passaggi di configurazione. Se devi apportare modifiche, seleziona **Edit** (Modifica). Dopo aver finito, scegli **Crea regola**.
Per ulteriori informazioni sulla creazione di regole, consulta la sezione [Creazione di EventBridge regole Amazon che reagiscono agli eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) nella *Amazon EventBridge User Guide*.
# Tutorial: passa le informazioni sugli eventi a un AWS Batch target in base a una pianificazione utilizzando il trasformatore EventBridge di ingresso
È possibile utilizzare il trasformatore EventBridge di input per trasmettere informazioni sugli eventi durante l'invio AWS Batch di un lavoro. Ciò può essere particolarmente utile se si richiamano lavori a seguito di altre AWS informazioni sull'evento. Un esempio è il caricamento di un oggetto su un bucket Amazon S3. Puoi anche utilizzare una definizione di processo con valori di sostituzione dei parametri nel comando del contenitore. Il trasformatore EventBridge di input può fornire i valori dei parametri in base ai dati dell'evento.
Quindi, in seguito, si crea un target di AWS Batch evento che analizza le informazioni dall'evento che lo avvia e le trasforma in un oggetto. `parameters` Quando il processo viene eseguito, i parametri dell'evento trigger vengono passati al comando del contenitore del lavoro.
**Nota**
In questo scenario, tutte le AWS risorse (ad esempio bucket, EventBridge regole e CloudTrail log di Amazon S3) devono trovarsi nella stessa regione.
**Per creare un AWS Batch target che utilizzi il trasformatore di input**
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Dalla barra di navigazione, seleziona l'opzione Regione AWS da utilizzare.
1. Nel pannello di navigazione, scegli **Regole**.
1. Scegli **Crea regola**.
1. Per **Nome**, specifica un nome univoco per il tuo ambiente di calcolo. Il nome può contenere fino a 64 caratteri. Deve contenere lettere maiuscole e minuscole, numeri, trattini (-) e caratteri di sottolineatura (\$1).
**Nota**
Una regola non può avere lo stesso nome di un'altra regola nello stesso Regione AWS bus di eventi sullo stesso bus di eventi.
1. (Facoltativo) In **Descrizione** immetti una descrizione per la regola.
1. Per **Router di eventi**, scegli quello che desideri associare a questa regola. Se vuoi che questa regola corrisponda agli eventi provenienti dal tuo account, seleziona **Predefinito**. Quando un Servizio AWS utente emette un evento, questo passa sempre al bus degli eventi predefinito del tuo account.
1. (Facoltativo) Disattiva la regola sul bus selezionato se non desideri eseguirla immediatamente.
1. Per **Tipo di regola**, scegli **Pianifica**.
1. Scegli **Continua per creare la regola** o **Avanti**.
1. Per **Modello di pianificazione**, esegui una delle seguenti operazioni:
+ Scegli **Una pianificazione dettagliata che viene eseguita a un'ora specifica, ad esempio alle 8:00. PST il primo lunedì di ogni mese**, quindi inserisci un'espressione cron. Per ulteriori informazioni, consulta [Cron Expressions](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) nella *Amazon EventBridge User Guide*.
+ Scegli **una pianificazione che venga eseguita a una frequenza regolare, ad esempio ogni 10 minuti.** e quindi inserisci un'espressione di frequenza.
1. Scegli **Next (Successivo)**.
1. Per **Target types** (Tipi di target), scegli **Servizio AWS**.
1. Per **Seleziona una destinazione**, scegli **Batch job queue**. Quindi, configura quanto segue:
+ **Job queue** (Coda di processo): inserisci il nome della risorsa Amazon (ARN) della coda di processo in cui pianificare il processo.
+ **Job definition:** (Definizione processo:) Inserisci il nome e la revisione o l'ARN completo della definizione del processo da utilizzare per il processo.
+ **Job name:** (Nome processo:) Inserisci un nome per il processo.
+ **Array size:** (Dimensione array:) (Facoltativo) Inserisci una dimensione di array per il processo per eseguire più di una copia. Per ulteriori informazioni, consulta [Lavori di matrice](array_jobs.md).
+ **Job attempts:** (Tentativi dei processi:) (Facoltativo) Inserisci il numero di tentativi del processo in caso di esito negativo. Per ulteriori informazioni, consulta [Ritentativi di lavoro automatizzati](job_retries.md).
1. Per i tipi di destinazione della **coda di processi Batch**, è EventBridge necessaria l'autorizzazione per inviare eventi alla destinazione. EventBridge può creare il ruolo IAM necessario per l'esecuzione della regola. Esegui una delle seguenti operazioni:
+ Per creare un ruolo IAM automaticamente, seleziona **Crea un nuovo ruolo per questa risorsa specifica**.
+ Per utilizzare un ruolo IAM che hai già creato, scegli **Usa il ruolo esistente**.
1. (Facoltativo) Espandere **Additional settings (Impostazioni aggiuntive)**.
1. Nella sezione **Additional settings** (Impostazioni aggiuntive), per **Configure target input** (Configura input di destinazione, scegli **Input Transformer** (Trasformatore di input).
1. Seleziona **Configura il trasformatore di input**.
1. (Facoltativo) Per l'**evento Sample**:
1. Per **Tipo di evento di esempio**, scegli **AWS eventi**.
1. Per **gli eventi Sample**, scegliete **Batch Job State Change**.
1. Nella sezione **Target input transformer** (Trasformatore di input di destinazione), per **Input path** (Percorso di input), specifica i valori da analizzare dell'evento di attivazione. Ad esempio, per analizzare l'evento **Batch Job State Change**, utilizzare il seguente formato JSON.
```
{
"instance": "$.detail.jobId",
"state": "$.detail.status"
}
```
1. Per **Template**, immettete quanto segue.
```
{
"instance": ,
"status":
}
```
1. Scegli **Conferma**.
1. Per **Età massima dell'evento**, specificate l'intervallo di tempo per cui vengono conservati gli eventi non elaborati.
1. Per **Riprovare**, inserite il numero di volte in cui un evento viene ripetuto.
1. Per la **coda Dead-letter,** scegliete un'opzione per la gestione degli eventi non elaborati. Se necessario, specifica la coda Amazon SQS da utilizzare come coda di lettere non scritte.
1. (Facoltativo) Scegli **Aggiungi un altro obiettivo per aggiungere un altro obiettivo**.
1. Scegli **Next (Successivo)**.
1. (Facoltativo) Per **Tag**, scegli **Aggiungi nuovo tag** per aggiungere un'etichetta di risorsa. Per ulteriori informazioni, consulta i [ EventBridge tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) nella *Amazon EventBridge User Guide*.
1. Scegli **Next (Successivo)**.
1. Per **Revisione e creazione**, consulta i passaggi di configurazione. Se devi apportare modifiche, seleziona **Edit** (Modifica). Dopo aver finito, scegli **Crea regola**.
# Tutorial: ascolta gli eventi AWS Batch di lavoro utilizzando EventBridge
In questo tutorial, configuri una semplice AWS Lambda funzione che ascolta gli eventi di AWS Batch lavoro e li scrive in un flusso di log di CloudWatch Logs.
## Prerequisiti
Questo tutorial presuppone che tu disponga di un ambiente di calcolo funzionante e di una coda di processo pronti per accettare processi. Se non disponi di un ambiente di elaborazione in esecuzione e di una coda di lavoro da cui acquisire gli eventi, segui i passaggi indicati per crearne uno. [Guida introduttiva ai AWS Batch tutorial](Batch_GetStarted.md) Alla fine di questo tutorial, puoi facoltativamente inviare un lavoro a questa coda di lavori per verificare di aver configurato correttamente la tua funzione Lambda.
**Topics**
+ [Prerequisiti](#cwet_prereqs)
+ [Tutorial: Creare la funzione Lambda](cwet_create_lam.md)
+ [Tutorial: registra la regola dell'evento](cwet_register_event_rule.md)
+ [Tutorial: verifica la tua configurazione](cwet_test.md)
# Tutorial: Creare la funzione Lambda
In questa procedura, crei una semplice funzione Lambda che funga da destinazione per i messaggi del flusso di AWS Batch eventi.
**Per creare una funzione Lambda di destinazione**
1. Apri la AWS Lambda console all'indirizzo [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).
1. Scegli **Create function (Crea funzione)** e **Author from scratch (Crea da zero)**.
1. Nel campo **Function name (Nome funzione)**, immettere **batch-event-stream-handler**.
1. In **Runtime**, scegliere **Python 3.8**.
1. Scegli **Crea funzione**.
1. Nella sezione **Codice sorgente**, modifica il codice di esempio in modo che corrisponda al seguente esempio:
```
import json
def lambda_handler(event, _context):
# _context is not used
del _context
if event["source"] != "aws.batch":
raise ValueError("Function only supports input from events with a source type of: aws.batch")
print(json.dumps(event))
```
Questa è una semplice funzione Python 3.8 che stampa gli eventi inviati da. AWS Batch Se tutto è configurato correttamente, alla fine di questo tutorial, i dettagli dell'evento vengono visualizzati nel flusso di log CloudWatch Logs associato a questa funzione Lambda.
1. Seleziona **Deploy (Implementa)**.
# Tutorial: registra la regola dell'evento
In questa sezione, crei una regola di EventBridge evento che registra gli eventi di lavoro provenienti dalle tue AWS Batch risorse. Questa regola registra tutti gli eventi provenienti AWS Batch dall'account in cui è definita. I messaggi di lavoro stessi contengono informazioni sull'origine dell'evento, inclusa la coda dei lavori in cui è stato inviato. È possibile utilizzare queste informazioni per filtrare e ordinare gli eventi a livello di programmazione.
**Nota**
Se utilizzi il Console di gestione AWS per creare una regola di evento, la console aggiunge automaticamente le autorizzazioni IAM per EventBridge chiamare la tua funzione Lambda. Tuttavia, se stai creando una regola di evento utilizzando il AWS CLI, devi concedere le autorizzazioni in modo esplicito. Per ulteriori informazioni, consulta [Events and Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) nella *Amazon EventBridge User Guide*.
**Per creare la tua EventBridge regola**
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Nel pannello di navigazione, scegli **Regole**.
1. Scegli **Create rule** (Crea regola).
1. Inserire un nome e una descrizione per la regola.
Una regola non può avere lo stesso nome di un'altra regola nella stessa regione e sullo stesso router di eventi.
1. Per **Select event bus** (Seleziona bus di eventi), scegli il bus di eventi che desideri associare a questa regola. Se la regola deve cercare eventi corrispondenti provenienti dal tuo account, seleziona **Bus di eventi predefiniti di AWS **. Quando un AWS servizio del tuo account emette un evento, questo passa sempre al bus eventi predefinito del tuo account.
1. Per **Rule type** (Tipo di regola), scegli **Rule with an event pattern** (Regola con un modello di eventi).
1. Scegli **Next (Successivo)**.
1. In **Event source** (Origine eventi), scegli **Other** (Altro).
1. Per **Event pattern**, seleziona **Modelli personalizzati (editor JSON**).
1. Incolla il modello di eventi seguente nell'area di testo.
```
{
"source": [
"aws.batch"
]
}
```
Questa regola si applica a tutti i AWS Batch gruppi e a tutti gli AWS Batch eventi. In alternativa, puoi creare una regola più specifica per filtrare alcuni risultati.
1. Scegli **Next (Successivo)**.
1. Per **Target types** (Tipi di destinazione), scegli **AWS service** (Servizio ).
1. Per **Seleziona un obiettivo**, scegli la funzione **Lambda e seleziona la tua funzione** Lambda.
1. (Facoltativo) Per **Additional settings** (Impostazioni aggiuntive), procedi come segue:
1. Per **Maximum age of event** (Età massima dell'evento), immetti un valore compreso tra un minuto (00:01) e 24 ore (24:00).
1. Per **Tentativi**, specifica un numero compreso tra 0 e 185.
1. Per la **coda di lettere** non scritte, scegli se utilizzare una coda Amazon SQS standard come coda di lettere non scritte. EventBridge invia gli eventi che corrispondono a questa regola alla coda di lettere non scritte se non vengono consegnati correttamente alla destinazione. Esegui una di queste operazioni:
+ Scegli **Nessuna** per non utilizzare una coda DLQ.
+ Scegli **Seleziona una coda Amazon SQS nell' AWS account corrente da utilizzare come coda di lettere non scritte, quindi seleziona la coda** da utilizzare dal menu a discesa.
+ Scegli **Seleziona una coda Amazon SQS in un altro AWS account come coda di lettere non scritte, quindi inserisci l'ARN della coda** da utilizzare. È necessario allegare una policy basata sulle risorse alla coda che conceda l'autorizzazione a inviarle messaggi. EventBridge *Per ulteriori informazioni, consulta [Concessione delle autorizzazioni alla coda delle lettere non scritte nella Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms) User Guide. EventBridge *
1. Scegli **Next (Successivo)**.
1. (Facoltativo) Inserire uno o più tag per la regola. Per ulteriori informazioni, consulta i [ EventBridge tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) nella *Amazon EventBridge User Guide*.
1. Scegli **Next (Successivo)**.
1. Rivedi i dettagli della regola e scegli **Create rule** (Crea regola).
# Tutorial: verifica la tua configurazione
Ora puoi testare la tua EventBridge configurazione inviando un lavoro alla tua coda di lavoro. Se tutto è configurato correttamente, la funzione Lambda viene attivata e scrive i dati dell'evento in un flusso di log di CloudWatch Logs per la funzione.
**Per testare la configurazione**
1. Apri la console all' AWS Batch indirizzo. [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/)
1. Invia un nuovo AWS Batch lavoro. Per ulteriori informazioni, consulta [Tutorial: invia un lavoro](submit_job.md).
1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Nel pannello di navigazione, scegli **Logs** e seleziona il gruppo di log per la tua funzione Lambda (ad esempio**,** *my-function* /aws/lambda/).
1. Seleziona un flusso di log per visualizzare i dati di evento.
# Tutorial: invio di avvisi di Amazon Simple Notification Service per eventi di lavoro non riusciti
In questo tutorial, configuri una regola di EventBridge evento Amazon che acquisisce solo gli eventi di lavoro in cui il lavoro è passato a uno `FAILED` stato. Alla fine di questo tutorial, puoi facoltativamente anche inviare un lavoro a questa coda di lavori. Questo serve per verificare che gli avvisi di Amazon SNS siano stati configurati correttamente.
## Prerequisiti
Questo tutorial presuppone che tu disponga di un ambiente di calcolo funzionante e di una coda di processo pronti per accettare processi. Se non disponi di un ambiente di elaborazione in esecuzione e di una coda di lavoro da cui acquisire gli eventi, segui i passaggi indicati per crearne uno. [Guida introduttiva ai AWS Batch tutorial](Batch_GetStarted.md)
**Topics**
+ [Prerequisiti](#batch_sns_prereq)
+ [Tutorial: creare e sottoscrivere un argomento di Amazon SNS](batch_sns_create_topic.md)
+ [Tutorial: Registra una regola di evento](batch_sns_reg_rule.md)
+ [Tutorial: verifica la tua regola](batch_sns_test_rule.md)
+ [Regola alternativa: coda di processi Batch bloccata](#test_blocked_job_queue)
# Tutorial: creare e sottoscrivere un argomento di Amazon SNS
In questo tutorial, configuri un argomento Amazon SNS che funga da destinazione evento per la nuova regola di evento.
**Come creare un argomento Amazon SNS**
1. [Apri la console Amazon SNS nella versione v3/home. https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home)
1. Scegliere **Topics (Argomenti)**, **Create topic (Crea argomento)**.
1. Per **Tipo**, scegliere **Standard**.
1. **Per **Nome**, inserisci **JobFailedAlert** e scegli Crea argomento.**
1. Sullo **JobFailedAlert**schermo, scegli **Crea abbonamento**.
1. Per **Protocollo**, scegli **E-mail**.
1. In **Endpoint**, inserire un indirizzo e-mail a cui si ha accesso correntemente, quindi scegliere **Crea sottoscrizione**.
1. Controlla l'account e-mail e attendi di ricevere una e-mail di conferma della sottoscrizione. Una volta ricevuta, seleziona **Confirm subscription** (Conferma sottoscrizione).
# Tutorial: Registra una regola di evento
Quindi, registra una regola di evento che acquisisca solo gli eventi di processi non riusciti.
**Per registrare la tua EventBridge regola**
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Nel pannello di navigazione, scegli **Regole**.
1. Scegli **Create rule** (Crea regola).
1. Inserire un nome e una descrizione per la regola.
Una regola non può avere lo stesso nome di un'altra regola nella stessa regione e sullo stesso router di eventi.
1. Per **Select event bus** (Seleziona bus di eventi), scegli il bus di eventi che desideri associare a questa regola. Se la regola deve cercare eventi corrispondenti provenienti dal tuo account, seleziona **Bus di eventi predefiniti di AWS **. Quando un AWS servizio del tuo account emette un evento, questo passa sempre al bus eventi predefinito del tuo account.
1. Per **Rule type** (Tipo di regola), scegli **Rule with an event pattern** (Regola con un modello di eventi).
1. Scegli **Next (Successivo)**.
1. In **Event source** (Origine eventi), scegli **Other** (Altro).
1. Per **Event pattern**, seleziona **Modelli personalizzati (editor JSON**).
1. Incolla il modello di eventi seguente nell'area di testo.
```
{
"detail-type": [
"Batch Job State Change"
],
"source": [
"aws.batch"
],
"detail": {
"status": [
"FAILED"
]
}
}
```
Questo codice definisce una EventBridge regola che corrisponde a qualsiasi evento in cui si trova lo stato del lavoro. `FAILED` Per ulteriori informazioni sui pattern di eventi, consulta [Events and Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) nella *Amazon EventBridge User Guide*.
1. Scegli **Next (Successivo)**.
1. Per **Target types** (Tipi di destinazione), scegli **AWS service** (Servizio ).
1. Per **Seleziona un target**, scegli l'**argomento SNS** e per **Argomento**, scegli **JobFailedAlert**.
1. (Facoltativo) Per **Additional settings** (Impostazioni aggiuntive), procedi come segue:
1. Per **Maximum age of event** (Età massima dell'evento), immetti un valore compreso tra un minuto (00:01) e 24 ore (24:00).
1. Per **Tentativi**, specifica un numero compreso tra 0 e 185.
1. Per la **coda di lettere** non scritte, scegli se utilizzare una coda Amazon SQS standard come coda di lettere non scritte. EventBridge invia gli eventi che corrispondono a questa regola alla coda di lettere non scritte se non vengono consegnati correttamente alla destinazione. Esegui una di queste operazioni:
+ Scegli **Nessuna** per non utilizzare una coda DLQ.
+ Scegli **Seleziona una coda Amazon SQS nell' AWS account corrente da utilizzare come coda di lettere non scritte, quindi seleziona la coda** da utilizzare dal menu a discesa.
+ Scegli **Seleziona una coda Amazon SQS in un altro AWS account come coda di lettere non scritte, quindi inserisci l'ARN della coda** da utilizzare. È necessario allegare una policy basata sulle risorse alla coda che conceda l'autorizzazione a inviarle messaggi. EventBridge *Per ulteriori informazioni, consulta [Concessione delle autorizzazioni alla coda delle lettere non scritte nella Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms) User Guide. EventBridge *
1. Scegli **Next (Successivo)**.
1. (Facoltativo) Inserire uno o più tag per la regola. Per ulteriori informazioni, consulta i [ EventBridge tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) nella *Amazon EventBridge User Guide*.
1. Scegli **Next (Successivo)**.
1. Rivedi i dettagli della regola e scegli **Create rule** (Crea regola).
# Tutorial: verifica la tua regola
Per testare la regola, invia un processo che termini subito dopo l'avvio con un codice di uscita diverso da zero. Se la regola dell'evento è configurata correttamente, dovresti ricevere un messaggio e-mail entro pochi minuti con il testo dell'evento.
**Verifica di una regola**
1. Apri la AWS Batch console all'indirizzo [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Invia un nuovo AWS Batch lavoro. Per ulteriori informazioni, consulta [Tutorial: invia un lavoro](submit_job.md). Per il comando del processo, sostituisci questo comando per uscire dal container con un codice di uscita 1.
```
/bin/sh, -c, 'exit 1'
```
1. Controlla la tua e-mail per confermare di aver ricevuto un avviso e-mail per la notifica di lavoro non riuscito.
## Regola alternativa: coda di processi Batch bloccata
Per creare una regola di evento che controlli il *blocco della coda dei processi in batch*, ripeti questi tutorial con le seguenti modifiche:
1. **In [Tutorial: creare e sottoscrivere un argomento di Amazon SNS](batch_sns_create_topic.md)**, usa *BlockedJobQueue* come nome dell'argomento.
1. **In [Tutorial: Registra una regola di evento](batch_sns_reg_rule.md)**, usa il seguente schema nell'editor JSON:
```
{
"detail-type": [
"Batch Job Queue Blocked"
],
"source": [
"aws.batch"
]
}
```