Integrasi AWS Health dengan sistem lain menggunakan AWS Health API - AWS Health

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

Integrasi AWS Health dengan sistem lain menggunakan AWS Health API

AWS Health adalah layanan RESTful web yang digunakan HTTPS sebagai transportasi dan JSON sebagai format serialisasi pesan. Kode aplikasi Anda dapat membuat permintaan langsung ke file AWS Health API. Ketika Anda menggunakan secara REST API langsung, Anda harus menulis kode yang diperlukan untuk menandatangani dan mengotentikasi permintaan Anda. Untuk informasi selengkapnya tentang AWS Health operasi dan parameter, lihat AWS Health APIReferensi.

catatan

Anda harus memiliki paket Business, Enterprise On-Ramp, atau Enterprise Support dari AWS Dukunganuntuk menggunakan. AWS Health API Jika Anda menelepon AWS Health API dari AWS akun yang tidak memiliki paket Business, Enterprise On-Ramp, atau Enterprise Support, Anda akan menerima kesalahan. SubscriptionRequiredException

Anda dapat menggunakan AWS SDKs untuk membungkus AWS Health REST API panggilan, yang dapat menyederhanakan pengembangan aplikasi Anda. Anda menentukan AWS kredensyal Anda, dan pustaka ini menangani otentikasi dan penandatanganan permintaan untuk Anda.

AWS Health juga menyediakan AWS Health Dasbor AWS Management Console yang dapat Anda gunakan untuk melihat dan mencari peristiwa dan entitas yang terpengaruh. Lihat Memulai AWS Health Dashboard Anda.

Menandatangani permintaan AWS Health API

Saat Anda menggunakan AWS SDKs atau AWS Command Line Interface (AWS CLI) untuk membuat permintaan AWS, alat ini secara otomatis menandatangani permintaan untuk Anda dengan kunci akses yang Anda tentukan saat Anda mengonfigurasi alat. Misalnya, jika Anda menggunakan demo titik akhir ketersediaan tinggi sebelumnya, Anda tidak perlu menandatangani permintaan sendiri. AWS SDK for Java

Contoh kode Java

Untuk contoh lebih lanjut tentang cara menggunakan AWS Health API with AWS SDK for Java, lihat kode contoh ini.

Saat Anda mengajukan permintaan, kami sangat menyarankan agar Anda tidak menggunakan kredensyal akun AWS root Anda untuk akses reguler. AWS Health Anda dapat menggunakan kredensialnya untuk pengguna. IAM Untuk informasi selengkapnya, lihat Mengunci Kunci Akses Pengguna Root AWS Akun Anda di Panduan IAM Pengguna.

Jika Anda tidak menggunakan AWS SDKs atau AWS CLI, maka Anda harus menandatangani permintaan Anda sendiri. Kami menyarankan Anda menggunakan AWS Signature Version 4. Untuk informasi selengkapnya, lihat Menandatangani AWS API Permintaan di Referensi Umum AWS.

Memilih titik akhir untuk permintaan AWS Health API

AWS Health APIBerikut arsitektur aplikasi Multi-region Arsitektur aplikasi dan memiliki dua titik akhir regional dalam konfigurasi aktif-pasif. Untuk mendukung DNS failover aktif-pasif, AWS Health sediakan satu titik akhir global. Anda dapat melakukan DNS pencarian pada titik akhir global untuk menentukan titik akhir aktif dan Wilayah penandatanganan yang sesuai. AWS Ini membantu Anda mengetahui titik akhir mana yang akan digunakan dalam kode Anda, sehingga Anda bisa mendapatkan informasi terbaru dari AWS Health.

Saat Anda membuat permintaan ke titik akhir global, Anda harus menentukan kredensyal AWS akses Anda ke titik akhir regional yang Anda targetkan dan mengonfigurasi penandatanganan untuk Wilayah Anda. Jika tidak, autentikasi Anda mungkin gagal. Untuk informasi selengkapnya, lihat Menandatangani permintaan AWS Health API.

Tabel berikut menggambarkan konfigurasi default.

Deskripsi Penandatanganan Wilayah Titik akhir Protokol
Aktif

us-east-1

health.us-east-1.amazonaws.com

HTTPS
Pasif

us-east-2

health.us-east-2.amazonaws.com

HTTPS
Global

us-east-1

catatan

Ini adalah Wilayah penandatanganan titik akhir aktif saat ini.

global.health.amazonaws.com

HTTPS

Untuk menentukan apakah titik akhir adalah titik akhir aktif, lakukan DNS pencarian pada titik akhir globalCNAME, lalu ekstrak AWS Wilayah dari nama yang diselesaikan.

contoh : DNS pencarian di titik akhir global

Perintah kemudian mengembalikan titik akhir Wilayah us-east-1. Output ini memberi tahu Anda titik akhir mana yang harus Anda gunakan. AWS Health

dig global.health.amazonaws.com | grep CNAME global.health.amazonaws.com. 10 IN CNAME health.us-east-1.amazonaws.com
Tip

Endpoint aktif dan pasif mengembalikan AWS Health data. Namun, data terbaru AWS Health hanya tersedia dari titik akhir aktif. Data dari titik akhir pasif akhirnya akan konsisten dengan titik akhir aktif. Kami merekomendasikan Anda me-restart setiap alur kerja ketika titik akhir aktif berubah.