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.](https://docs.aws.amazon.com/health/latest/APIReference/)
**Anmerkung**
Sie müssen über einen AWS Business Support\+-, AWS Enterprise Support- oder AWS Unified Operations-Plan von verfügen, [AWS Support](https://aws.amazon.com/premiumsupport/)um die AWS Health API verwenden zu können. Wenn Sie in einem Unternehmen sind AWS-Region , das keinen dieser AWS Support Pläne anbietet, oder wenn Sie noch nicht auf einen dieser Pläne umgestiegen sind, können Sie die AWS Health API mit einem Business-, Enterprise On-Ramp- oder Enterprise Support-Plan verwenden. Wenn Sie die AWS Health API von einem Gerät aufrufen AWS-Konto , das nicht in einem dieser Pläne registriert ist, erhalten Sie eine Fehlermeldung. `SubscriptionRequiredException`
Sie können das 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-Managementkonsole , mit dem Sie Ereignisse und betroffene Entitäten anzeigen und danach suchen können. Siehe [Erste Schritte mit deinem AWS Health Dashboard](getting-started-health-dashboard.md).
**Topics**
+ [AWS Health API-Anfragen signieren](#signing)
+ [Endpunkte für AWS Health API-Anfragen auswählen](#endpoints)
+ [Demos: Programmgesteuertes Abrufen der AWS Health Ereignisdaten der letzten sieben Tage](using-global-endpoints-demo.md)
+ [Tutorial: Verwenden der AWS Health API mit Java-Beispielen](code-sample-java.md)
## 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 für 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 für Java finden Sie in diesem [Beispielcode](code-sample-java.md).
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](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials) 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](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) 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](#signing).
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.
****
| Description | Region der Signatur | Endpoint | Protocol (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 Dies 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
**Example : 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 CNAME
global.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.