Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mengintegrasikan AWS Health dengan sistem lain yang menggunakan AWS Health API
AWS Health adalah layanan web RESTful yang menggunakan HTTPS sebagai transportasi dan JSON sebagai format serialisasi pesan. Kode aplikasi Anda dapat membuat permintaan langsung ke API AWS Health . Bila Anda langsung menggunakan API REST, Anda harus menulis kode yang diperlukan untuk menandatangani dan autentikasi permintaan Anda. Untuk informasi selengkapnya tentang AWS Health operasi dan parameter, lihat Referensi AWS Health API.
catatan
Anda harus memiliki paket AWS Business Support+, AWS Enterprise Support, atau AWS Unified Operations AWS DukunganSubscriptionRequiredException kesalahan.
Anda dapat menggunakan AWS SDK untuk membungkus panggilan AWS Health REST API, 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 Konsol Manajemen AWS yang dapat Anda gunakan untuk melihat dan mencari peristiwa dan entitas yang terpengaruh. Lihat Memulai dengan Anda AWS Health Dasbor.
Topik
Penandatanganan AWS Health Permintaan API
Saat Anda menggunakan AWS SDK 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 untuk Java
Contoh kode Java
Untuk contoh selengkapnya tentang cara menggunakan AWS Health API dengan AWS SDK untuk Java, lihat contoh kode 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 kredensial untuk membuat pengguna IAM. Untuk informasi selengkapnya, lihat Mengunci Kunci Akses Pengguna Root AWS Akun Anda di Panduan Pengguna IAM.
Jika Anda tidak menggunakan SDK atau AWS SDK AWS CLI, maka Anda harus menandatangani permintaan Anda sendiri. Kami menyarankan Anda menggunakan AWS Signature Version 4. Untuk informasi selengkapnya, lihat Menandatangani Permintaan AWS API di bagian Referensi Umum AWS.
Memilih titik akhir untuk AWS Health Permintaan API
AWS Health API mengikuti arsitektur aplikasi Multi-region Arsitektur aplikasi dan memiliki dua titik akhir regional dalam konfigurasi aktif-pasif. Untuk mendukung failover DNS aktif-pasif, AWS Health menyediakan titik akhir tunggal, global. Anda dapat melakukan pencarian DNS di 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 Penandatanganan AWS Health Permintaan API.
Untuk IPv6-only permintaan, sebaiknya lakukan pencarian DNS di titik akhir global untuk menentukan aktif Wilayah AWS dan kemudian memanggil titik akhir dual-stack yang didukung IPv6 untuk Wilayah tersebut.
Tabel berikut menggambarkan konfigurasi default.
| Deskripsi | Penandatanganan Wilayah | Titik akhir | Protokol |
|---|---|---|---|
| Aktif |
us-east-1 |
health.us-east-1.amazonaws.com (IPv4-only) health.us-east-1.api.aws (IPv4 dan IPv6 didukung) |
HTTPS |
| Pasif |
us-east-2 |
health.us-east-2.amazonaws.com (IPv4-only) health.us-east-2.api.aws (didukung IPv4 dan IPv6) |
HTTPS |
| Global |
us-east-1 catatanIni adalah Wilayah penandatanganan titik akhir aktif saat ini. |
global.health.amazonaws.com |
HTTPS |
Untuk menentukan apakah titik akhir adalah titik akhir aktif, lakukan pencarian DNS pada CNAME titik akhir global, lalu ekstrak Wilayah dari nama yang AWS diselesaikan.
contoh: Pencarian DNS pada titik akhir global
Perintah berikut melengkapi pencarian DNS pada titik akhir global.health.amazonaws.com. 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 CNAMEglobal.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.