Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# AWS Batch Event-Stream für Amazon EventBridge
Sie können den AWS Batch Event-Stream für Amazon verwenden EventBridge , um nahezu in Echtzeit Benachrichtigungen über den aktuellen Status der Jobs in Ihren Job-Warteschlangen zu erhalten.
Sie können ihn nutzen EventBridge , um weitere Einblicke in Ihren AWS Batch Service zu erhalten. Insbesondere können Sie damit den Fortschritt von Jobs überprüfen, AWS Batch benutzerdefinierte Workflows erstellen, Nutzungsberichte oder Metriken erstellen oder Ihre eigenen Dashboards erstellen. Mit AWS Batch und EventBridge benötigen Sie keinen Planungs- und Überwachungscode, der kontinuierlich AWS Batch nach Änderungen des Auftragsstatus abfragt. Stattdessen können Sie Änderungen des AWS Batch Jobstatus mithilfe einer Vielzahl von EventBridge Amazon-Zielen asynchron verarbeiten. Dazu gehören AWS Lambda Amazon Simple Queue Service, Amazon Simple Notification Service oder Amazon Kinesis Data Streams.
Es wird sichergestellt, dass Ereignisse aus dem AWS Batch Event-Stream mindestens einmal zugestellt werden. Falls doppelte Ereignisse übermittelt werden, enthält das Ereignis ausreichend Informationen, um Duplikate zu erkennen. Auf diese Weise können Sie den Zeitstempel des Ereignisses und den Jobstatus vergleichen.
AWS Batch Jobs sind als EventBridge Ziele verfügbar. Mithilfe einfacher Regeln können Sie Ereignisse zuordnen und als Reaktion darauf AWS Batch Jobs einreichen. Weitere Informationen finden Sie unter [Was ist EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) im * EventBridge Amazon-Benutzerhandbuch*. Sie können es auch verwenden EventBridge , um automatisierte Aktionen zu planen, die sich zu bestimmten Zeiten selbst auslösen, indem Sie Ausdrücke verwenden **cron** oder bewerten. Weitere Informationen finden Sie im [* EventBridge Amazon-Benutzerhandbuch* unter Erstellen einer EventBridge Amazon-Regel, die nach einem Zeitplan ausgeführt](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) wird. Ein Beispiel-Walkthrough finden Sie unter [AWS Batch Jobs als EventBridge Ziele](batch-cwe-target.md). Informationen zur Verwendung des EventBridge Schedulers finden Sie unter [Amazon EventBridge Scheduler einrichten](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html) im EventBridge Amazon-Benutzerhandbuch.
**Topics**
+ [AWS Batch Ereignisse](batch_cwe_events.md)
+ [Tutorial: AWS Benutzerbenachrichtigungen verwenden mit AWS Batch](using-user-notifications.md)
+ [AWS Batch Jobs als EventBridge Ziele](batch-cwe-target.md)
+ [Tutorial: Halten Sie Ausschau nach AWS Batch Job-Events mit EventBridge](batch_cwet.md)
+ [Tutorial: Senden von Amazon Simple Notification Service-Benachrichtigungen für fehlgeschlagene Auftragsereignisse](batch_sns_tutorial.md)
# AWS Batch Ereignisse
AWS Batch sendet Ereignisse zur Änderung des Jobstatus an EventBridge. AWS Batch verfolgt den Status Ihrer Jobs. Wenn sich der Status eines zuvor eingereichten Jobs ändert, wird ein Ereignis ausgelöst. Zum Beispiel, wenn ein Job im `RUNNING` Status in den Status wechselt. `FAILED` Diese Ereignisse sind als Auftragsstatus-Änderungsereignisse klassifiziert.
**Anmerkung**
AWS Batch könnte in future weitere Ereignistypen, Quellen und Details hinzufügen. Wenn Sie JSON-Ereignisdaten programmgesteuert deserialisieren, stellen Sie sicher, dass Ihre Anwendung darauf vorbereitet ist, unbekannte Eigenschaften zu verarbeiten. Dies dient dazu, Probleme zu vermeiden, falls und wann diese zusätzlichen Eigenschaften hinzugefügt werden.
# Ereignisse zur Änderung des Berufsstatus
Jedes Mal, wenn sich der Status eines vorhandenen (zuvor eingereichten) Jobs ändert, wird ein Ereignis ausgelöst. Weitere Informationen zu AWS Batch Jobstatus finden Sie unter[Status der Job](job_states.md).
**Anmerkung**
Für die erste Stelleneingabe werden keine Ereignisse erstellt.
**Example Auftragsstatus-Änderungsereignis**
Ereignisse zur Änderung des Jobstatus werden im folgenden Format übermittelt. Der `detail` Abschnitt ähnelt dem [JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html)Objekt, das von einer [DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API-Operation in der *AWS Batch API-Referenz zurückgegeben wurde*. Weitere Informationen zu EventBridge Parametern finden Sie unter [Ereignisse und Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) im * EventBridge Amazon-Benutzerhandbuch*.
```
{
"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": []
}
}
```
# Blockierte Ereignisse in der Job-Warteschlange
Jedes Mal, wenn ein Job im `RUNNABLE` Status AWS Batch erkannt und somit eine Warteschlange blockiert wird, wird ein Ereignis in Amazon CloudWatch Events erstellt. Weitere Informationen zu den unterstützten Ursachen für blockierte Warteschlangen finden Sie unter[Jobs, die in einem `RUNNABLE` Status feststecken](job_stuck_in_runnable.md). Derselbe Grund ist auch in dem `statusReason` Feld in der [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API-Aktion verfügbar.
**Example Ereignis „Blockierter Job Queue“**
Blockierte Ereignisse in der Jobwarteschlange werden im folgenden Format übermittelt. Der `detail` Abschnitt ähnelt dem [JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html)Objekt, das von einer [DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API-Operation in der *AWS Batch API-Referenz zurückgegeben wurde*. Weitere Informationen zu EventBridge Parametern finden Sie unter [Ereignisse und Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) im * EventBridge Amazon-Benutzerhandbuch*.
```
{
"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": []
}
}
```
# Ereignisse zur Änderung des Status des Servicejobs
Jedes Mal, wenn sich der Status eines vorhandenen Serviceauftrags ändert, wird ein Ereignis ausgelöst. Weitere Informationen zu den Status von Serviceaufträgen finden Sie unter[Zuordnen AWS Batch des Dienstauftragsstatus zum SageMaker AI-Status](service-job-status.md).
**Anmerkung**
Für die erste Einreichung eines Auftrags werden keine Ereignisse erstellt.
**Example Ereignis zur Änderung des Status des Dienstauftrags**
Ereignisse zur Änderung des Status eines Dienstauftrags werden im folgenden Format übermittelt. Der `detail` Abschnitt ähnelt der Antwort, die von einem [DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API-Vorgang in der *AWS Batch API-Referenz* zurückgegeben wird. Weitere Informationen zu EventBridge Parametern finden Sie unter [Ereignisse und Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) im * EventBridge Amazon-Benutzerhandbuch*.
Die `serviceRequestPayload` Felder `tags` und sind nicht im Ereignis enthalten`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
}
}
}
```
# Blockierte Ereignisse in der Warteschlange für Serviceaufträge
Jedes Mal, wenn eine blockierte Warteschlange AWS Batch erkannt wird, wird ein Ereignis in Amazon CloudWatch Events erstellt. Der Grund für die blockierte Warteschlange ist im `statusReason` Feld in der [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API-Aktion verfügbar.
**Example Ereignis „Dienstauftragswarteschlange blockiert“**
Blockierte Ereignisse in der Dienstauftragswarteschlange werden im folgenden Format übermittelt. Der `detail` Abschnitt ähnelt der Antwort, die von der [DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API-Operation in der *AWS Batch API-Referenz zurückgegeben wurde*. Weitere Informationen zu EventBridge Parametern finden Sie unter [Ereignisse und Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) im * EventBridge Amazon-Benutzerhandbuch*.
Die `serviceRequestPayload` Felder `tags` und sind nicht im Ereignis enthalten`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
}
}
}
```
# Ereignisse zur Einstellung von Servicejobs
Präemptionsereignisse werden immer dann veröffentlicht, wenn eine Präemptionssequenz beginnt oder abgeschlossen wird. Ein gestartetes Ereignis wird erzeugt, wenn die Präemption zum ersten Mal ausgelöst wird, um geliehene Kapazität zurückzugewinnen. Ein abgeschlossenes Ereignis wird erstellt, wenn die Präemptionssequenz abgeschlossen ist. Es enthält eine Zusammenfassung der unterbrochenen Versuche.
**Example Ereignis „Preemption Preemption“ wurde gestartet**
Ereignisse, bei denen das Preemption von Serviceaufträgen gestartet wurde, werden im folgenden Format übermittelt. Weitere Informationen zu EventBridge Parametern finden Sie unter [Ereignisse und Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) im * EventBridge Amazon-Benutzerhandbuch*.
```
{
"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 Veranstaltung „Service Job Preemption“ abgeschlossen**
Ereignisse, bei denen der Service Job Preemption abgeschlossen wurde, werden im folgenden Format übermittelt. Das `preemptionSummary` Feld enthält Details zu den unterbrochenen Versuchen, einschließlich der Anzahl und der letzten unterbrochenen Versuche.
```
{
"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: AWS Benutzerbenachrichtigungen verwenden mit AWS Batch
Sie können [AWS Benutzerbenachrichtigungen](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html) verwenden, um Zustellungskanäle einzurichten, über die Sie über AWS Batch Ereignisse informiert werden. Sie erhalten eine Benachrichtigung, wenn ein Ereignis einer von Ihnen angegebenen Regel entspricht. Sie können Benachrichtigungen für Ereignisse über mehrere Kanäle erhalten, einschließlich E-Mail, Chat-Benachrichtigungen von [Amazon Q Developer in Chat-Anwendungen](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html) oder [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)-Push-Benachrichtigungen. Benachrichtigungen werden auch im [Console Notifications Center](https://console.aws.amazon.com/notifications/) angezeigt. Die Funktion für Benutzerbenachrichtigungen unterstützt eine Aggregation, wodurch die Anzahl der Benachrichtigungen, die Sie bei bestimmten Ereignissen erhalten, reduziert werden kann.
So konfigurieren Sie Benutzerbenachrichtigungen in AWS Batch:
1. Öffnen Sie die [AWS Batch -Konsole](https://console.aws.amazon.com/batch/home).
1. Wählen Sie **Dashboard**.
1. Wählen Sie **Benachrichtigungen konfigurieren**.
1. Wählen Sie unter ** AWS Benutzerbenachrichtigungen** die Option **Benachrichtigungskonfiguration erstellen** aus.
Weitere Informationen zum Konfigurieren und Anzeigen von Benutzerbenachrichtigungen finden Sie unter [Erste Schritte mit AWS Benutzerbenachrichtigungen](https://docs.aws.amazon.com/notifications/latest/userguide/getting-started.html).
# AWS Batch Jobs als EventBridge Ziele
Amazon EventBridge liefert nahezu in Echtzeit einen Stream von Systemereignissen, die Änderungen an den Ressourcen von Amazon Web Services beschreiben. In der Regel sind Jobs AWS Batch auf Amazon Elastic Container Service, Amazon Elastic Kubernetes Service und AWS Fargate als Ziele verfügbar. EventBridge Mithilfe einfacher Regeln können Sie Ereignisse zuordnen und als Reaktion darauf AWS Batch Jobs einreichen. Weitere Informationen finden Sie unter [Was ist EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) im * EventBridge Amazon-Benutzerhandbuch*.
Sie können es auch verwenden EventBridge , um automatisierte Aktionen zu planen, die zu bestimmten Zeiten aufgerufen werden, indem Sie Ausdrücke verwenden **cron** oder bewerten. Weitere Informationen finden Sie im [* EventBridge Amazon-Benutzerhandbuch* unter Erstellen einer EventBridge Amazon-Regel, die nach einem Zeitplan ausgeführt](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) wird.
Informationen zum Erstellen einer Regel, die ausgeführt wird, wenn ein Ereignis mit einem Ereignismuster übereinstimmt, finden Sie im [* EventBridge Amazon-Benutzerhandbuch unter Erstellen von EventBridge Amazon-Regeln*, die auf Ereignisse reagieren](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html).
Zu den häufigsten Anwendungsfällen für AWS Batch Jobs als EventBridge Ziel gehören die folgenden Anwendungsfälle:
+ Ein geplanter Job wird in regelmäßigen Zeitintervallen ausgeführt. Ein **cron** Job wird beispielsweise nur zu Zeiten mit geringer Auslastung ausgeführt, wenn Amazon EC2 Spot-Instances günstiger sind.
+ Ein AWS Batch Job wird als Reaktion auf einen API-Vorgang ausgeführt, der angemeldet CloudTrail ist. Beispielsweise wird ein Job immer dann übermittelt, wenn ein Objekt in einen bestimmten Amazon S3 S3-Bucket hochgeladen wird. Jedes Mal, wenn dies passiert, übergibt der EventBridge Eingangstransformator den Bucket und den Schlüsselnamen des Objekts an AWS Batch Parameter.
**Anmerkung**
In diesem Szenario müssen sich alle zugehörigen AWS Ressourcen in derselben Region befinden. Dazu gehören Ressourcen wie der Amazon S3 S3-Bucket, die EventBridge Regel und CloudTrail Protokolle.
Bevor Sie AWS Batch Jobs mit EventBridge Regeln und Zielen einreichen können, benötigt der EventBridge Service mehrere Berechtigungen, um AWS Batch Jobs auszuführen. Wenn Sie in der EventBridge Konsole eine Regel erstellen, die einen AWS Batch Job als Ziel angibt, können Sie auch diese Rolle erstellen. Weitere Informationen über die erforderlichen Service-Prinzipal- und IAM;-Berechtigungen für dies Rolle finden Sie unter [EventBridge IAM-Rolle](CWE_IAM_role.md).
**Topics**
+ [Tutorial: Einen geplanten AWS Batch Job erstellen](scheduled-batch-job.md)
+ [Tutorial: Eine Regel mit einem Ereignismuster erstellen](event-pattern-batch-job.md)
+ [Tutorial: Übergeben von Ereignisinformationen mithilfe des EventBridge Eingangstransformators an ein AWS Batch Ziel nach einem Zeitplan](cwe-input-transformer.md)
# Tutorial: Einen geplanten AWS Batch Job erstellen
Das folgende Verfahren beschreibt, wie Sie einen geplanten AWS Batch Job und die erforderliche EventBridge IAM-Rolle erstellen.
**Um einen geplanten AWS Batch Job zu erstellen mit EventBridge**
**Anmerkung**
Dieses Verfahren funktioniert für alle Jobs AWS Batch auf Amazon ECS, Amazon EKS und AWS Fargate.
1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Wählen Sie in der Navigationsleiste die aus, die Sie verwenden AWS-Region möchten.
1. Wählen Sie im Navigationsbereich **Regeln** aus.
1. Wählen Sie **Regel erstellen** aus.
1. Geben Sie unter **Name** einen eindeutigen Namen für Ihre Rechenumgebung ein. Der Name kann bis zu 64 Zeichen umfassen. Er kann Groß- und Kleinbuchstaben, Zahlen, Bindestriche (-) und Unterstriche (\$1) enthalten.
**Anmerkung**
Eine Regel darf nicht denselben Namen wie eine andere Regel in derselben Region und auf demselben Event Bus haben.
1. (Optional) Geben Sie unter **Beschreibung** eine Beschreibung für die Regel ein.
1. Wählen Sie für **Event Bus** den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, wählen Sie **Standard** aus. Wenn ein AWS-Service in Ihrem Konto ein Ereignis ausgibt, wird es immer an den Standard-Event-Bus Ihres Kontos weitergeleitet.
1. (Optional) Schalten Sie die Regel für den ausgewählten Bus aus, wenn Sie die Regel nicht sofort ausführen möchten.
1. Wählen Sie unter **Rule type** (Regeltyp) die Option **Schedule** (Zeitplan) aus.
1. Wählen Sie **Weiter, um die Regel zu erstellen**, oder **Weiter**.
1. Gehen Sie bei **Schedule pattern** (Zeitplanmuster) wie folgt vor:
+ Wählen Sie **Ein detaillierter Zeitplan, der zu einer bestimmten Zeit ausgeführt wird, z. B. um 8:00 Uhr aus. PST am ersten Montag eines jeden Monats** und geben Sie dann einen Cron-Ausdruck ein. Weitere Informationen finden Sie unter [Cron Expressions](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) im * EventBridge Amazon-Benutzerhandbuch*.
+ Wählen Sie **einen Zeitplan, der regelmäßig ausgeführt wird, z. B. alle 10 Minuten.** und geben Sie dann einen Preisausdruck ein.
1. Wählen Sie **Weiter** aus.
1. Für **Target types** (Zieltypen), wählen Sie **AWS-Service** aus.
1. **Wählen Sie für Wählen Sie ein Ziel** die Option **Batch-Job-Warteschlange** aus. Konfigurieren Sie dann Folgendes:
+ **Job queue** (Auftragswarteschlange): Geben Sie den Amazon-Ressourcennamen (ARN) der Auftragswarteschlange ein, in der Ihr Auftrag eingeplant werden soll.
+ **Auftragsdefinition:** Geben Sie den Namen und die Revision oder den vollständigen ARN der Auftragsdefinition ein, die für Ihren Auftrag verwendet werden sollen.
+ **Job name (Auftragsname):** Geben Sie einen Namen für Ihren Auftrag ein.
+ **Array-Größe:** (Optional) Geben Sie eine Array-Größe für Ihren Auftrag ein, um mehrere Kopien davon auszuführen. Weitere Informationen finden Sie unter [Ordnen Sie Jobs an](array_jobs.md).
+ **Auftragsversuche:** (Optional) Geben Sie an, wie oft die Ausführung Ihres Auftrags versucht werden soll, bevor festgelegt wird, dass er fehlgeschlagen ist. Weitere Informationen finden Sie unter [Automatisierte Auftragswiederholungen](job_retries.md).
1. Für Zieltypen von **Batch-Job-Warteschlangen** ist die Erlaubnis EventBridge erforderlich, Ereignisse an das Ziel zu senden. EventBridge kann die IAM-Rolle erstellen, die für die Ausführung Ihrer Regel erforderlich ist. Führen Sie eine der folgenden Aktionen aus:
+ Um automatisch eine IAM-Rolle zu erstellen, wählen Sie **Eine neue Rolle für diese spezifische Ressource erstellen**.
+ Um eine IAM-Rolle zu verwenden, die Sie bereits erstellt haben, wählen Sie **Bestehende Rolle verwenden**.
1. (Optional) Erweitern Sie **Additional settings (Zusätzliche Einstellungen)**.
1. Wählen **Sie unter Zieleingabe konfigurieren** aus, wie der Text eines Ereignisses verarbeitet wird, bevor er an das Ziel übergeben wird.
1. Geben Sie **unter Maximales Alter des Ereignisses** das Zeitintervall an, in dem unverarbeitete Ereignisse aufbewahrt werden.
1. Geben **Sie unter Wiederholungsversuche** ein, wie oft ein Ereignis wiederholt werden soll.
1. Wählen Sie für **die Warteschlange „Unzustellbare Briefe**“ eine Option für die Behandlung unbearbeiteter Ereignisse aus. Geben Sie bei Bedarf die Amazon SQS SQS-Warteschlange an, die als Warteschlange für unzustellbare Briefe verwendet werden soll.
1. (Optional) Wählen Sie **Add another target** (Weiteres Ziel hinzufügen) aus, um ein weiteres Ziel für diese Regel hinzuzufügen.
1. Wählen Sie **Weiter** aus.
1. (Optional) Wählen Sie für **Tags** die Option **Neues Tag hinzufügen** aus, um eine Ressourcenbezeichnung für die Regel hinzuzufügen. Weitere Informationen finden Sie unter [ EventBridge Amazon-Tags](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html).
1. Wählen Sie **Weiter** aus.
1. **Überprüfen und erstellen finden Sie** in den Konfigurationsschritten. Wenn Sie Änderungen vornehmen müssen, wählen Sie **Edit** (Bearbeiten). Wenn Sie fertig sind, wählen Sie **Regel erstellen**.
Weitere Informationen zum Erstellen von Regeln finden Sie unter [Erstellen einer EventBridge Amazon-Regel, die nach einem Zeitplan ausgeführt wird](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) im * EventBridge Amazon-Benutzerhandbuch*.
# Tutorial: Eine Regel mit einem Ereignismuster erstellen
Das folgende Verfahren beschreibt, wie Sie eine Regel mit einem Ereignismuster erstellen.
**Um eine Regel zu erstellen, die das Ereignis an ein Ziel sendet, wenn das Ereignis einem definierten Muster entspricht**
**Anmerkung**
Dieses Verfahren funktioniert für alle Jobs AWS Batch auf Amazon ECS, Amazon EKS und AWS Fargate.
1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Wählen Sie in der Navigationsleiste die aus, die Sie verwenden AWS-Region möchten.
1. Wählen Sie im Navigationsbereich **Regeln** aus.
1. Wählen Sie **Regel erstellen** aus.
1. Geben Sie unter **Name** einen eindeutigen Namen für Ihre Rechenumgebung ein. Der Name kann bis zu 64 Zeichen umfassen. Er kann Groß- und Kleinbuchstaben, Zahlen, Bindestriche (-) und Unterstriche (\$1) enthalten.
**Anmerkung**
Eine Regel darf nicht denselben Namen wie eine andere Regel in derselben Region und auf demselben Event Bus haben.
1. (Optional) Geben Sie unter **Beschreibung** eine Beschreibung für die Regel ein.
1. Wählen Sie für **Event Bus** den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, wählen Sie **Standard** aus. Wenn ein AWS-Service in Ihrem Konto ein Ereignis ausgibt, wird es immer an den Standard-Event-Bus Ihres Kontos weitergeleitet.
1. (Optional) Schalten Sie die Regel für den ausgewählten Bus aus, wenn Sie die Regel nicht sofort ausführen möchten.
1. Bei **Regeltyp** wählen Sie **Regel mit einem Ereignismuster** aus.
1. Wählen Sie **Weiter** aus.
1. Wählen Sie als **Ereignisquelle AWS ** **Ereignis oder EventBridge Partnerereignisse** aus.
1. (Optional) Für ein **Beispielereignis**:
1. Wählen Sie für **Beispiel-Ereignistyp** die Option **AWS Ereignisse** aus.
1. Wählen Sie für **Beispielereignisse** die Option **Batch Job State Change** aus.
1. Wählen Sie für **Erstellungsmethode** die Option **Musterformular verwenden** aus.
1. Für **Event-Pattern**:
1. Wählen Sie für **Ereignisquelle** die Option **AWS-Services** aus.
1. Wählen Sie für **AWS-Service****Batch**.
1. Wählen Sie als **Ereignistyp** die Option **Batch Job State Change** aus.
1. Wählen Sie **Weiter** aus.
1. Für **Target types** (Zieltypen), wählen Sie **AWS-Service** aus.
1. **Wählen Sie unter Ziel** auswählen einen Zieltyp aus. Wählen Sie beispielsweise **Batch-Job-Warteschlange** aus. Geben Sie dann Folgendes an:
+ **Job queue** (Auftragswarteschlange): Geben Sie den Amazon-Ressourcennamen (ARN) der Auftragswarteschlange ein, in der Ihr Auftrag eingeplant werden soll.
+ **Auftragsdefinition:** Geben Sie den Namen und die Revision oder den vollständigen ARN der Auftragsdefinition ein, die für Ihren Auftrag verwendet werden sollen.
+ **Job name (Auftragsname):** Geben Sie einen Namen für Ihren Auftrag ein.
+ **Array-Größe:** (Optional) Geben Sie eine Array-Größe für Ihren Auftrag ein, um mehrere Kopien davon auszuführen. Weitere Informationen finden Sie unter [Ordnen Sie Jobs an](array_jobs.md).
+ **Auftragsversuche:** (Optional) Geben Sie an, wie oft die Ausführung Ihres Auftrags versucht werden soll, bevor festgelegt wird, dass er fehlgeschlagen ist. Weitere Informationen finden Sie unter [Automatisierte Auftragswiederholungen](job_retries.md).
1. Für Zieltypen von **Batch-Job-Warteschlangen** ist die Erlaubnis EventBridge erforderlich, Ereignisse an das Ziel zu senden. EventBridge kann die IAM-Rolle erstellen, die für die Ausführung Ihrer Regel erforderlich ist. Führen Sie eine der folgenden Aktionen aus:
+ Um automatisch eine IAM-Rolle zu erstellen, wählen Sie **Create a new role for this specific resource (Eine neue Rolle für diese spezifische Ressource erstellen)**.
+ Wenn Sie eine zuvor erstellte IAM-Rolle verwenden möchten, wählen Sie **Use existing role (Vorhandene Rolle verwenden)**.
1. (Optional) Erweitern Sie **Additional settings (Zusätzliche Einstellungen)**.
1. Wählen **Sie unter Zieleingabe konfigurieren** aus, wie Text aus einem Ereignis verarbeitet wird.
1. Geben Sie für **Maximales Alter des Ereignisses** das Zeitintervall an, in dem unverarbeitete Ereignisse aufbewahrt werden.
1. Geben **Sie unter Wiederholungsversuche** ein, wie oft ein Ereignis wiederholt werden soll.
1. Wählen Sie für **die Warteschlange „Unzustellbare Briefe**“ eine Option für die Behandlung unbearbeiteter Ereignisse aus. Geben Sie bei Bedarf die Amazon SQS SQS-Warteschlange an, die als Warteschlange für unzustellbare Briefe verwendet werden soll.
1. (Optional) Wählen Sie Weiteres Ziel **hinzufügen, um ein zusätzliches Ziel** hinzuzufügen.
1. Wählen Sie **Weiter** aus.
1. (Optional) Wählen Sie für **Tags** die Option **Neues Tag hinzufügen** aus, um ein Ressourcenlabel hinzuzufügen. Weitere Informationen finden Sie unter [ EventBridge Amazon-Tags](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) im * EventBridge Amazon-Benutzerhandbuch*.
1. Wählen Sie **Weiter** aus.
1. **Überprüfen und erstellen finden Sie** in den Konfigurationsschritten. Wenn Sie Änderungen vornehmen müssen, wählen Sie **Edit** (Bearbeiten). Wenn Sie fertig sind, wählen Sie **Regel erstellen** aus.
Weitere Informationen zum Erstellen von Regeln finden Sie im [* EventBridge Amazon-Benutzerhandbuch unter Erstellen von EventBridge Amazon-Regeln*, die auf Ereignisse reagieren](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html).
# Tutorial: Übergeben von Ereignisinformationen mithilfe des EventBridge Eingangstransformators an ein AWS Batch Ziel nach einem Zeitplan
Sie können den EventBridge Eingangstransformator verwenden, um Ereignisinformationen AWS Batch in einer Job-Einreichung weiterzuleiten. Dies kann besonders nützlich sein, wenn Sie Jobs aufgrund anderer AWS Ereignisinformationen aufrufen. Ein Beispiel ist ein Objekt-Upload in einen Amazon S3 S3-Bucket. Sie können auch eine Auftragsdefinition mit Parameterersatzwerten im Befehl des Containers verwenden. Der EventBridge Eingangstransformator kann die Parameterwerte auf der Grundlage der Ereignisdaten bereitstellen.
Anschließend erstellen Sie ein AWS Batch Ereignisziel, das Informationen aus dem Ereignis, das es auslöst, analysiert und in ein `parameters` Objekt umwandelt. Wenn der Job ausgeführt wird, werden die Parameter des Trigger-Ereignisses an den Befehl des Job-Containers übergeben.
**Anmerkung**
In diesem Szenario müssen sich alle AWS Ressourcen (wie Amazon S3 S3-Buckets, EventBridge Regeln und CloudTrail Protokolle) in derselben Region befinden.
**Um ein AWS Batch Ziel zu erstellen, das den Eingangstransformator verwendet**
1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Wählen Sie in der Navigationsleiste die aus, die Sie verwenden AWS-Region möchten.
1. Wählen Sie im Navigationsbereich **Regeln** aus.
1. Wählen Sie **Regel erstellen** aus.
1. Geben Sie unter **Name** einen eindeutigen Namen für Ihre Rechenumgebung ein. Der Name kann bis zu 64 Zeichen umfassen. Er kann Groß- und Kleinbuchstaben, Zahlen, Bindestriche (-) und Unterstriche (\$1) enthalten.
**Anmerkung**
Eine Regel kann nicht denselben Namen wie eine andere Regel im selben AWS-Region und im selben Event-Bus haben.
1. (Optional) Geben Sie im Feld **Beschreibung** eine Beschreibung für die Regel ein.
1. Wählen Sie für **Event Bus** den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, wählen Sie **Standard** aus. Wenn ein AWS-Service in Ihrem Konto ein Ereignis ausgibt, wird es immer an den Standard-Event-Bus Ihres Kontos weitergeleitet.
1. (Optional) Schalten Sie die Regel für den ausgewählten Bus aus, wenn Sie die Regel nicht sofort ausführen möchten.
1. Wählen Sie unter **Rule type** (Regeltyp) die Option **Schedule** (Zeitplan) aus.
1. Wählen Sie **Weiter, um die Regel zu erstellen**, oder **Weiter**.
1. Gehen Sie bei **Schedule pattern** (Zeitplanmuster) wie folgt vor:
+ Wählen Sie **Ein detaillierter Zeitplan, der zu einer bestimmten Zeit ausgeführt wird, z. B. um 8:00 Uhr aus. PST am ersten Montag eines jeden Monats** und geben Sie dann einen Cron-Ausdruck ein. Weitere Informationen finden Sie unter [Cron Expressions](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) im * EventBridge Amazon-Benutzerhandbuch*.
+ Wählen Sie **einen Zeitplan, der regelmäßig ausgeführt wird, z. B. alle 10 Minuten.** und geben Sie dann einen Preisausdruck ein.
1. Wählen Sie **Weiter** aus.
1. Für **Target types** (Zieltypen), wählen Sie **AWS-Service** aus.
1. **Wählen Sie für Wählen Sie ein Ziel** die Option **Batch-Job-Warteschlange** aus. Konfigurieren Sie dann Folgendes:
+ **Job queue** (Auftragswarteschlange): Geben Sie den Amazon-Ressourcennamen (ARN) der Auftragswarteschlange ein, in der Ihr Auftrag eingeplant werden soll.
+ **Auftragsdefinition:** Geben Sie den Namen und die Revision oder den vollständigen ARN der Auftragsdefinition ein, die für Ihren Auftrag verwendet werden sollen.
+ **Job name (Auftragsname):** Geben Sie einen Namen für Ihren Auftrag ein.
+ **Array-Größe:** (Optional) Geben Sie eine Array-Größe für Ihren Auftrag ein, um mehrere Kopien davon auszuführen. Weitere Informationen finden Sie unter [Ordnen Sie Jobs an](array_jobs.md).
+ **Auftragsversuche:** (Optional) Geben Sie an, wie oft die Ausführung Ihres Auftrags versucht werden soll, bevor festgelegt wird, dass er fehlgeschlagen ist. Weitere Informationen finden Sie unter [Automatisierte Auftragswiederholungen](job_retries.md).
1. Für Zieltypen von **Batch-Job-Warteschlangen** ist die Erlaubnis EventBridge erforderlich, Ereignisse an das Ziel zu senden. EventBridge kann die IAM-Rolle erstellen, die für die Ausführung Ihrer Regel erforderlich ist. Führen Sie eine der folgenden Aktionen aus:
+ Um automatisch eine IAM-Rolle zu erstellen, wählen Sie **Eine neue Rolle für diese spezifische Ressource erstellen** aus.
+ Um eine IAM-Rolle zu verwenden, die Sie bereits erstellt haben, wählen Sie **Bestehende Rolle verwenden**.
1. (Optional) Erweitern Sie **Additional settings (Zusätzliche Einstellungen)**.
1. Wählen Sie im Abschnitt **Additional settings** (Zusätzliche Einstellungen) unter **Configure target input** (Zieleingabe konfigurieren) die Option **Input Transformer** (Eingabetransformator).
1. Wählen Sie **Configure input transformer** (Eingabetransformator konfigurieren).
1. (Optional) Für ein **Beispielereignis**:
1. Wählen Sie für **Beispiel-Ereignistyp** die Option **AWS Ereignisse** aus.
1. Wählen Sie für **Beispielereignisse** die Option **Batch Job State Change** aus.
1. Geben Sie im Abschnitt **Target input transformer** (Zieleingabetransformator) für **Input path** (Eingabepfad) die Werte an, die aus dem auslösenden Ereignis analysiert werden sollen. Um beispielsweise das **Batch Job State Change-Ereignis** zu analysieren, verwenden Sie das folgende JSON-Format.
```
{
"instance": "$.detail.jobId",
"state": "$.detail.status"
}
```
1. Geben Sie für **Vorlage** Folgendes ein.
```
{
"instance": ,
"status":
}
```
1. Wählen Sie **Bestätigen** aus.
1. Geben Sie **unter Maximales Alter des Ereignisses** das Zeitintervall an, in dem unverarbeitete Ereignisse aufbewahrt werden.
1. Geben **Sie unter Wiederholungsversuche** ein, wie oft ein Ereignis wiederholt werden soll.
1. Wählen Sie für **die Warteschlange „Unzustellbare Briefe**“ eine Option für die Behandlung unbearbeiteter Ereignisse aus. Geben Sie bei Bedarf die Amazon SQS SQS-Warteschlange an, die als Warteschlange für unzustellbare Briefe verwendet werden soll.
1. (Optional) Wählen Sie Weiteres Ziel **hinzufügen, um ein zusätzliches Ziel** hinzuzufügen.
1. Wählen Sie **Weiter** aus.
1. (Optional) Wählen Sie für **Tags** die Option **Neues Tag hinzufügen** aus, um ein Ressourcenlabel hinzuzufügen. Weitere Informationen finden Sie unter [ EventBridge Amazon-Tags](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) im * EventBridge Amazon-Benutzerhandbuch*.
1. Wählen Sie **Weiter** aus.
1. **Überprüfen und erstellen finden Sie** in den Konfigurationsschritten. Wenn Sie Änderungen vornehmen müssen, wählen Sie **Edit** (Bearbeiten). Wenn Sie fertig sind, wählen Sie **Regel erstellen** aus.
# Tutorial: Halten Sie Ausschau nach AWS Batch Job-Events mit EventBridge
In diesem Tutorial richten Sie eine einfache AWS Lambda Funktion ein, die auf AWS Batch Job-Ereignisse wartet und diese in einen CloudWatch Log-Log-Stream schreibt.
## Voraussetzungen
Dieses Tutorial unterstellt eine funktionierende Datenverarbeitungsumgebung samt Auftragswarteschlange, die bereit ist, Aufträge aufzunehmen. Wenn Sie keine laufende Rechenumgebung und keine Job-Warteschlange haben, aus der Sie Ereignisse erfassen können, folgen Sie den Schritten unter, um eine [Erste Schritte mit AWS Batch Tutorials](Batch_GetStarted.md) zu erstellen. Am Ende dieses Tutorials können Sie optional einen Job an diese Job-Warteschlange senden, um zu testen, ob Sie Ihre Lambda-Funktion korrekt konfiguriert haben.
**Topics**
+ [Voraussetzungen](#cwet_prereqs)
+ [Tutorial: Lambda-Funktion erstellen](cwet_create_lam.md)
+ [Tutorial: Registrieren Sie die Ereignisregel](cwet_register_event_rule.md)
+ [Tutorial: Testen Sie Ihre Konfiguration](cwet_test.md)
# Tutorial: Lambda-Funktion erstellen
In diesem Verfahren erstellen Sie eine einfache Lambda-Funktion, die als Ziel für AWS Batch Event-Stream-Nachrichten dient.
**So erstellen Sie eine Lambda-Zielfunktion**
1. Öffnen Sie die AWS Lambda Konsole unter. [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/)
1. Wählen Sie **Funktion erstellen** und **Von Grund auf neu erstellen** aus.
1. Geben Sie für **Function name** (Funktionsname) **batch-event-stream-handler** ein.
1. Wählen Sie für **Runtime (Laufzeit)** die Option **Python 3.8** aus.
1. Wählen Sie **Funktion erstellen**.
1. Bearbeiten Sie im Abschnitt **Codequelle** den Beispielcode so, dass er dem folgenden Beispiel entspricht:
```
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))
```
Dies ist eine einfache Python 3.8-Funktion, die die von gesendeten Ereignisse ausgibt AWS Batch. Wenn alles korrekt konfiguriert ist, werden die Ereignisdetails am Ende dieses Tutorials im CloudWatch Log-Protokollstream angezeigt, der dieser Lambda-Funktion zugeordnet ist.
1. Wählen Sie **Bereitstellen**.
# Tutorial: Registrieren Sie die Ereignisregel
In diesem Abschnitt erstellen Sie eine EventBridge Ereignisregel, die Auftragsereignisse erfasst, die aus Ihren AWS Batch Ressourcen stammen. Diese Regel erfasst alle Ereignisse, die aus dem AWS Batch Konto stammen, in dem sie definiert ist. Die Jobnachrichten selbst enthalten Informationen über die Ereignisquelle, einschließlich der Job-Warteschlange, in der sie eingereicht wurden. Sie können diese Informationen verwenden, um Ereignisse programmgesteuert zu filtern und zu sortieren.
**Anmerkung**
Wenn Sie die verwenden, AWS-Managementkonsole um eine Ereignisregel zu erstellen, fügt die Konsole automatisch die IAM-Berechtigungen hinzu, EventBridge um Ihre Lambda-Funktion aufzurufen. Wenn Sie jedoch eine Ereignisregel mithilfe von erstellen AWS CLI, müssen Sie Berechtigungen explizit gewähren. Weitere Informationen finden Sie unter [Ereignisse und Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) im * EventBridge Amazon-Benutzerhandbuch*.
**Um Ihre EventBridge Regel zu erstellen**
1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Wählen Sie im Navigationsbereich **Regeln** aus.
1. Wählen Sie **Regel erstellen** aus.
1. Geben Sie einen Namen und eine Beschreibung für die Regel ein.
Eine Regel darf nicht denselben Namen wie eine andere Regel in derselben Region und auf demselben Event Bus haben.
1. Wählen Sie als **Event bus** (Event Bus) den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, wählen Sie **AWS -Standard-Event-Bus** aus. Wenn ein AWS Service in Ihrem Konto ein Ereignis ausgibt, wird dieses immer an den Standard-Event-Bus Ihres Kontos weitergeleitet.
1. Bei **Regeltyp** wählen Sie **Regel mit einem Ereignismuster** aus.
1. Wählen Sie **Weiter** aus.
1. Wählen Sie für **Event source** (Ereignisquelle) **Other** (Andere) aus.
1. Wählen Sie für **Ereignismuster** die Option **Benutzerdefinierte Muster (JSON-Editor)** aus.
1. Fügen Sie das folgende Ereignismuster in das Textfeld ein.
```
{
"source": [
"aws.batch"
]
}
```
Diese Regel gilt für alle Ihre AWS Batch Gruppen und für jedes AWS Batch Ereignis. Alternativ können Sie eine spezifischere Regel erstellen, damit bestimmte Ergebnisse gefiltert werden.
1. Wählen Sie **Weiter** aus.
1. Bei **Zieltypen** wählen Sie **AWS -Service** aus.
1. **Wählen Sie für Select a target** die Option **Lambda-Funktion** und wählen Sie Ihre Lambda-Funktion aus.
1. (Optional) Gehen Sie unter **Additional settings** (Weitere Einstellungen) wie folgt vor:
1. Geben Sie für **Maximum age of event** (Maximales Alter des Ereignisses) einen Wert zwischen einer Minute (00:01) und 24 Stunden (24:00) ein.
1. Geben Sie für **Wiederholungsversuche** eine Zahl zwischen 0 und 185 ein.
1. Wählen Sie für **Warteschlange für unzustellbare Briefe** aus, ob Sie eine standardmäßige Amazon SQS SQS-Warteschlange als Warteschlange für unzustellbare Briefe verwenden möchten. EventBridge sendet Ereignisse, die dieser Regel entsprechen, an die Warteschlange für unzustellbare Briefe, wenn sie nicht erfolgreich an das Ziel zugestellt wurden. Führen Sie eine der folgenden Aktionen aus:
+ Klicken Sie auf **Keine**, um keine Warteschlange für unzustellbare Nachrichten zu verwenden.
+ Wählen **Sie Wählen Sie eine Amazon SQS SQS-Warteschlange im aktuellen AWS Konto aus, die als Warteschlange für eingehende Briefe verwendet werden soll, und wählen Sie dann die zu verwendende Warteschlange aus der Drop-down-Liste** aus.
+ Wählen **Sie Wählen Sie eine Amazon SQS SQS-Warteschlange in einem anderen AWS Konto als Warteschlange für unzustellbare Briefe aus und geben Sie dann den ARN der Warteschlange** ein, die Sie verwenden möchten. Sie müssen der Warteschlange eine ressourcenbasierte Richtlinie hinzufügen, die das Senden von Nachrichten an die EventBridge Warteschlange ermöglicht. Weitere Informationen finden Sie im * EventBridge Amazon-Benutzerhandbuch* unter [Erteilen von Berechtigungen für die Warteschlange mit unzustellbaren Briefen](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms).
1. Wählen Sie **Weiter** aus.
1. (Optional) Geben Sie ein oder mehrere Tags für die Regel ein. Weitere Informationen finden Sie unter [ EventBridge Amazon-Tags](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) im * EventBridge Amazon-Benutzerhandbuch*.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie die Details der Regel und wählen Sie dann **Regel erstellen** aus.
# Tutorial: Testen Sie Ihre Konfiguration
Sie können Ihre EventBridge Konfiguration jetzt testen, indem Sie einen Job an Ihre Job-Warteschlange senden. Wenn alles richtig konfiguriert ist, wird Ihre Lambda-Funktion ausgelöst und sie schreibt die Ereignisdaten in einen CloudWatch Log-Log-Stream für die Funktion.
**So testen Sie die Konfiguration**
1. Öffnen Sie die AWS Batch Konsole unter. [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/)
1. Reichen Sie einen neuen AWS Batch Job ein. Weitere Informationen finden Sie unter [Tutorial: Einen Job einreichen](submit_job.md).
1. Öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie im Navigationsbereich **Logs** und wählen Sie die Protokollgruppe für Ihre Lambda-Funktion aus (z. B. ***my-function*/aws/lambda/**).
1. Wählen Sie einen Protokollstream aus, um die Ereignisdaten anzuzeigen.
# Tutorial: Senden von Amazon Simple Notification Service-Benachrichtigungen für fehlgeschlagene Auftragsereignisse
In diesem Tutorial konfigurieren Sie eine EventBridge Amazon-Ereignisregel, die nur Auftragsereignisse erfasst, bei denen der Job in einen `FAILED` Status übergegangen ist. Am Ende dieses Tutorials können Sie optional auch einen Job an diese Job-Warteschlange senden. Dies dient dazu, zu testen, ob Sie Ihre Amazon SNS SNS-Benachrichtigungen korrekt konfiguriert haben.
## Voraussetzungen
Dieses Tutorial unterstellt eine funktionierende Datenverarbeitungsumgebung samt Auftragswarteschlange, die bereit ist, Aufträge aufzunehmen. Wenn Sie keine laufende Rechenumgebung und keine Job-Warteschlange haben, aus der Sie Ereignisse erfassen können, folgen Sie den Schritten unter, um eine [Erste Schritte mit AWS Batch Tutorials](Batch_GetStarted.md) zu erstellen.
**Topics**
+ [Voraussetzungen](#batch_sns_prereq)
+ [Tutorial: Ein Amazon SNS SNS-Thema erstellen und abonnieren](batch_sns_create_topic.md)
+ [Tutorial: Registrieren Sie eine Ereignisregel](batch_sns_reg_rule.md)
+ [Tutorial: Testen Sie Ihre Regel](batch_sns_test_rule.md)
+ [Alternative Regel: Batch-Job-Warteschlange blockiert](#test_blocked_job_queue)
# Tutorial: Ein Amazon SNS SNS-Thema erstellen und abonnieren
Mit diesem Tutorial konfigurieren Sie ein Amazon SNS-Thema, das als Ereignisziel für Ihre neue Ereignisregel dient.
**Erstellen eines Amazon SNS-Themas**
1. Öffnen Sie die Amazon SNS SNS-Konsole unter [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).
1. Wählen Sie **Themen**, **Thema erstellen** aus.
1. Wählen Sie unter **Type (Typ)** die Option **Standard** aus.
1. **Geben Sie als **Namen Thema** ein **JobFailedAlert** und wählen Sie Create topic aus.**
1. Wählen Sie auf dem **JobFailedAlert**Bildschirm die Option **Abonnement erstellen** aus.
1. Wählen Sie unter **Protocol (Protokoll)** die Option **Email (E-Mail)** aus.
1. Geben Sie für **Endpunkt** eine E-Mail-Adresse ein, auf die Sie aktuell Zugriff haben, und wählen Sie **Abonnement erstellen** aus.
1. Überprüfen Sie Ihr E-Mail-Konto und warten Sie auf eine E-Mail-Nachricht zur Bestätigung Ihres Abonnements. Wenn Sie sie erhalten, wählen Sie **Confirm Abonnement** aus.
# Tutorial: Registrieren Sie eine Ereignisregel
Registrieren Sie nun eine Ereignisregel, mit der nur Ereignisse zu fehlgeschlagenen Aufträgen erfasst werden.
**Um deine EventBridge Regel zu registrieren**
1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Wählen Sie im Navigationsbereich **Regeln** aus.
1. Wählen Sie **Regel erstellen** aus.
1. Geben Sie einen Namen und eine Beschreibung für die Regel ein.
Eine Regel darf nicht denselben Namen wie eine andere Regel in derselben Region und auf demselben Event Bus haben.
1. Wählen Sie als **Event bus** (Event Bus) den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, wählen Sie **AWS -Standard-Event-Bus** aus. Wenn ein AWS Service in Ihrem Konto ein Ereignis ausgibt, wird dieses immer an den Standard-Event-Bus Ihres Kontos weitergeleitet.
1. Bei **Regeltyp** wählen Sie **Regel mit einem Ereignismuster** aus.
1. Wählen Sie **Weiter** aus.
1. Wählen Sie für **Event source** (Ereignisquelle) **Other** (Andere) aus.
1. Wählen Sie für **Ereignismuster** die Option **Benutzerdefinierte Muster (JSON-Editor)** aus.
1. Fügen Sie das folgende Ereignismuster in das Textfeld ein.
```
{
"detail-type": [
"Batch Job State Change"
],
"source": [
"aws.batch"
],
"detail": {
"status": [
"FAILED"
]
}
}
```
Dieser Code definiert eine EventBridge Regel, die für jedes Ereignis gilt, bei dem sich der Jobstatus befindet`FAILED`. Weitere Informationen zu Ereignismustern finden Sie unter [Ereignisse und Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) im * EventBridge Amazon-Benutzerhandbuch*.
1. Wählen Sie **Weiter** aus.
1. Bei **Zieltypen** wählen Sie **AWS -Service** aus.
1. **Wählen Sie unter Ziel** auswählen die Option **SNS-Thema** und für **Thema** die Option **JobFailedAlert**.
1. (Optional) Gehen Sie unter **Additional settings** (Weitere Einstellungen) wie folgt vor:
1. Geben Sie für **Maximum age of event** (Maximales Alter des Ereignisses) einen Wert zwischen einer Minute (00:01) und 24 Stunden (24:00) ein.
1. Geben Sie für **Wiederholungsversuche** eine Zahl zwischen 0 und 185 ein.
1. Wählen Sie für **Warteschlange für unzustellbare Briefe** aus, ob Sie eine standardmäßige Amazon SQS SQS-Warteschlange als Warteschlange für unzustellbare Briefe verwenden möchten. EventBridge sendet Ereignisse, die dieser Regel entsprechen, an die Warteschlange für unzustellbare Briefe, wenn sie nicht erfolgreich an das Ziel zugestellt wurden. Führen Sie eine der folgenden Aktionen aus:
+ Klicken Sie auf **Keine**, um keine Warteschlange für unzustellbare Nachrichten zu verwenden.
+ Wählen **Sie Wählen Sie eine Amazon SQS SQS-Warteschlange im aktuellen AWS Konto aus, die als Warteschlange für eingehende Briefe verwendet werden soll, und wählen Sie dann die zu verwendende Warteschlange aus der Drop-down-Liste** aus.
+ Wählen **Sie Wählen Sie eine Amazon SQS SQS-Warteschlange in einem anderen AWS Konto als Warteschlange für unzustellbare Briefe aus und geben Sie dann den ARN der Warteschlange** ein, die Sie verwenden möchten. Sie müssen der Warteschlange eine ressourcenbasierte Richtlinie beifügen, die das Senden von Nachrichten an die EventBridge Warteschlange ermöglicht. Weitere Informationen finden Sie im * EventBridge Amazon-Benutzerhandbuch* unter [Erteilen von Berechtigungen für die Warteschlange mit unzustellbaren Briefen](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms).
1. Wählen Sie **Weiter** aus.
1. (Optional) Geben Sie ein oder mehrere Tags für die Regel ein. Weitere Informationen finden Sie unter [ EventBridge Amazon-Tags](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) im * EventBridge Amazon-Benutzerhandbuch*.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie die Details der Regel und wählen Sie dann **Regel erstellen** aus.
# Tutorial: Testen Sie Ihre Regel
Übermitteln Sie zum Testen der Regel einen Auftrag, der kurz nach dem Start mit einem Beendigungscode ungleich Null beendet wird. Wenn Ihre Ereignisregel korrekt konfiguriert ist, sollten Sie innerhalb weniger Minuten eine E-Mail-Nachricht mit dem Ereignistext erhalten.
**So testen Sie eine Regel**
1. Öffnen Sie die AWS Batch Konsole unter [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Reichen Sie einen neuen AWS Batch Job ein. Weitere Informationen finden Sie unter [Tutorial: Einen Job einreichen](submit_job.md). Ersetzen Sie den Befehl des Auftrags durch diesen Befehl, damit der Container mit einem Beendigungscode von 1 beendet wird.
```
/bin/sh, -c, 'exit 1'
```
1. Überprüfen Sie Ihre E-Mails, um zu bestätigen, dass Sie eine E-Mail-Benachrichtigung für die Benachrichtigung über den fehlgeschlagenen Job erhalten haben.
## Alternative Regel: Batch-Job-Warteschlange blockiert
Um eine Ereignisregel zu erstellen, die überwacht, ob die *Batch-Job-Warteschlange blockiert* ist, wiederholen Sie diese Tutorials mit den folgenden Änderungen:
1. **In [Tutorial: Ein Amazon SNS SNS-Thema erstellen und abonnieren](batch_sns_create_topic.md)**, *BlockedJobQueue* als Themennamen verwenden.
1. Verwenden Sie **in [Tutorial: Registrieren Sie eine Ereignisregel](batch_sns_reg_rule.md)** das folgende Muster im JSON-Editor:
```
{
"detail-type": [
"Batch Job Queue Blocked"
],
"source": [
"aws.batch"
]
}
```