Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Intégration AWS Health à d'autres systèmes à l'aide du AWS Health API
AWS Health est un service RESTful Web utilisé HTTPS comme format de transport et JSON de sérialisation des messages. Le code de votre application peut envoyer des demandes directement au AWS Health API. Lorsque vous l'utilisez REST API directement, vous devez écrire le code nécessaire pour signer et authentifier vos demandes. Pour plus d'informations sur les AWS Health opérations et les paramètres, consultez la AWS Health APIréférence.
Note
Vous devez disposer d'un plan Business, Enterprise On-Ramp ou Enterprise Support AWS SupportSubscriptionRequiredException message d'erreur.
Vous pouvez utiliser le AWS SDKs pour encapsuler les AWS Health REST API appels, ce qui peut simplifier le développement de votre application. Vous spécifiez vos AWS informations d'identification, et ces bibliothèques se chargent de l'authentification et de la signature des demandes pour vous.
AWS Health fournit également un AWS Health tableau de bord AWS Management Console que vous pouvez utiliser pour afficher et rechercher les événements et les entités concernées. Consultez Commencer à utiliser votre AWS Health tableau de bord.
Rubriques
AWS Health APIDemandes de signature
Lorsque vous utilisez le AWS SDKs ou le AWS Command Line Interface (AWS CLI) pour faire des demandes AWS, ces outils signent automatiquement les demandes à votre place avec la clé d'accès que vous spécifiez lors de la configuration des outils. Par exemple, si vous utilisez le AWS SDK for Java pour la démonstration précédente des terminaux à haute disponibilité, vous n'avez pas besoin de signer vous-même les demandes.
Exemples de code Java
Pour plus d'exemples sur la façon d'utiliser le AWS Health API with the AWS SDK for Java, consultez cet exemple de code.
Lorsque vous faites des demandes, nous vous recommandons vivement de ne pas utiliser les informations d'identification de votre compte AWS root pour accéder régulièrement à AWS Health. Vous pouvez utiliser les informations d'identification d'un IAM utilisateur. Pour plus d'informations, voir Verrouiller les clés d'accès utilisateur root de votre AWS compte dans le guide de IAM l'utilisateur.
Si vous n'utilisez pas le AWS SDKs ou le AWS CLI, vous devez signer vous-même vos demandes. Nous vous recommandons d'utiliser AWS la version 4 de Signature. Pour plus d'informations, consultez la section AWS API Demandes de signature dans le Références générales AWS.
Choix des points de terminaison pour les demandes AWS Health API
Elle AWS Health API suit une architecture d'application multirégionale Architecture d'application et possède deux points de terminaison régionaux dans une configuration active-passive. Pour prendre en charge le DNS basculement actif-passif, AWS Health fournit un point de terminaison global unique. Vous pouvez effectuer une DNS recherche sur le point de terminaison global pour déterminer le point de terminaison actif et AWS la région de signature correspondante. Cela vous permet de savoir quel point de terminaison utiliser dans votre code, afin que vous puissiez obtenir les informations les plus récentes AWS Health.
Lorsque vous envoyez une demande au point de terminaison mondial, vous devez spécifier vos informations d' AWS accès au point de terminaison régional que vous ciblez et configurer la signature pour votre région. Dans le cas contraire, votre authentification risque d'échouer. Pour de plus amples informations, veuillez consulter AWS Health APIDemandes de signature.
Le tableau suivant représente la configuration par défaut.
| Description | Région de signature | Point de terminaison | Protocole |
|---|---|---|---|
| Actif |
us-east-1 |
health.us-east-1.amazonaws.com |
HTTPS |
| Passif |
us-east-2 |
health.us-east-2.amazonaws.com |
HTTPS |
| Globale |
us-east-1 NoteIl s'agit de la région de signature du point de terminaison actif actuel. |
global.health.amazonaws.com |
HTTPS |
Pour déterminer si un point de terminaison est le point de terminaison actif, effectuez une DNS recherche sur le point de terminaison globalCNAME, puis extrayez la AWS région du nom résolu.
Exemple : DNS recherche sur le point de terminaison global
La commande renvoie ensuite le point de terminaison de la région us-east-1 . Cette sortie vous indique pour quel point de terminaison vous devez utiliser AWS Health.
dig global.health.amazonaws.com | grep CNAMEglobal.health.amazonaws.com. 10 IN CNAME health.us-east-1.amazonaws.com
Astuce
Les points de terminaison actifs et passifs renvoient AWS Health des données. Cependant, les AWS Health données les plus récentes ne sont disponibles qu'à partir du point de terminaison actif. Les données du point de terminaison passif seront finalement cohérentes avec le point de terminaison actif. Nous vous recommandons de redémarrer tous les flux de travail lorsque le point de terminaison actif change.
