Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan EventBridge dengan AWS HealthOmics
HealthOmics mengirimkan peristiwa ke Amazon EventBridge saat sumber daya mengubah status. Sumber daya termasuk pekerjaan impor, pekerjaan ekspor, pembagian sumber daya, alur kerja, tugas, dan proses. Untuk setiap jenis sumber daya, ada daftar perubahan status yang menghasilkan suatu peristiwa.
Bus acara adalah router yang menerima acara dan mengirimkannya ke tujuan. Akun Anda menyertakan bus acara default yang secara otomatis menerima acara dari AWS layanan. Anda dapat membuat bus acara khusus tambahan.
Anda membuat EventBridge aturan untuk menentukan tindakan yang harus diambil ketika bus acara menerima acara. Misalnya, Anda dapat membuat aturan yang memberi tahu Anda tentang perubahan status untuk sumber daya.
Skenario umum untuk menggunakan acara meliputi:
+ Untuk memantau kapan pengguna berbagi sumber daya dengan Anda atau mencabut pembagian.
+ Untuk memantau apakah proses gagal atau berhasil diselesaikan.
Untuk informasi selengkapnya tentang penggunaan EventBridge, lihat [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com//eventbridge/latest/userguide/eb-what-is.html)
**Topics**
+ [Siapkan EventBridge untuk HealthOmics](#eventbridge-setup-events)
+ [EventBridge peristiwa di HealthOmics](#eventbridge-healthomics-events)
+ [Struktur pesan peristiwa](#eventbridge-message-structure)
+ [Contoh pesan acara](#eventbridge-cli-examples)
## Siapkan EventBridge untuk HealthOmics
Sebelum Anda dapat memantau EventBridge acara, buat EventBridge bus dan buat aturan untuk acara yang menarik.
### Konfigurasikan EventBridge bus
Anda dapat menggunakan bus acara default untuk Anda Akun AWS atau mengkonfigurasi bus acara khusus. Untuk mengonfigurasi bus acara khusus, ikuti langkah-langkah berikut:
1. Buka EventBridge konsol: [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Di navigasi kiri, pilih **Bus acara**.
1. Pilih **Buat bus peristiwa**.
1. Dalam formulir **Buat bus acara**, masukkan nama untuk bus.
1. Pilih **Buat** untuk membuat bus.
### Buat EventBridge aturan
Prosedur berikut menunjukkan cara membuat aturan sederhana. Untuk informasi selengkapnya tentang aturan, lihat [Aturan di EventBridge](https://docs.aws.amazon.com//eventbridge/latest/userguide/eb-create-rule.html).
1. Buka EventBridge konsol: [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Di navigasi kiri, pilih **Aturan**.
1. Pilih **Buat aturan**. Konsol membuka formulir **Create rule**.
1. Di **Tentukan detail aturan**, berikan nama untuk aturan tersebut.
+ Untuk **Nama**, masukkan nama untuk bus.
+ Untuk **bus acara**, pilih bus untuk aturan ini.
+ Pilih **Berikutnya**.
1. Dalam **pola acara Build**, di bawah **Sumber acara** pilih **acara AWS atau acara EventBridge mitra**.
1. Gulir ke bawah ke **pola Acara**.
1. Untuk **sumber Acara**, pilih **layanan AWS**.
1. Untuk **layanan AWS**, masukkan **omics** di filter teks dan pilih **AWS HealthOmics**sebagai layanan.
1. Untuk **jenis Acara** pilih acara yang diminati (atau **Semua acara**).
1. Pilih **Berikutnya**.
1. Di **Pilih target**, pilih target untuk acara tersebut. Misalnya, pilih **layanan AWS**, **grup CloudWatch log** yang dipilih, dan konfigurasikan grup log.
Untuk banyak jenis target, EventBridge perlu izin untuk mengirim acara ke target. Konsol membuat izin ini untuk Anda.
1. (Opsional) Di **Konfigurasikan tag**, kaitkan tag dengan aturan.
1. Di **Tinjau dan perbarui**, tinjau konfigurasi dan pilih **Buat aturan**.
## EventBridge peristiwa di HealthOmics
Tabel berikut mencantumkan peristiwa yang HealthOmics dikirim ke EventBridge, dan daftar nilai status yang mungkin untuk acara tersebut.
| Nama peristiwa | Nilai status yang mungkin |
| --- | --- |
| Anotasi Impor Perubahan Status Job | Dikirim, sedang berlangsung, dibatalkan, diselesaikan, gagal, atau diselesaikan dengan kegagalan |
| Perubahan Status Bagikan Toko Anotasi | Menunggu, mengaktifkan, aktif, menghapus, dihapus, gagal |
| Perubahan Status Toko Anotasi | Membuat, membuat, memperbarui, memperbarui, menghapus, menghapus, atau membuat gagal |
| Baca Mengatur Perubahan Status Pekerjaan Aktivasi | Dikirim, dalam proses, selesai, gagal, atau diselesaikan dengan kegagalan |
| Baca Mengatur Perubahan Status Pekerjaan Ekspor | Dikirim, dalam proses, selesai, gagal, atau diselesaikan dengan kegagalan |
| Baca Mengatur Impor Perubahan Status Job | Dikirim, dalam proses, selesai, gagal, atau diselesaikan dengan kegagalan |
| Baca Mengatur Perubahan Status | Pemrosesan unggahan, pengunggahan gagal, aktif, diarsipkan, mengaktifkan, atau dihapus |
| Referensi Impor Perubahan Status Job | Dikirim, dalam proses, selesai, gagal, atau diselesaikan dengan kegagalan |
| Perubahan Status Referensi | Aktif atau dihapus |
| Perubahan Status Toko Referensi | Dibuat, diperbarui, aktif, atau dihapus |
| Jalankan Perubahan Status | Menunggu, memulai, menjalankan, menghentikan, menyelesaikan, dihapus, gagal, atau dibatalkan |
| Perubahan Status Toko Urutan | Dibuat, diperbarui, aktif, atau dihapus |
| Perubahan Status Tugas | Menunggu, memulai, menjalankan, menghentikan, menyelesaikan, dihapus, gagal, atau dibatalkan |
| Perubahan Status Pekerjaan Impor Varian | Dikirim, sedang berlangsung, dibatalkan, diselesaikan, gagal, atau diselesaikan dengan kegagalan |
| Perubahan Status Berbagi Toko Varian | Menunggu, mengaktifkan, aktif, menghapus, dihapus, gagal |
| Perubahan Status Toko Varian | Membuat, membuat, memperbarui, memperbarui, menghapus, menghapus, atau membuat gagal |
| Perubahan Status Berbagi Alur Kerja | Menunggu, mengaktifkan, aktif, menghapus, dihapus, gagal |
| Perubahan Status Alur Kerja | Keberhasilan penciptaan, kegagalan penciptaan, keberhasilan penghapusan, atau kegagalan penghapusan |
## Struktur pesan peristiwa
HealthOmics menyediakan pengiriman upaya terbaik untuk mengirim pesan peristiwa perubahan status ke EventBridge. Acara ini adalah objek dengan struktur JSON yang juga berisi detail metadata. Anda dapat menggunakan metadata sebagai masukan untuk membuat ulang acara atau untuk mempelajari informasi lebih lanjut. Acara meliputi bidang-bidang berikut:
+ `version`— Saat ini 0 (nol) untuk semua acara.
+ `id`— Versi 4 UUID dihasilkan untuk setiap acara.
+ `detail-type`— Jenis acara yang sedang dikirim.
+ `account`— 12 digit Akun AWS ID pemilik bucket.
+ `source`— Mengidentifikasi layanan yang menghasilkan acara.
+ `time`- Waktu peristiwa itu terjadi.
+ `region`— Mengidentifikasi ember. Wilayah AWS
+ `resources`— Sebuah array JSON yang berisi Amazon Resource Name (ARN) dari bucket.
+ `detail`— Objek JSON yang berisi informasi tentang acara tersebut.
Jalankan acara meliputi bidang-bidang berikut:
+ `uuid`— Pengidentifikasi unik secara universal untuk menjalankan.
+ `workflowId`— Pengidentifikasi alur kerja dari alur kerja yang terkait dengan proses ini.
+ `workflowName`— Nama alur kerja yang terkait dengan proses ini..
+ `runId`— Jalankan pengenal.
+ `runName`— Jalankan nama.
+ `runOutputUri`— URI untuk tempat run akan menulis data outputnya.
## Contoh pesan acara
Contoh berikut adalah peristiwa untuk perubahan status run, menunjukkan bidang tambahan.
```
{
"version":"0",
"id":"c0e540f4-df38-b986-86c1-3e3730f971fe",
"detail-type":"Run Status Change",
"source":"aws.omics",
"account":"123456789012",
"time":"2022-10-20T22:07:35Z",
"region":"us-west-2",
"resources":[
"arn:aws:omics:us-west-2:123456789012:run/2101313"
],
"detail":{
"omicsVersion":"1.0.0",
"arn":"arn:aws:omics:us-west-2:123456789012:run/2101313",
"status":"COMPLETED",
"uuid":"153893cd-097a-40ec-aec7-838a97cd2b21",
"runId": "1234567",
"runName": "run name",
"runOutputUri": "s3://amzn-s3-demo-bucket/run-output/2101313",
"workflowId": "1234567",
"workflowName": "workflow name"
}
}
```
Contoh berikut adalah peristiwa untuk perubahan status tugas.
```
{
"version": "0",
"id": "718d6817-c868-26d3-8ef0-0dc9b2ac73f4",
"detail-type": "Task Status Change",
"source": "aws.omics",
"account": "123456789012",
"time": "2024-10-30T09:05:44Z",
"region": "us-west-2",
"resources": ["arn:aws:omics:us-west-2:123456789012:task/8888888"],
"detail": {
"omicsVersion": "1.0.0",
"arn": "arn:aws:omics:us-west-2:123456789012:task/8888888",
"status": "COMPLETED",
"runArn": "arn:aws:omics:us-west-2:123456789012:run/2101313",
"runUuid": "153893cd-097a-40ec-aec7-838a97cd2b21",
"runId": "1234567",
"runName": "run name",
"workflowId": "1234567",
"workflowName": "workflow name"
}
}
```
Berikut ini adalah contoh peristiwa untuk perubahan status set baca.
```
{
"version": "0",
"id": "64ca0eda-9751-dc55-c41a-1bd50b4fc9b7",
"detail-type": "Read Set Status Change",
"source": "aws.omics",
"account": "123456789012",
"time": "2023-04-04T17:53:06Z",
"region": "us-west-2",
"resources": ["arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890/readSet/3456789012"],
"detail": {
"omicsVersion": "1.0.0",
"arn": "arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890/readSet/3456789012",
"sequenceStoreId" : "1234567890",
"id": "3456789012",
"status": "PROCESSING_UPLOAD"
}
}
```
Peristiwa serupa dibuat untuk pekerjaan impor toko varian.
```
{
"version": "0",
"id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
"detail-type": "Variant Store Status Change",
"source": "aws.omics",
"account": "123456789012",
"time": "2015-12-22T18:43:48Z",
"region": "us-east-1",
"resources": ["arn:aws:omics:us-east-1:123456789012:myvariantstore2"],
"detail": {
"omicsVersion": "1.0.0",
"arn": "arn:aws:omics:us-east-1:123456789012:myvariantstore2",
"status": "CREATED",
"storeId": "6710c5f02610",
"storeName": "myvariantstore2"
}
}
```
Berikut ini adalah peristiwa untuk perubahan status pekerjaan impor.
```
{
"version": "0",
"id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
"detail-type": "Variant Import Job Status Change",
"source": "aws.omics",
"account": "123456789012",
"time": "2015-12-22T18:43:48Z",
"region": "us-east-1",
"resources": ["arn:aws:omics:us-east-1:123456789012:my_variant_store/b64ea9a3-459f-4b68-92c3-3ddb83209fe9"],
"detail": {
"omicsVersion": "1.0.0",
"arn": "arn:aws:omics:us-east-1:123456789012:my_variant_store/b64ea9a3-459f-4b68-92c3-3ddb83209fe9",
"status": "COMPLETED",
"jobId": "b64ea9a3-459f-4b68-92c3-3ddb83209fe9",
"storeId": "a74869f91e20",
"storeName": "my_variant_store"
}
}
```