Integración de AWS Health con otros sistemas mediante la API de AWS Health
AWS Health es un servicio web RESTful que usa HTTPS como transporte y JSON como formato de serialización de mensajes. Su código de aplicación puede realizar solicitudes directamente a la API de AWS Health. Cuando utiliza directamente la API de REST, es necesario escribir el código necesario para firmar y autenticar sus solicitudes. Para obtener más información sobre las operaciones y parámetros de AWS Health, consulte la referencia de la API de AWS Health.
nota
Para poder usar la API de AWS Health, debe contar con un plan de soporte Business, Enterprise On-Ramp o Enterprise de AWS SupportSubscriptionRequiredException.
Puede utilizar los SDK de AWS para contener las llamadas a la AWS Health API de REST, que puede simplificar el desarrollo de su aplicación. Una vez que especifique sus credenciales de AWS, estas bibliotecas se encargarán de la autenticación y la firma de solicitudes en su nombre.
AWS Health también proporciona un panel de control de AWS Health en la AWS Management Console que puede utilizar para ver y buscar eventos y entidades afectadas. Consulte Introducción al Panel de AWS Health.
Temas
Firma de solicitudes API de AWS Health
Cuando utiliza los SDK de AWS o la AWS Command Line Interface (AWS CLI) para realizar solicitudes a AWS, estas herramientas firman automáticamente en su nombre las solicitudes con la clave de acceso especificada al configurar las herramientas. Por ejemplo, si usa el AWS SDK for Java para la demostración anterior de puntos de conexión de alta disponibilidad, no tiene que firmar las solicitudes personalmente.
Ejemplos de código Java
Para ver más ejemplos sobre cómo usar la API de AWS Health con el AWS SDK for Java, consulte este código de ejemplo.
Cuando realice solicitudes, se desaconseja encarecidamente que utilice las credenciales de la cuenta raíz de AWS para obtener acceso a AWS Health normalmente. Puede utilizar las credenciales de un usuario de IAM. Para obtener más información, consulte Lock Away Your AWS Account Root User Access Keys de su cuenta en la Guía del usuario de IAM.
Si no utiliza los SDK de AWS o la AWS CLI, debe firmar usted mismo las solicitudes. Le recomendamos utilizar la versión de firma 4 de AWS. Para obtener más información, consulte Firma de solicitudes de la API de AWS en la Referencia general de AWS.
Selección de puntos de conexión para solicitudes de la API de AWS Health
La API de AWS Health utiliza Multi-Region Application Architecture y tiene dos puntos de conexión regionales en una configuración activa-pasiva. Para admitir la conmutación por error de DNS activa-pasiva, AWS Health proporciona un único punto de conexión global. Puede realizar una búsqueda de DNS en el punto de conexión global para determinar el punto de conexión activo y la región AWS de firma correspondiente. Esto le ayuda a saber qué punto de conexión debe utilizar en su código, de modo que pueda obtener la información más reciente de AWS Health.
Al realizar una solicitud al punto de conexión global, debe especificar sus credenciales de acceso de AWS al punto de conexión regional al que se dirige y configurar la firma para su región. De lo contrario, es posible que se produzca un error en la autenticación. Para obtener más información, consulte Firma de solicitudes API de AWS Health.
En la siguiente tabla, se representa la configuración por defecto.
| Descripción | Región de firma | Punto de conexión | Protocolo |
|---|---|---|---|
| Activo |
us-east-1 |
health.us-east-1.amazonaws.com |
HTTPS |
| Pasivo |
us-east-2 |
health.us-east-2.amazonaws.com |
HTTPS |
| Global |
us-east-1 notaEsta es la región de firma del punto de conexión activo actual. |
global.health.amazonaws.com |
HTTPS |
Para determinar si un punto de conexión es el punto de conexión activo, realice una búsqueda de DNS en el CNAME del punto de conexión global y, a continuación, extraiga la región de AWS del nombre resuelto.
ejemplo : búsqueda de DNS en el punto de conexión global
El siguiente comando completa una búsqueda de DNS en el punto de conexión global.health.amazonaws.com A continuación, el devuelve el punto de conexión de la región us-east-1. Este resultado le indica qué punto de conexión debe utilizarse para AWS Health.
dig global.health.amazonaws.com | grep CNAMEglobal.health.amazonaws.com. 10 IN CNAME health.us-east-1.amazonaws.com
sugerencia
Tanto los puntos de conexión activos como los pasivos devuelven datos de AWS Health. Sin embargo, los datos de AWS Health más recientes solo están disponibles en el punto de conexión activo. Los datos del punto de conexión pasivo serán coherentes con el punto de conexión activo. Le recomendamos que reinicie todos los flujos de trabajo cuando cambie el punto de conexión activo.
