AWS Batch Events

AWS Batch sendet Ereignisse zur Änderung des Auftragsstatus an EventBridge. AWS Batch verfolgt den Status Ihrer Aufträge. Wenn sich der Status eines zuvor übermittelten Auftrags ändert, wird ein Ereignis aufgerufen. Zum Beispiel, wenn ein Auftrag mit dem RUNNING Status in den FAILED Status wechselt. Diese Ereignisse sind als Auftragsstatus-Änderungsereignisse klassifiziert.

Anmerkung

AWS Batch kann in Zukunft weitere Ereignistypen, Quellen und Details hinzufügen. Wenn Sie Ereignis-JSON-Daten programmgesteuert deserialisieren, stellen Sie sicher, dass Ihre Anwendung bereit ist, unbekannte Eigenschaften zu verarbeiten. Dies soll Probleme vermeiden, wenn und wenn diese zusätzlichen Eigenschaften hinzugefügt werden.

Auftragsstatus-Änderungsereignisse

Jedes Mal, wenn ein vorhandener (zuvor übermittelter) Auftrag den Status ändert, wird ein Ereignis erstellt. Weitere Informationen zu AWS Batch Auftragsstatus finden Sie unter Auftragsstatus.

Anmerkung

Ereignisse werden für die erste Auftragsübermittlung nicht erstellt.

Beispiel Auftragsstatus-Änderungsereignis

Ereignisse zur Änderung des Auftragsstatus werden im folgenden Format bereitgestellt. Der detail Abschnitt ähnelt dem JobDetail Objekt, das von einer DescribeJobs API-Operation in der AWS Batch API-Referenz zurückgegeben wird. Weitere Informationen zu EventBridge Parametern finden Sie unter Ereignisse und Ereignismuster im Amazon- EventBridge 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": []
        },
        "tags": {
            "resourceArn": "arn:aws:batch:us-east-1:123456789012:job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8"
        },
        "propagateTags": false,
        "platformCapabilities": []
    }
}

Ereignisse in der Auftragswarteschlange blockiert

Jedes Mal, wenn einen Auftrag im RUNNABLE Status AWS Batch erkennt und somit eine Warteschlange blockiert, wird ein Ereignis in Amazon CloudWatch Events erstellt. Weitere Informationen zu unterstützten Ursachen für blockierte Warteschlangen finden Sie unter Beispielmeldungen für blockierte Auftragswarteschlangen . Derselbe Grund ist auch im statusReason Feld in der DescribeJobs API-Aktion verfügbar.

Beispiel Auftragsstatus-Änderungsereignis

Ereignisse zur Änderung des Auftragsstatus werden im folgenden Format bereitgestellt. Der detail Abschnitt ähnelt dem JobDetail Objekt, das von einer DescribeJobs API-Operation in der AWS Batch API-Referenz zurückgegeben wird. Weitere Informationen zu EventBridge Parametern finden Sie unter Ereignisse und Ereignismuster im Amazon- EventBridge 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": []
        },
        "tags": {
            "resourceArn": "arn:aws:batch:us-east-1:123456789012:job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8"
        },
        "propagateTags": false,
        "platformCapabilities": []
    }
}