View a markdown version of this page

Menggunakan EventBridge dengan AWS HealthOmics - AWS HealthOmics

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?

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:

  1. Buka EventBridge konsol: https://console.aws.amazon.com/events/.

  2. Di navigasi kiri, pilih Bus acara.

  3. Pilih Buat bus peristiwa.

  4. Dalam formulir Buat bus acara, masukkan nama untuk bus.

  5. Pilih Buat untuk membuat bus.

Buat EventBridge aturan

Prosedur berikut menunjukkan cara membuat aturan sederhana. Untuk informasi selengkapnya tentang aturan, lihat Aturan di EventBridge.

  1. Buka EventBridge konsol: https://console.aws.amazon.com/events/.

  2. Di navigasi kiri, pilih A turan.

  3. Pilih Buat aturan. Konsol membuka formulir Buat aturan.

  4. Di Tentukan detail aturan, berikan nama untuk aturan.

    • Untuk Nama, masukkan nama untuk bus.

    • Untuk bus acara, pilih bus untuk aturan ini.

    • Pilih Berikutnya.

  5. Di Membangun pola acara, di bawah Sumber acara pilih acara AWS atau acara EventBridge mitra.

  6. Gulir ke bawah ke Pola acara.

    1. Untuk Sumber acara, pilih layanan AWS.

    2. Untuk layanan AWS, masukkan omics di filter teks dan pilih AWS HealthOmics sebagai layanan.

    3. Untuk Jenis acara pilih acara yang menarik (atau Semua acara).

    4. Pilih Berikutnya.

  7. 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.

  8. (Opsional) Di Konfigurasi tag, kaitkan tag dengan aturan.

  9. 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" } }