Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Integration AWS Health mit anderen Systemen mithilfe der AWS Health API
AWS Health ist ein RESTful Webdienst, der HTTPS als Transport und JSON als Nachrichtenserialisierungsformat verwendet. Ihr Anwendungscode kann Anfragen direkt an die AWS Health -API stellen. Wenn Sie die REST-API direkt verwenden, müssen Sie den erforderlichen Code schreiben, um Ihre Anfragen zu signieren und zu authentifizieren. Weitere Informationen zu den AWS Health Vorgängen und Parametern finden Sie in der AWS Health API-Referenz.
Anmerkung
Sie müssen über einen Business-, Enterprise On-Ramp- oder Enterprise Support-Plan von verfügen, AWS SupportSubscriptionRequiredException Fehlermeldung.
Sie können den verwenden AWS SDKs , um die AWS Health REST-API-Aufrufe zu umschließen, was Ihre Anwendungsentwicklung vereinfachen kann. Sie geben Ihre AWS Anmeldeinformationen an, und diese Bibliotheken kümmern sich für Sie um die Authentifizierung und das Signieren von Anfragen.
AWS Health bietet auch ein AWS Health Dashboard AWS Management Console , mit dem Sie Ereignisse und betroffene Entitäten anzeigen und danach suchen können. Siehe Erste Schritte mit deinem AWS Health Dashboard.
Themen
AWS Health API-Anfragen signieren
Wenn Sie das AWS SDKs oder das AWS Command Line Interface (AWS CLI) verwenden, um Anfragen an zu stellen AWS, signieren diese Tools die Anfragen automatisch für Sie mit dem Zugriffsschlüssel, den Sie bei der Konfiguration der Tools angeben. Wenn Sie beispielsweise die Demoversion AWS SDK for Java für den vorherigen Endpunkt mit hoher Verfügbarkeit verwenden, müssen Sie Anfragen nicht selbst signieren.
Java-Codebeispiele
Weitere Beispiele zur Verwendung der AWS Health API mit dem AWS SDK for Java finden Sie in diesem Beispielcode.
Wenn Sie Anfragen stellen, empfehlen wir Ihnen dringend, Ihre AWS Root-Kontoanmeldeinformationen nicht für den regulären Zugriff auf zu verwenden AWS Health. Sie können die Anmeldeinformationen eines IAM-Benutzers nutzen. Weitere Informationen finden Sie unter Sperren der Root-Benutzerzugriffsschlüssel für Ihr AWS Konto im IAM-Benutzerhandbuch.
Wenn Sie das AWS SDKs oder das nicht verwenden AWS CLI, müssen Sie Ihre Anfragen selbst signieren. Wir empfehlen Ihnen, AWS Signature Version 4 zu verwenden. Weitere Informationen finden Sie unter Signieren von AWS API-Anfragen im Allgemeine AWS-Referenz.
Endpunkte für AWS Health API-Anfragen auswählen
Die AWS Health API folgt einer Anwendungsarchitektur mit mehreren Regionen und verfügt über zwei regionale Endpunkte in einer Konfiguration. Bietet einen einzigen, globalen Endpunkt zur Unterstützung von aktiv-passivem DNS-Failover. AWS Health Sie können eine DNS-Suche auf dem globalen Endpunkt durchführen, um den aktiven Endpunkt und die entsprechende Signaturregion zu ermitteln. AWS Auf diese Weise wissen Sie, welchen Endpunkt Sie in Ihrem Code verwenden müssen, sodass Sie die neuesten Informationen abrufen können AWS Health.
Wenn Sie eine Anfrage an den globalen Endpunkt stellen, müssen Sie Ihre AWS Zugangsdaten für den regionalen Endpunkt angeben, auf den Sie abzielen, und die Signatur für Ihre Region konfigurieren. Andernfalls schlägt Ihre Authentifizierung möglicherweise fehl. Weitere Informationen finden Sie unter AWS Health API-Anfragen signieren.
Für IPv6 reine Anfragen empfehlen wir, eine DNS-Suche auf dem globalen Endpunkt durchzuführen, um den aktiven Endpunkt zu ermitteln, AWS-Region und dann den IPv6 unterstützten Dual-Stack-Endpunkt für diese Region aufzurufen.
Die folgende Tabelle stellt die Standardkonfiguration dar.
| Beschreibung | Region für die Signierung | Endpunkt | Protokoll |
|---|---|---|---|
| Aktiv |
us-east-1 |
health.us-east-1.amazonaws.com (IPv4nur) health.us-east-1.api.aws (und unterstützt) IPv4 IPv6 |
HTTPS |
| Passiv |
us-east-2 |
health.us-east-2.amazonaws.com (IPv4nur) health.us-east-2.api.aws (und unterstützt) IPv4 IPv6 |
HTTPS |
| Global |
us-east-1 AnmerkungDies ist die Signaturregion des aktuellen aktiven Endpunkts. |
global.health.amazonaws.com |
HTTPS |
Um festzustellen, ob ein Endpunkt der aktive Endpunkt ist, führen Sie eine DNS-Suche auf dem globalen Endpunkt CNAME durch und extrahieren Sie dann die Region aus dem aufgelösten Namen. AWS
Beispiel : DNS-Suche auf dem globalen Endpunkt
Der Befehl gibt dann den Endpunkt us-east-1 cn-northwest-1 zurück. In dieser Ausgabe erfahren Sie, für welchen Endpunkt Sie ihn verwenden sollten. AWS Health
dig global.health.amazonaws.com | grep CNAMEglobal.health.amazonaws.com. 10 IN CNAME health.us-east-1.amazonaws.com
Tipp
Sowohl der aktive als auch der passive Endpunkt geben AWS Health Daten zurück. Die neuesten AWS Health Daten sind jedoch nur vom aktiven Endpunkt aus verfügbar. Die Daten vom passiven Endpunkt werden irgendwann mit denen des aktiven Endpunkts übereinstimmen. Wir empfehlen, dass Sie alle Workflows neu starten, wenn sich der aktive Endpunkt ändert.
