Siapkan EventBridge untuk HealthOmics EventBridge peristiwa di HealthOmics Struktur pesan peristiwa Contoh pesan acara

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?

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:

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 Aturan.
Pilih Buat aturan. Konsol membuka formulir Create rule.
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.
Dalam pola acara Build, di bawah Sumber acara pilih acara AWS atau acara EventBridge mitra.
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 HealthOmicssebagai layanan.
3. Untuk jenis Acara pilih acara yang diminati (atau Semua acara).
4. 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 Konfigurasikan tag, kaitkan tag dengan aturan.
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"
    }
}

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

CloudTrail log

Pemecahan Masalah