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 mengirim acara ke Amazon EventBridge saat sumber daya berubah 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 peristiwa.
Bus acara adalah router yang menerima acara dan mengirimkannya ke tujuan. Akun Anda menyertakan bus acara default yang secara otomatis menerima peristiwa dari AWS layanan. Anda dapat membuat bus acara khusus tambahan.
Anda membuat EventBridge aturan untuk menentukan tindakan yang harus dilakukan saat bus acara menerima peristiwa. 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 berbagi.
-
Untuk memantau apakah proses gagal atau selesai dengan sukses.
Untuk informasi selengkapnya tentang penggunaan EventBridge, lihat Apa itu Amazon EventBridge?
Topik
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 mengonfigurasi bus acara khusus. Untuk mengonfigurasi bus acara khusus, ikuti langkah-langkah berikut:
-
Buka EventBridge konsol: https://console.aws.amazon.com/events/
. -
Di navigasi kiri, pilih Bus acara.
-
Pilih Buat bus peristiwa.
-
Dalam formulir Buat bus acara, masukkan nama untuk bus.
-
Pilih Buat untuk membuat bus.
Buat EventBridge aturan
Prosedur berikut menunjukkan cara membuat aturan sederhana. Untuk informasi selengkapnya tentang aturan, lihat Aturan di EventBridge.
-
Buka EventBridge konsol: https://console.aws.amazon.com/events/
. -
Di navigasi kiri, pilih A turan.
-
Pilih Buat aturan. Konsol membuka formulir Buat aturan.
-
Di Tentukan detail aturan, berikan nama untuk aturan.
Untuk Nama, masukkan nama untuk bus.
Untuk bus acara, pilih bus untuk aturan ini.
Pilih Berikutnya.
-
Di Membangun pola acara, di bawah Sumber acara pilih acara AWS atau acara EventBridge mitra.
-
Gulir ke bawah ke Pola acara.
-
Untuk Sumber acara, pilih layanan AWS.
-
Untuk layanan AWS, masukkan omics di filter teks dan pilih AWS HealthOmics sebagai layanan.
-
Untuk Jenis acara pilih acara yang menarik (atau Semua acara).
-
Pilih Berikutnya.
-
-
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.
-
(Opsional) Di Konfigurasi tag, kaitkan tag dengan aturan.
-
Di Tinjau dan perbarui, tinjau konfigurasi dan pilih Buat aturan.
EventBridge acara 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 |
|---|---|
| Perubahan Status Pekerjaan Impor Anotasi | Dikirim, sedang berlangsung, dibatalkan, diselesaikan, gagal, atau diselesaikan dengan kegagalan |
| Perubahan Status Bagikan Toko Anotasi | Tertunda, 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, sedang berlangsung, selesai, gagal, atau diselesaikan dengan kegagalan |
| Baca Mengatur Perubahan Status Pekerjaan Ekspor | Dikirim, sedang berlangsung, selesai, gagal, atau diselesaikan dengan kegagalan |
| Baca Mengatur Perubahan Status Pekerjaan Impor | Dikirim, sedang berlangsung, selesai, gagal, atau diselesaikan dengan kegagalan |
| Baca Setel Perubahan Status | Memproses unggahan, unggahan gagal, aktif, diarsipkan, mengaktifkan, atau dihapus |
| Perubahan Status Pekerjaan Impor Referensi | Dikirim, sedang berlangsung, selesai, gagal, atau diselesaikan dengan kegagalan |
| Perubahan Status Referensi | Aktif atau dihapus |
| Perubahan Status Toko Referensi | Dibuat, diperbarui, aktif, atau dihapus |
| Jalankan Perubahan Status | Menunda, memulai, menjalankan, menghentikan, selesai, dihapus, gagal, atau dibatalkan |
| Perubahan Status Penyimpanan Urutan | Dibuat, diperbarui, aktif, atau dihapus |
| Perubahan Status Tugas | Menunda, memulai, menjalankan, menghentikan, selesai, dihapus, gagal, atau dibatalkan |
| Perubahan Status Pekerjaan Impor Varian | Dikirim, sedang berlangsung, dibatalkan, diselesaikan, gagal, atau diselesaikan dengan kegagalan |
| Perubahan Status Berbagi Toko Varian | Tertunda, mengaktifkan, aktif, menghapus, dihapus, gagal |
| Perubahan Status Toko Varian | Membuat, membuat, memperbarui, memperbarui, menghapus, menghapus, atau membuat gagal |
| Perubahan Status Bagikan Alur Kerja | Tertunda, mengaktifkan, aktif, menghapus, dihapus, gagal |
| Perubahan Status Alur Kerja | Keberhasilan pembuatan, kegagalan pembuatan, keberhasilan penghapusan, atau kegagalan penghapusan |
Struktur pesan peristiwa
HealthOmics memberikan pengiriman upaya terbaik untuk mengirim pesan acara perubahan status ke EventBridge. Acara adalah objek dengan struktur JSON yang juga berisi detail metadata. Anda dapat menggunakan metadata sebagai input untuk membuat ulang acara atau untuk mempelajari informasi lebih lanjut. Acara meliputi bidang-bidang berikut:
-
version— Saat ini 0 (nol) untuk semua acara. -
id- UUID Versi 4 yang dihasilkan untuk setiap acara. -
detail-typeJenis acara yang sedang dikirim. -
account— Akun AWS ID 12 digit pemilik bucket. -
source— Mengidentifikasi layanan yang menghasilkan acara. -
time- Waktu peristiwa itu terjadi. -
region— Men Wilayah AWS gidentifikasi ember. -
resources— Sebuah array JSON yang berisi Amazon Resource Name (ARN) dari bucket. -
detail— Objek JSON yang berisi informasi tentang acara tersebut.
Jalankan acara mencakup bidang berikut:
-
uuid— Pengidentifikasi unik universal untuk proses. -
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 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 acara 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" } }
Acara serupa akan 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" } }