

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# AWS Batch aliran acara untuk Amazon EventBridge
<a name="cloudwatch_event_stream"></a>

Anda dapat menggunakan streaming AWS Batch acara untuk Amazon EventBridge untuk menerima pemberitahuan mendekati waktu nyata mengenai status pekerjaan saat ini dalam antrian pekerjaan Anda.

Anda dapat menggunakan EventBridge untuk mendapatkan wawasan lebih lanjut tentang AWS Batch layanan Anda. Lebih khusus lagi, Anda dapat menggunakannya untuk memeriksa kemajuan pekerjaan, membuat alur kerja AWS Batch khusus, membuat laporan atau metrik penggunaan, atau membuat dasbor Anda sendiri. Dengan AWS Batch dan EventBridge, Anda tidak perlu penjadwalan dan kode pemantauan yang terus-menerus melakukan polling AWS Batch untuk perubahan status pekerjaan. Sebagai gantinya, Anda dapat menangani perubahan status AWS Batch pekerjaan secara asinkron menggunakan berbagai target Amazon. EventBridge Ini termasuk AWS Lambda, Layanan Antrian Sederhana Amazon, Layanan Pemberitahuan Sederhana Amazon, atau Amazon Kinesis Data Streams.

Acara dari aliran AWS Batch acara dipastikan akan dikirimkan setidaknya satu kali. Jika duplikat peristiwa dikirim, peristiwa menyediakan informasi yang cukup untuk mengidentifikasi duplikat. Dengan begitu, Anda dapat membandingkan stempel waktu peristiwa dan status tugas.

AWS Batch Pekerjaan tersedia sebagai EventBridge target. Dengan menggunakan aturan sederhana, Anda dapat mencocokkan acara dan mengirimkan AWS Batch pekerjaan sebagai tanggapan terhadapnya. Untuk informasi lebih lanjut, lihat [Apa itu EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) di *Panduan EventBridge Pengguna Amazon*. Anda juga dapat menggunakan EventBridge untuk menjadwalkan tindakan otomatis yang memicu sendiri pada waktu-waktu tertentu menggunakan **cron** atau menilai ekspresi. Untuk informasi selengkapnya, lihat [Membuat EventBridge aturan Amazon yang berjalan sesuai jadwal](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) di *Panduan EventBridge Pengguna Amazon*. Untuk panduan contoh, lihat [AWS Batch pekerjaan sebagai EventBridge target](batch-cwe-target.md). Untuk informasi tentang menggunakan EventBridge Penjadwal, lihat [Menyiapkan EventBridge Penjadwal Amazon](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html) di EventBridge Panduan Pengguna Amazon. 

**Topics**
+ [

# AWS Batch acara
](batch_cwe_events.md)
+ [

# Tutorial: Gunakan notifikasi AWS pengguna dengan AWS Batch
](using-user-notifications.md)
+ [

# AWS Batch pekerjaan sebagai EventBridge target
](batch-cwe-target.md)
+ [

# Tutorial: Dengarkan acara AWS Batch kerja menggunakan EventBridge
](batch_cwet.md)
+ [

# Tutorial: Mengirim peringatan Layanan Pemberitahuan Sederhana Amazon untuk acara pekerjaan yang gagal
](batch_sns_tutorial.md)

# AWS Batch acara
<a name="batch_cwe_events"></a>

AWS Batch mengirimkan acara perubahan status pekerjaan ke EventBridge. AWS Batch melacak keadaan pekerjaan Anda. Jika status tugas yang dikirim sebelumnya berubah, peristiwa akan dipanggil. Misalnya, jika tugas di status `RUNNING` berpindah ke status `FAILED`. Peristiwa ini diklasifikasikan sebagai peristiwa perubahan status tugas.

**catatan**  
AWS Batch mungkin menambahkan jenis acara, sumber, dan detail lainnya di masa mendatang. Jika Anda secara terprogram deserialisasi data peristiwa JSON, pastikan aplikasi Anda siap untuk menangani properti yang tidak dikenal. Ini untuk menghindari masalah jika dan ketika properti tambahan ini ditambahkan.

# Peristiwa perubahan status pekerjaan
<a name="batch_job_events"></a>

Kapan saja pekerjaan yang ada (yang dikirimkan sebelumnya) berubah menyatakan, sebuah acara dibuat. Untuk informasi lebih lanjut tentang status AWS Batch pekerjaan, lihat[Status Job](job_states.md).

**catatan**  
Peristiwa tidak dibuat untuk pengiriman tugas awal.

**Example Peristiwa Perubahan Status Tugas**  
Peristiwa perubahan status pekerjaan disampaikan dalam format berikut. `detail`Bagian ini menyerupai [JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html)objek yang dikembalikan dari operasi [DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API di *Referensi AWS Batch API*. Untuk informasi selengkapnya tentang EventBridge parameter, lihat [Peristiwa dan Pola Peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) di *Panduan EventBridge Pengguna Amazon*.  

```
{
    "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": []
    }
}
```

# Acara yang diblokir antrean pekerjaan
<a name="batch-job-queue-blocked-events"></a>

Kapan saja yang AWS Batch mendeteksi pekerjaan di `RUNNABLE` negara bagian dan dengan demikian memblokir antrian, sebuah peristiwa dibuat di Amazon CloudWatch Events. Untuk informasi selengkapnya tentang penyebab antrian diblokir yang didukung, lihat[Pekerjaan terjebak dalam `RUNNABLE` status](job_stuck_in_runnable.md). Alasan yang sama juga tersedia di `statusReason` bidang dalam tindakan [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API.

**Example Antrian pekerjaan diblokir acara**  
Acara yang diblokir antrean pekerjaan dikirimkan dalam format berikut. `detail`Bagian ini menyerupai [JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html)objek yang dikembalikan dari operasi [DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API di *Referensi AWS Batch API*. Untuk informasi selengkapnya tentang EventBridge parameter, lihat [Peristiwa dan Pola Peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) di *Panduan EventBridge Pengguna Amazon*.  

```
{
    "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": []
    }
}
```

# Acara perubahan status pekerjaan layanan
<a name="service-job-events"></a>

Kapan saja pekerjaan layanan yang ada berubah status, sebuah acara dibuat. Untuk informasi selengkapnya tentang status pekerjaan layanan, lihat[Memetakan status pekerjaan AWS Batch layanan ke status SageMaker AI](service-job-status.md).

**catatan**  
Peristiwa tidak dibuat untuk pengiriman tugas awal.

**Example Acara Perubahan Status Pekerjaan Layanan**  
Acara perubahan status pekerjaan layanan disampaikan dalam format berikut. `detail`Bagian ini menyerupai respons yang dikembalikan dari operasi [DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API di *Referensi AWS Batch API*. Untuk informasi selengkapnya tentang EventBridge parameter, lihat [Peristiwa dan Pola Peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) di *Panduan EventBridge Pengguna Amazon*.  
`serviceRequestPayload`Bidang `tags` dan tidak termasuk dalam acara tersebut`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
    }
  }
}
```

# Acara yang diblokir antrian pekerjaan layanan
<a name="batch-service-job-queue-blocked-events"></a>

Kapan saja yang AWS Batch mendeteksi antrian yang diblokir, acara dibuat di Amazon CloudWatch Events. Alasan antrian yang diblokir tersedia di `statusReason` bidang dalam tindakan [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API.

**Example Service Job Queue Diblokir Event**  
Acara yang diblokir antrean pekerjaan layanan dikirimkan dalam format berikut. `detail`Bagian ini menyerupai respons yang dikembalikan dari operasi [DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API di *Referensi AWS Batch API*. Untuk informasi selengkapnya tentang EventBridge parameter, lihat [Peristiwa dan Pola Peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) di *Panduan EventBridge Pengguna Amazon*.  
`serviceRequestPayload`Bidang `tags` dan tidak termasuk dalam acara tersebut`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
    }
  }
}
```

# Acara preemption pekerjaan layanan
<a name="batch-service-job-preemption-events"></a>

Peristiwa preemption diterbitkan setiap kali urutan preemption dimulai atau selesai. Peristiwa yang dimulai dibuat ketika preemption pertama kali dipicu untuk merebut kembali kapasitas pinjaman. Peristiwa yang telah selesai dibuat ketika urutan preemption selesai dan menyertakan ringkasan dari upaya yang telah dipreempt.

**Example Service Job Preemption Memulai Acara**  
Acara awal awal pekerjaan layanan disampaikan dalam format berikut. Untuk informasi selengkapnya tentang EventBridge parameter, lihat [Peristiwa dan Pola Peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) di *Panduan EventBridge Pengguna Amazon*.  

```
{
  "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 Service Job Preemption Selesai Acara**  
Acara yang diselesaikan sebelum pekerjaan layanan disampaikan dalam format berikut. `preemptionSummary`Bidang ini berisi rincian tentang upaya yang dipreempted, termasuk hitungan dan informasi upaya pendahuluan terbaru.  

```
{
  "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: Gunakan notifikasi AWS pengguna dengan AWS Batch
<a name="using-user-notifications"></a>

Anda dapat menggunakan [Pemberitahuan AWS Pengguna](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html) untuk mengatur saluran pengiriman agar mendapat pemberitahuan tentang AWS Batch peristiwa. Anda akan menerima notifikasi saat ada sebuah peristiwa yang cocok dengan sebuah aturan yang Anda tentukan. Anda dapat menerima pemberitahuan untuk acara melalui beberapa saluran, termasuk email, [Pengembang Amazon Q dalam pemberitahuan obrolan aplikasi](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html) obrolan, atau pemberitahuan [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)push. Anda juga dapat melihat notifikasi di [Pusat Notifikasi Konsol](https://console.aws.amazon.com/notifications/). Notifikasi Pengguna mendukung agregasi, hal ini akan dapat mengurangi jumlah notifikasi yang Anda terima selama peristiwa-peristiwa tertentu.

Untuk mengkonfigurasi Pemberitahuan Pengguna di AWS Batch:

1. Buka [konsol AWS Batch](https://console.aws.amazon.com/batch/home).

1. Pilih **Dasbor**.

1. Pilih **Konfigurasi Pemberitahuan**. 

1. Di **Pemberitahuan AWS Pengguna**, pilih **Buat konfigurasi notifikasi**.

Untuk informasi selengkapnya tentang cara mengonfigurasi dan melihat notifikasi pengguna, lihat [Memulai Pemberitahuan AWS Pengguna](https://docs.aws.amazon.com/notifications/latest/userguide/getting-started.html). 

# AWS Batch pekerjaan sebagai EventBridge target
<a name="batch-cwe-target"></a>

Amazon EventBridge memberikan aliran peristiwa sistem yang mendekati real-time yang menjelaskan perubahan dalam sumber daya Amazon Web Services. Biasanya, AWS Batch di Amazon Elastic Container Service, Amazon Elastic Kubernetes Service, AWS dan pekerjaan Fargate tersedia sebagai target. EventBridge Dengan menggunakan aturan sederhana, Anda dapat mencocokkan acara dan mengirimkan AWS Batch pekerjaan sebagai tanggapan terhadapnya. Untuk informasi lebih lanjut, lihat [Apa itu EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) di *Panduan EventBridge Pengguna Amazon*.

Anda juga dapat menggunakan EventBridge untuk menjadwalkan tindakan otomatis yang dipanggil pada waktu-waktu tertentu menggunakan **cron** atau menilai ekspresi. Untuk informasi selengkapnya, lihat [Membuat EventBridge aturan Amazon yang berjalan sesuai jadwal](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) di *Panduan EventBridge Pengguna Amazon*. 

Untuk informasi tentang cara membuat aturan yang berjalan saat peristiwa cocok dengan pola peristiwa, lihat [Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) di *Panduan EventBridge Pengguna Amazon*.

Kasus penggunaan umum untuk AWS Batch pekerjaan sebagai EventBridge target meliputi kasus penggunaan berikut:
+ Pekerjaan terjadwal terjadi pada interval waktu yang teratur. Misalnya, **cron** pekerjaan hanya terjadi selama jam penggunaan rendah ketika Instans EC2 Spot Amazon lebih murah.
+  AWS Batch Pekerjaan berjalan sebagai respons terhadap operasi API yang masuk CloudTrail. Misalnya, pekerjaan dikirimkan setiap kali objek diunggah ke bucket Amazon S3 yang ditentukan. Setiap kali ini terjadi, transformator EventBridge input melewati ember dan nama kunci objek ke AWS Batch parameter.
**catatan**  
Dalam skenario ini, semua sumber AWS daya terkait harus berada di Wilayah yang sama. Ini termasuk sumber daya seperti bucket Amazon S3, EventBridge aturan, dan CloudTrail log.

Sebelum Anda dapat mengirimkan AWS Batch pekerjaan dengan EventBridge aturan dan target, EventBridge layanan memerlukan beberapa izin untuk menjalankan AWS Batch pekerjaan. Saat membuat aturan di EventBridge konsol yang menentukan AWS Batch pekerjaan sebagai target, Anda juga dapat membuat peran ini. Untuk informasi lebih lanjut tentang pelaku utama layanan dan izin IAM yang diperlukan untuk peran ini, lihat [EventBridge Peran IAM](CWE_IAM_role.md).

**Topics**
+ [

# Tutorial: Buat AWS Batch pekerjaan terjadwal
](scheduled-batch-job.md)
+ [

# Tutorial: Buat aturan dengan pola acara
](event-pattern-batch-job.md)
+ [

# Tutorial: Berikan informasi acara ke AWS Batch target sesuai jadwal menggunakan transformator EventBridge input
](cwe-input-transformer.md)

# Tutorial: Buat AWS Batch pekerjaan terjadwal
<a name="scheduled-batch-job"></a>

Prosedur berikut mencakup cara membuat AWS Batch pekerjaan terjadwal dan peran EventBridge IAM yang diperlukan.

**Untuk membuat AWS Batch pekerjaan terjadwal dengan EventBridge**
**catatan**  
Prosedur ini berfungsi untuk semua AWS Batch di Amazon ECS, Amazon EKS, dan pekerjaan AWS Fargate.

1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Dari bilah navigasi, pilih yang Wilayah AWS akan digunakan.

1. Di panel navigasi, pilih **Aturan**.

1. Pilih **Buat aturan**.

1. Untuk **Nama**, tentukan nama unik untuk lingkungan komputasi Anda. Nama dapat berisi hingga 64 karakter. Nama dapat memuat huruf besar dan huruf kecil, angka, tanda hubung (-), dan garis bawah (\$1).
**catatan**  
Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus peristiwa yang sama.

1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi untuk aturan.

1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan peristiwa yang berasal dari akun Anda, pilih **default**. Ketika Layanan AWS di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.

1. (Opsional) Matikan aturan pada bus yang dipilih jika Anda tidak ingin segera menjalankan aturan.

1. Untuk **jenis Aturan**, pilih **Jadwal**.

1. Pilih **Lanjutkan untuk membuat aturan** atau **Berikutnya**.

1. Untuk **pola Jadwal**, lakukan salah satu hal berikut:
   + Pilih **Jadwal berbutir halus yang berjalan pada waktu tertentu, seperti pukul 8:00 pagi PST pada hari Senin pertama setiap bulan** dan kemudian masukkan ekspresi cron. Untuk informasi selengkapnya, lihat [Ekspresi Cron di](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) *Panduan EventBridge Pengguna Amazon*.
   + Pilih **jadwal yang berjalan dengan tarif reguler, seperti setiap 10 menit.** dan kemudian masukkan ekspresi tingkat.

1. Pilih **Berikutnya**.

1. Untuk **Tipe target**, pilih **Layanan AWS**.

1. Untuk **Pilih target**, pilih **Antrian pekerjaan Batch**. Kemudian, konfigurasikan yang berikut ini:
   + **Job queue** (Antrean tugas): Masukkan Amazon Resource Name (ARN) dari antrean tugas untuk menjadwalkan tugas Anda.
   + **Job definition** (Ketentuan Tugas): Masukkan nama dan revisi atau ARN lengkap ketentuan tugas yang akan digunakan untuk tugas Anda.
   + **Job name** (Nama tugas): Masukkan nama untuk tugas Anda.
   + **Array size** (Ukuran array): (Opsional) Masukkan ukuran array untuk tugas Anda guna menjalankan lebih dari satu salinan. Untuk informasi selengkapnya, lihat [Tugas array](array_jobs.md).
   + **Job attempts** (Upaya tugas): (Opsional) Masukkan jumlah untuk mencoba kembali tugas Anda jika gagal. Untuk informasi selengkapnya, lihat [Percobaan kembali tugas secara otomatis](job_retries.md).

1. Untuk jenis target **antrian pekerjaan Batch**, EventBridge memerlukan izin untuk mengirim peristiwa ke target. EventBridge dapat membuat peran IAM yang diperlukan agar aturan Anda berjalan. Lakukan salah satu dari langkah berikut ini:
   + Untuk membuat IAM role secara otomatis, pilih **Buat peran baru untuk sumber daya khusus ini**.
   + Untuk menggunakan peran IAM yang telah Anda buat, pilih **Gunakan peran yang ada**.

1. (Opsional) Perluas **Pengaturan tambahan**.

   1. Untuk **Mengonfigurasi input target**, pilih bagaimana teks dari suatu peristiwa diproses sebelum diteruskan ke target.

   1. Untuk **Usia maksimum acara**, tentukan interval waktu untuk berapa lama peristiwa yang belum diproses disimpan.

   1. Untuk **mencoba lagi**, masukkan berapa kali suatu peristiwa dicoba ulang.

   1. Untuk **antrian Dead-letter,** pilih opsi bagaimana peristiwa yang belum diproses ditangani. Jika perlu, tentukan antrian Amazon SQS yang akan digunakan sebagai antrian huruf mati.

1. (Opsional) Pilih **Tambahkan target lain** untuk menambahkan target lain untuk aturan ini.

1. Pilih **Berikutnya**.

1. (Opsional) Untuk **Tag**, pilih **Tambahkan tag baru** untuk menambahkan label sumber daya untuk aturan. Untuk informasi selengkapnya, lihat [ EventBridge Tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html). 

1. Pilih **Berikutnya**.

1. Untuk **Meninjau dan membuat**, tinjau langkah-langkah konfigurasi. Jika Anda perlu melakukan perubahan, pilih **Edit**. Setelah selesai, pilih **Buat aturan**.

Untuk informasi selengkapnya tentang membuat aturan, lihat [Membuat EventBridge aturan Amazon yang berjalan sesuai jadwal](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) di *Panduan EventBridge Pengguna Amazon*.

# Tutorial: Buat aturan dengan pola acara
<a name="event-pattern-batch-job"></a>

Prosedur berikut mencakup cara membuat aturan dengan pola acara.

**Untuk membuat aturan yang mengirimkan acara ke target saat acara cocok dengan pola yang ditentukan**
**catatan**  
Prosedur ini berfungsi untuk semua AWS Batch di Amazon ECS, Amazon EKS, dan pekerjaan AWS Fargate.

1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Dari bilah navigasi, pilih yang Wilayah AWS akan digunakan.

1. Di panel navigasi, pilih **Aturan**.

1. Pilih **Buat aturan**.

1. Untuk **Nama**, tentukan nama unik untuk lingkungan komputasi Anda. Nama dapat berisi hingga 64 karakter. Nama dapat memuat huruf besar dan huruf kecil, angka, tanda hubung (-), dan garis bawah (\$1).
**catatan**  
Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus peristiwa yang sama.

1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi untuk aturan.

1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan peristiwa yang berasal dari akun Anda, pilih **default**. Ketika Layanan AWS di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.

1. (Opsional) Matikan aturan pada bus yang dipilih jika Anda tidak ingin segera menjalankan aturan.

1. Untuk **Tipe aturan**, pilih **Aturan dengan pola peristiwa**.

1. Pilih **Selanjutnya**.

1. Untuk **Sumber Acara**, pilih **AWS acara atau acara EventBridge mitra**.

1. (Opsional) Untuk **acara Sampel**:

   1. Untuk **jenis acara Contoh**, pilih **AWS acara**.

   1. Untuk **contoh peristiwa**, pilih **Batch Job State Change**.

1. Untuk **metode Creation**, pilih **Gunakan formulir pola**.

1. Untuk **pola Acara**:

   1. Untuk **Sumber peristiwa**, pilih **Layanan AWS**.

   1. Untuk **Layanan AWS**, pilih **Batch**.

   1. Untuk **jenis Event**, pilih **Batch Job State Change**.

1. Pilih **Berikutnya**.

1. Untuk **Tipe target**, pilih **Layanan AWS**.

1. Untuk **Pilih target**, pilih jenis target. Misalnya, pilih **Antrian pekerjaan Batch**. Kemudian tentukan yang berikut ini:
   + **Job queue** (Antrean tugas): Masukkan Amazon Resource Name (ARN) dari antrean tugas untuk menjadwalkan tugas Anda.
   + **Job definition** (Ketentuan Tugas): Masukkan nama dan revisi atau ARN lengkap ketentuan tugas yang akan digunakan untuk tugas Anda.
   + **Job name** (Nama tugas): Masukkan nama untuk tugas Anda.
   + **Array size** (Ukuran array): (Opsional) Masukkan ukuran array untuk tugas Anda guna menjalankan lebih dari satu salinan. Untuk informasi selengkapnya, lihat [Tugas array](array_jobs.md).
   + **Job attempts** (Upaya tugas): (Opsional) Masukkan jumlah untuk mencoba kembali tugas Anda jika gagal. Untuk informasi selengkapnya, lihat [Percobaan kembali tugas secara otomatis](job_retries.md).

1. Untuk jenis target **antrian pekerjaan Batch**, EventBridge memerlukan izin untuk mengirim peristiwa ke target. EventBridge dapat membuat peran IAM yang diperlukan agar aturan Anda berjalan. Lakukan salah satu dari langkah berikut ini:
   + Untuk membuat IAM role secara otomatis, pilih **Buat peran baru untuk sumber daya khusus ini**.
   + Untuk menggunakan peran IAM yang Anda buat sebelumnya, pilih **Gunakan peran yang sudah ada**.

1. (Opsional) Perluas **Pengaturan tambahan**.

   1. Untuk **Mengonfigurasi input target**, pilih bagaimana teks dari suatu peristiwa diproses.

   1. Untuk **Usia maksimum acara**, tentukan interval waktu untuk berapa lama peristiwa yang belum diproses disimpan.

   1. Untuk **mencoba lagi**, masukkan berapa kali suatu peristiwa dicoba ulang.

   1. Untuk **antrian Dead-letter,** pilih opsi bagaimana peristiwa yang belum diproses ditangani. Jika perlu, tentukan antrian Amazon SQS yang akan digunakan sebagai antrian huruf mati.

1. (Opsional) Pilih **Tambahkan target lain** untuk menambahkan target tambahan.

1. Pilih **Berikutnya**.

1. (Opsional) Untuk **Tag**, pilih **Tambahkan tag baru** untuk menambahkan label sumber daya. Untuk informasi selengkapnya, lihat [ EventBridge tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) *di Panduan EventBridge Pengguna Amazon*.

1. Pilih **Berikutnya**.

1. Untuk **Meninjau dan membuat**, tinjau langkah-langkah konfigurasi. Jika Anda perlu melakukan perubahan, pilih **Edit**. Setelah selesai, pilih **Buat aturan**.

   Untuk informasi selengkapnya tentang membuat aturan, lihat [Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) di *Panduan EventBridge Pengguna Amazon*.

# Tutorial: Berikan informasi acara ke AWS Batch target sesuai jadwal menggunakan transformator EventBridge input
<a name="cwe-input-transformer"></a>

Anda dapat menggunakan transformator EventBridge input untuk meneruskan informasi acara ke AWS Batch dalam pengajuan pekerjaan. Ini bisa sangat berharga jika Anda meminta pekerjaan sebagai hasil dari informasi AWS acara lainnya. Salah satu contohnya adalah upload objek ke bucket Amazon S3. Anda juga dapat menggunakan definisi pekerjaan dengan nilai substitusi parameter dalam perintah container. Transformator EventBridge input dapat memberikan nilai parameter berdasarkan data peristiwa. 

Kemudian, setelah itu, Anda membuat target AWS Batch acara yang mem-parsing informasi dari acara yang memulainya dan mengubahnya menjadi `parameters` objek. Ketika tugas berjalan, parameter dari peristiwa pemicu disampaikan ke perintah kontainer tugas.

**catatan**  
Dalam skenario ini, semua sumber AWS daya (seperti bucket Amazon S3, EventBridge aturan, dan CloudTrail log) harus berada di Wilayah yang sama.

**Untuk membuat AWS Batch target yang menggunakan transformator input**

1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Dari bilah navigasi, pilih yang Wilayah AWS akan digunakan.

1. Di panel navigasi, pilih **Aturan**.

1. Pilih **Buat aturan**.

1. Untuk **Nama**, tentukan nama unik untuk lingkungan komputasi Anda. Nama dapat berisi hingga 64 karakter. Nama dapat memuat huruf besar dan huruf kecil, angka, tanda hubung (-), dan garis bawah (\$1).
**catatan**  
Aturan tidak dapat memiliki nama yang sama dengan aturan lain di bus acara yang sama Wilayah AWS dan di bus acara yang sama.

1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi untuk aturan.

1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan peristiwa yang berasal dari akun Anda, pilih **default**. Ketika Layanan AWS di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.

1. (Opsional) Matikan aturan pada bus yang dipilih jika Anda tidak ingin segera menjalankan aturan.

1. Untuk **jenis Aturan**, pilih **Jadwal**.

1. Pilih **Lanjutkan untuk membuat aturan** atau **Berikutnya**.

1. Untuk **pola Jadwal**, lakukan salah satu hal berikut:
   + Pilih **Jadwal berbutir halus yang berjalan pada waktu tertentu, seperti pukul 8:00 pagi PST pada hari Senin pertama setiap bulan** dan kemudian masukkan ekspresi cron. Untuk informasi selengkapnya, lihat [Ekspresi Cron di](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) *Panduan EventBridge Pengguna Amazon*.
   + Pilih **jadwal yang berjalan dengan tarif reguler, seperti setiap 10 menit.** dan kemudian masukkan ekspresi tingkat.

1. Pilih **Berikutnya**.

1. Untuk **Tipe target**, pilih **Layanan AWS**.

1. Untuk **Pilih target**, pilih **Antrian pekerjaan Batch**. Kemudian, konfigurasikan yang berikut ini:
   + **Job queue** (Antrean tugas): Masukkan Amazon Resource Name (ARN) dari antrean tugas untuk menjadwalkan tugas Anda.
   + **Job definition** (Ketentuan Tugas): Masukkan nama dan revisi atau ARN lengkap ketentuan tugas yang akan digunakan untuk tugas Anda.
   + **Job name** (Nama tugas): Masukkan nama untuk tugas Anda.
   + **Array size** (Ukuran array): (Opsional) Masukkan ukuran array untuk tugas Anda guna menjalankan lebih dari satu salinan. Untuk informasi selengkapnya, lihat [Tugas array](array_jobs.md).
   + **Job attempts** (Upaya tugas): (Opsional) Masukkan jumlah untuk mencoba kembali tugas Anda jika gagal. Untuk informasi selengkapnya, lihat [Percobaan kembali tugas secara otomatis](job_retries.md).

1. Untuk jenis target **antrian pekerjaan Batch**, EventBridge memerlukan izin untuk mengirim peristiwa ke target. EventBridge dapat membuat peran IAM yang diperlukan agar aturan Anda berjalan. Lakukan salah satu dari langkah berikut ini:
   + Untuk membuat IAM role secara otomatis, pilih **Buat peran baru untuk sumber daya khusus ini**.
   + Untuk menggunakan peran IAM yang telah Anda buat, pilih **Gunakan peran yang ada**.

1. (Opsional) Perluas **Pengaturan tambahan**.

1. Di bagian **Pengaturan tambahan**, untuk **Konfigurasi input target**, pilih **Input Transformer**.

1. Pilih **Konfigurasikan transformator input**.

1. (Opsional) Untuk **acara Sampel**:

   1. Untuk **jenis acara Contoh**, pilih **AWS acara**.

   1. Untuk **contoh peristiwa**, pilih **Batch Job State Change**.

1. Di bagian **Transformator input target**, untuk **Jalur input**, tentukan nilai yang akan diuraikan dari peristiwa pemicu. Misalnya, untuk mengurai peristiwa **Perubahan Status Pekerjaan Batch**, gunakan format JSON berikut.

   ```
   {
       "instance": "$.detail.jobId",
       "state": "$.detail.status"
   }
   ```

1. Untuk **Template**, masukkan yang berikut ini.

   ```
   {
       "instance": <jobId> ,
       "status": <status>
   }
   ```

1. Pilih **Konfirmasi**.

1. Untuk **Usia maksimum acara**, tentukan interval waktu untuk berapa lama peristiwa yang belum diproses disimpan.

1. Untuk **mencoba lagi**, masukkan berapa kali suatu peristiwa dicoba ulang.

1. Untuk **antrian Dead-letter,** pilih opsi bagaimana peristiwa yang belum diproses ditangani. Jika perlu, tentukan antrian Amazon SQS yang akan digunakan sebagai antrian huruf mati.

1. (Opsional) Pilih **Tambahkan target lain** untuk menambahkan target tambahan.

1. Pilih **Berikutnya**.

1. (Opsional) Untuk **Tag**, pilih **Tambahkan tag baru** untuk menambahkan label sumber daya. Untuk informasi selengkapnya, lihat [ EventBridge tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) *di Panduan EventBridge Pengguna Amazon*.

1. Pilih **Berikutnya**.

1. Untuk **Meninjau dan membuat**, tinjau langkah-langkah konfigurasi. Jika Anda perlu melakukan perubahan, pilih **Edit**. Setelah selesai, pilih **Buat aturan**.

# Tutorial: Dengarkan acara AWS Batch kerja menggunakan EventBridge
<a name="batch_cwet"></a>

Dalam tutorial ini, Anda menyiapkan AWS Lambda fungsi sederhana yang mendengarkan acara AWS Batch pekerjaan dan menuliskannya ke aliran CloudWatch log Log.

## Prasyarat
<a name="cwet_prereqs"></a>

Tutorial ini mengasumsikan bahwa Anda memiliki lingkungan komputasi yang berfungsi dan antrean tugas yang siap untuk menerima tugas. Jika Anda tidak memiliki lingkungan komputasi yang berjalan dan antrean tugas untuk menangkap peristiwa, ikuti langkah-langkah di [Memulai dengan AWS Batch tutorial](Batch_GetStarted.md) untuk membuatnya. Pada akhir tutorial ini, secara opsional Anda dapat mengirim tugas ke antrean tugas ini untuk menguji bahwa Anda telah mengonfigurasi fungsi Lambda Anda dengan benar. 

**Topics**
+ [

## Prasyarat
](#cwet_prereqs)
+ [

# Tutorial: Buat fungsi Lambda
](cwet_create_lam.md)
+ [

# Tutorial: Daftarkan aturan acara
](cwet_register_event_rule.md)
+ [

# Tutorial: Uji konfigurasi Anda
](cwet_test.md)

# Tutorial: Buat fungsi Lambda
<a name="cwet_create_lam"></a>

 Dalam prosedur ini, Anda membuat fungsi Lambda sederhana untuk berfungsi sebagai target pesan aliran AWS Batch acara. 

**Untuk membuat fungsi Lambda target**

1. Buka AWS Lambda konsol di [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).

1. Pilih **Create function**, **Author dari awal**. 

1. Untuk **Nama fungsi**, masukkan **batch-event-stream-handler**.

1. Untuk **Waktu pengoperasian**, pilih **Python 3.8**.

1. Pilih **Buat fungsi**.

1. Di bagian **Sumber kode**, edit kode sampel agar sesuai dengan contoh berikut:

   ```
   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))
   ```

   Ini adalah fungsi Python 3.8 sederhana yang mencetak peristiwa yang dikirim oleh. AWS Batch Jika semuanya dikonfigurasi dengan benar, di akhir tutorial ini, detail peristiwa muncul di aliran CloudWatch log Log yang terkait dengan fungsi Lambda ini.

1. Pilih **Deploy**.

# Tutorial: Daftarkan aturan acara
<a name="cwet_register_event_rule"></a>

Di bagian ini, Anda membuat aturan EventBridge acara yang menangkap peristiwa pekerjaan yang berasal dari AWS Batch sumber daya Anda. Aturan ini menangkap semua peristiwa yang berasal dari AWS Batch dalam akun di mana itu didefinisikan. Pesan tugas itu sendiri berisi informasi tentang sumber peristiwa, termasuk antrean tugas tempat itu dikirimkan. Anda dapat menggunakan informasi ini untuk mem-filter dan mengurutkan peristiwa secara terprogram.

**catatan**  
Jika Anda menggunakan aturan Konsol Manajemen AWS untuk membuat acara, konsol secara otomatis menambahkan izin IAM EventBridge untuk memanggil fungsi Lambda Anda. Namun, jika Anda membuat aturan acara menggunakan AWS CLI, Anda harus memberikan izin secara eksplisit. Untuk informasi selengkapnya, lihat [Peristiwa dan Pola Peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) di *Panduan EventBridge Pengguna Amazon*.

**Untuk membuat EventBridge aturan Anda**

1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Di panel navigasi, pilih **Aturan**.

1. Pilih **Buat aturan**.

1. Masukkan nama dan deskripsi untuk aturan.

   Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus kejadian yang sama.

1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan acara yang berasal dari akun Anda, pilih **bus acara AWS default**. Ketika AWS layanan di akun Anda memancarkan suatu acara, itu selalu masuk ke bus acara default akun Anda.

1. Untuk **Tipe aturan**, pilih **Aturan dengan pola peristiwa**.

1. Pilih **Selanjutnya**.

1. Untuk **sumber acara**, pilih **Lainnya**.

1. Untuk **pola Acara**, pilih **Pola kustom (editor JSON)**.

1. Tempel pola peristiwa berikut ke area teks.

   ```
   {
     "source": [
       "aws.batch"
     ]
   }
   ```

   Aturan ini berlaku di semua AWS Batch grup Anda dan untuk setiap AWS Batch acara. Sebagai alternatif, Anda dapat membuat pola yang lebih spesifik untuk memfilter beberapa hasil.

1. Pilih **Berikutnya**.

1. Untuk **Jenis target**, pilih **Layanan AWS **.

1. Untuk **Pilih target**, pilih fungsi **Lambda, dan pilih fungsi** Lambda Anda.

1. (Opsional) Untuk **pengaturan tambahan**, lakukan hal berikut:

   1. Untuk **Masa peristiwa maksimal**, masukkan nilai antara satu menit (00:01) dan 24 jam (24:00).

   1. Untuk **Upaya coba lagi**, masukkan angka antara 0 dan 185.

   1. Untuk **antrian Dead-letter**, pilih apakah akan menggunakan antrean Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu tindakan berikut:
      + Pilih **Tidak ada** untuk tidak menggunakan antrean surat mati.
      + Pilih **Pilih antrean Amazon SQS di AWS akun saat ini untuk digunakan sebagai antrian huruf mati dan kemudian pilih antrian yang akan digunakan dari tarik-turun**.
      + Pilih **Pilih antrean Amazon SQS di AWS akun lain sebagai antrian huruf mati dan kemudian masukkan ARN antrian** yang akan digunakan. Anda harus melampirkan kebijakan berbasis sumber daya ke antrian yang memberikan EventBridge izin untuk mengirim pesan ke antrean tersebut. *Untuk informasi selengkapnya, lihat [Memberikan izin untuk antrean huruf mati di Panduan Pengguna](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms) Amazon. EventBridge *

1. Pilih **Berikutnya**.

1. (Opsional) Masukkan satu atau lebih tanda untuk aturan. Untuk informasi selengkapnya, lihat [ EventBridge tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) *di Panduan EventBridge Pengguna Amazon*.

1. Pilih **Berikutnya**.

1. Tinjau detail aturan dan pilih **Buat aturan**.

# Tutorial: Uji konfigurasi Anda
<a name="cwet_test"></a>

Anda sekarang dapat menguji EventBridge konfigurasi Anda dengan mengirimkan pekerjaan ke antrian pekerjaan Anda. Jika semuanya dikonfigurasi dengan benar, fungsi Lambda Anda dipicu dan menulis data peristiwa ke aliran CloudWatch log Log untuk fungsi tersebut.

**Untuk menguji konfigurasi EFA dan NCCL Anda**

1. Buka AWS Batch konsol di [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. Kirim AWS Batch pekerjaan baru. Untuk informasi selengkapnya, lihat [Tutorial: kirimkan pekerjaan](submit_job.md).

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Pada panel navigasi, pilih **Log dan pilih grup log** untuk fungsi Lambda Anda (misalnya**,** *my-function* /aws/lambda/).

1. Pilih stream log untuk melihat data peristiwa. 

# Tutorial: Mengirim peringatan Layanan Pemberitahuan Sederhana Amazon untuk acara pekerjaan yang gagal
<a name="batch_sns_tutorial"></a>

Dalam tutorial ini, Anda mengonfigurasi aturan EventBridge acara Amazon yang hanya menangkap peristiwa pekerjaan di mana pekerjaan telah dipindahkan ke `FAILED` status. Pada akhir tutorial ini, Anda juga dapat secara opsional mengirim tugas ke antrean tugas ini. Ini untuk menguji bahwa Anda telah mengonfigurasi pemberitahuan Amazon SNS Anda dengan benar.

## Prasyarat
<a name="batch_sns_prereq"></a>

Tutorial ini mengasumsikan bahwa Anda memiliki lingkungan komputasi yang berfungsi dan antrean tugas yang siap untuk menerima tugas. Jika Anda tidak memiliki lingkungan komputasi yang berjalan dan antrean tugas untuk menangkap peristiwa, ikuti langkah-langkah di [Memulai dengan AWS Batch tutorial](Batch_GetStarted.md) untuk membuatnya. 

**Topics**
+ [

## Prasyarat
](#batch_sns_prereq)
+ [

# Tutorial: Membuat dan berlangganan topik Amazon SNS
](batch_sns_create_topic.md)
+ [

# Tutorial: Daftarkan aturan acara
](batch_sns_reg_rule.md)
+ [

# Tutorial: Uji aturan Anda
](batch_sns_test_rule.md)
+ [

## Aturan alternatif: Antrian pekerjaan batch diblokir
](#test_blocked_job_queue)

# Tutorial: Membuat dan berlangganan topik Amazon SNS
<a name="batch_sns_create_topic"></a>

 Untuk tutorial ini, Anda mengonfigurasi topik Amazon SNS yang berfungsi sebagai target peristiwa untuk aturan peristiwa baru Anda. 

**Untuk membuat topik Amazon SNS**

1. [Buka konsol Amazon SNS di https://console.aws.amazon.com/sns/ v3/home.](https://console.aws.amazon.com/sns/v3/home)

1. Pilih **Topics** (Topik), **Create topic** (Buat topik).

1. Untuk **Tipe**, pilih **Standar**.

1. Untuk **Nama**, masukkan **JobFailedAlert** dan pilih **Buat topik**.

1. Di **JobFailedAlert**layar, pilih **Buat langganan**. 

1. Untuk **Protokol**, pilih **Email**.

1. Untuk**Titik akhir**, masukkan alamat email yang Anda dapat mengaksesnya dan pilih **Buat langganan**.

1. Periksa akun email Anda dan tunggu sampai Anda menerima pesan email konfirmasi langganan. Saat Anda menerimanya, pilih **Konfirmasi langganan**. 

# Tutorial: Daftarkan aturan acara
<a name="batch_sns_reg_rule"></a>

 Selanjutnya, daftarkan aturan peristiwa yang hanya menangkap peristiwa tugas gagal. 

**Untuk mendaftarkan EventBridge aturan Anda**

1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Di panel navigasi, pilih **Aturan**.

1. Pilih **Buat aturan**.

1. Masukkan nama dan deskripsi untuk aturan.

   Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus kejadian yang sama.

1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan acara yang berasal dari akun Anda, pilih **bus acara AWS default**. Ketika AWS layanan di akun Anda memancarkan suatu acara, itu selalu masuk ke bus acara default akun Anda.

1. Untuk **Tipe aturan**, pilih **Aturan dengan pola peristiwa**.

1. Pilih **Selanjutnya**.

1. Untuk **sumber acara**, pilih **Lainnya**.

1. Untuk **pola Acara**, pilih **Pola kustom (editor JSON)**.

1. Tempel pola peristiwa berikut ke area teks.

   ```
   {
     "detail-type": [
       "Batch Job State Change"
     ],
     "source": [
       "aws.batch"
     ],
     "detail": {
       "status": [
         "FAILED"
       ]
     }
   }
   ```

   Kode ini mendefinisikan EventBridge aturan yang cocok dengan peristiwa apa pun di mana status pekerjaan berada`FAILED`. Untuk informasi selengkapnya tentang pola peristiwa, lihat [Peristiwa dan Pola Peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) di *Panduan EventBridge Pengguna Amazon*.

1. Pilih **Berikutnya**.

1. Untuk **Jenis target**, pilih **Layanan AWS **.

1. Untuk **Pilih target**, pilih **topik SNS**, dan untuk **Topik**, pilih **JobFailedAlert**.

1. (Opsional) Untuk **pengaturan tambahan**, lakukan hal berikut:

   1. Untuk **Masa peristiwa maksimal**, masukkan nilai antara satu menit (00:01) dan 24 jam (24:00).

   1. Untuk **Upaya coba lagi**, masukkan angka antara 0 dan 185.

   1. Untuk **antrian Dead-letter**, pilih apakah akan menggunakan antrean Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu tindakan berikut:
      + Pilih **Tidak ada** untuk tidak menggunakan antrean surat mati.
      + Pilih **Pilih antrean Amazon SQS di AWS akun saat ini untuk digunakan sebagai antrian huruf mati dan kemudian pilih antrian yang akan digunakan dari tarik-turun**.
      + Pilih **Pilih antrean Amazon SQS di AWS akun lain sebagai antrian huruf mati dan kemudian masukkan ARN antrian** yang akan digunakan. Anda harus melampirkan kebijakan berbasis sumber daya ke antrian yang memberikan EventBridge izin untuk mengirim pesan ke antrean tersebut. *Untuk informasi selengkapnya, lihat [Memberikan izin untuk antrean huruf mati di Panduan Pengguna](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms) Amazon. EventBridge *

1. Pilih **Berikutnya**.

1. (Opsional) Masukkan satu atau lebih tanda untuk aturan. Untuk informasi selengkapnya, lihat [ EventBridge tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) *di Panduan EventBridge Pengguna Amazon*.

1. Pilih **Berikutnya**.

1. Tinjau detail aturan dan pilih **Buat aturan**.

# Tutorial: Uji aturan Anda
<a name="batch_sns_test_rule"></a>

Untuk menguji aturan Anda, kirim tugas yang keluar segera setelah dimulai dengan kode keluar bukan nol. Jika aturan acara Anda dikonfigurasi dengan benar, Anda akan menerima pesan email dalam beberapa menit dengan teks peristiwa. 

**Untuk menguji aturan**

1. Buka AWS Batch konsol di [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. Kirim AWS Batch pekerjaan baru. Untuk informasi selengkapnya, lihat [Tutorial: kirimkan pekerjaan](submit_job.md). Untuk perintah tugas, ganti perintah ini untuk keluar dari kontainer dengan kode keluar 1.

   ```
   /bin/sh, -c, 'exit 1'
   ```

1. Periksa email Anda untuk mengonfirmasi bahwa Anda menerima pemberitahuan email untuk notifikasi tugas yang gagal.

## Aturan alternatif: Antrian pekerjaan batch diblokir
<a name="test_blocked_job_queue"></a>

Untuk membuat aturan acara yang memantau *antrian pekerjaan batch yang diblokir*, ulangi tutorial ini dengan perubahan berikut:

1. **Di [Tutorial: Membuat dan berlangganan topik Amazon SNS](batch_sns_create_topic.md)**, gunakan *BlockedJobQueue* sebagai nama topik.

1. **Dalam [Tutorial: Daftarkan aturan acara](batch_sns_reg_rule.md)**, gunakan pola berikut di editor JSON:

   ```
   {
      "detail-type": [
        "Batch Job Queue Blocked"
      ],
      "source": [
        "aws.batch"
      ]
   }
   ```