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 Nachrichtenserialisierungsformat verwendet wird. Ihr Anwendungscode kann Anfragen direkt an die AWS Health API richten. Wenn Sie den 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 Operationen und Parametern finden Sie in der AWS Health APIReferenz.
Anmerkung
Sie müssen über einen Business-, Enterprise On-Ramp- oder Enterprise Support-Plan von verfügen, um den AWS Health API nutzen AWS SupportSubscriptionRequiredException Fehlermeldung.
Sie können den verwenden AWS SDKs, um die AWS Health REST API Anrufe zu beenden, 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
Signieren von AWS Health API-Anforderungen
Wenn Sie das AWS SDKs oder das AWS Command Line Interface (AWS CLI) verwenden, um Anfragen an zu richten 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 von AWS Health API mit dem AWS SDK for Java finden Sie in diesem Beispielcode.
Wenn Sie Anfragen stellen, empfehlen wir Ihnen dringend, die Anmeldeinformationen Ihres AWS Root-Kontos nicht für den regulären Zugriff auf zu verwenden AWS Health. Sie können die Anmeldeinformationen für einen IAM Benutzer verwenden. Weitere Informationen finden Sie im Benutzerhandbuch unter Sperren Sie die Root-Benutzerzugriffsschlüssel für Ihr AWS Konto. IAM
Wenn Sie das AWS SDKs oder das nicht verwenden AWS CLI, müssen Sie Ihre Anfragen selbst unterschreiben. 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
Sie 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 aktivem und 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 Signieren von AWS Health API-Anforderungen.
Die folgende Tabelle stellt die Standardkonfiguration dar.
| Beschreibung | Region der Signatur | Endpunkt | Protokoll |
|---|---|---|---|
| Aktiv |
us-east-1 |
health.us-east-1.amazonaws.com |
HTTPS |
| Passiv |
us-east-2 |
health.us-east-2.amazonaws.com |
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, DNS suchen Sie auf dem globalen Endpunkt nach und extrahieren Sie dann die Region aus dem CNAME 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.
