Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
AWS Health es un servicio RESTful web que utiliza 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 AWS Health operaciones y los parámetros, consulta la referencia de la AWS Health API.
nota
Para usar la AWS Health API, debe tener un plan Business, Enterprise On-Ramp o Enterprise Support. AWS SupportSubscriptionRequiredException
error.
Puedes usarlo AWS SDKs para empaquetar las llamadas a la API AWS Health REST, lo que puede simplificar el desarrollo de tu aplicación. Usted especifica sus AWS credenciales y estas bibliotecas se encargan de autenticar y firmar las solicitudes por usted.
AWS Health también incluye un AWS Health panel de control AWS Management Console que puede utilizar para ver y buscar eventos y entidades afectadas. Consulte Introducción al Panel de AWS Health.
Temas
Firmar solicitudes AWS Health de API
Cuando utilizas AWS SDKs o AWS Command Line Interface (AWS CLI) para realizar solicitudes AWS, estas herramientas firman automáticamente las solicitudes por ti con la clave de acceso que especifiques al configurar las herramientas. Por ejemplo, si las utiliza AWS SDK for Java para la anterior demostración de terminales de alta disponibilidad, no es necesario que firme las solicitudes usted mismo.
Ejemplos de código Java
Para ver más ejemplos sobre cómo usar la AWS Health API con AWS SDK for Java, consulta este código de ejemplo.
Cuando realices solicitudes, te recomendamos encarecidamente que no utilices las credenciales de tu cuenta AWS raíz para acceder habitualmente a ella AWS Health. Puede utilizar las credenciales de un usuario de IAM. Para obtener más información, consulte Bloquear las claves de acceso de los usuarios raíz de su AWS cuenta en la Guía del usuario de IAM.
Si no utiliza las AWS SDKs o las AWS CLI, debe firmar las solicitudes usted mismo. Le recomendamos que utilice la versión 4 de AWS Signature. Para obtener más información, consulte Firmar solicitudes de AWS API en Referencia general de AWS.
Elegir puntos de enlace para las solicitudes de AWS Health API
La AWS Health API sigue una arquitectura de aplicaciones multirregional, una arquitectura de y tiene dos puntos finales regionales en una configuración activo-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 final global para determinar el punto final activo y la región de firma correspondiente. AWS Esto le ayuda a saber qué punto final debe utilizar en su código, de modo que pueda obtener la información más reciente AWS Health.
Al realizar una solicitud al punto final global, debe especificar sus credenciales de AWS acceso al punto final 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 Firmar solicitudes AWS Health de API.
Para las solicitudes IPv6 exclusivas, te recomendamos realizar una búsqueda de DNS en el punto de conexión global para determinar el punto de conexión activo Región de AWS y, a continuación, llamar al punto de conexión de doble pila IPv6 compatible para esa región.
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 (solo) IPv4 health.us-east-1.api.aws (y compatibles) IPv4 IPv6 |
HTTPS |
Pasivo |
us-east-2 |
health.us-east-2.amazonaws.com (solo) IPv4 health.us-east-2.api.aws (y compatibles) IPv4 IPv6 |
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 final es el punto final activo, realice una búsqueda de DNS en el CNAME del punto final global y, a continuación, extraiga la región del nombre resuelto. AWS
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 indica para qué punto final debe utilizarse. AWS Health
dig global.health.amazonaws.com | grep CNAME
global.health.amazonaws.com. 10 IN CNAME health.us-east-1.amazonaws.com
sugerencia
Tanto los puntos finales activos como los pasivos devuelven AWS Health datos. 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.