Integración AWS Health con otros sistemas mediante el AWS Health API - AWS Health

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.

Integración AWS Health con otros sistemas mediante el AWS Health API

AWS Health es un servicio RESTful web que se utiliza HTTPS como formato de transporte y JSON serialización de mensajes. El código de su aplicación puede realizar solicitudes directamente al AWS Health API. Cuando lo utilice REST API directamente, deberá 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, consulte la AWS Health APIReferencia.

nota

Debe tener un plan Business, Enterprise On-Ramp o Enterprise Support desde AWS Supportpara poder utilizar el AWS Health API. Si llamas AWS Health API desde una AWS cuenta que no tiene un plan Business, Enterprise On-Ramp o Enterprise Support, recibirás un SubscriptionRequiredException mensaje de error.

Puede usarlo AWS SDKs para cerrar las AWS Health REST API llamadas, lo que puede simplificar el desarrollo de su 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.

Firmar AWS Health API solicitudes

Al utilizar AWS SDKs o AWS Command Line Interface (AWS CLI) para realizar solicitudes AWS, estas herramientas firman automáticamente las solicitudes por usted con la clave de acceso que especifique 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 utilizarlos 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 ellas AWS Health. Puedes usar las credenciales de un IAM usuario. 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 IAM usuario.

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 AWS API solicitudes en Referencia general de AWS.

Elegir puntos finales para las solicitudes AWS Health API

La AWS Health API siguiente es una arquitectura de aplicaciones multirregional, una arquitectura de y tiene dos puntos finales regionales en una configuración activo-pasiva. Para admitir la DNS conmutación por error activo-pasiva, proporciona un único punto final global. AWS Health Puede realizar una DNS búsqueda 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 AWS Health API solicitudes.

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

nota

Esta 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 DNS búsqueda en el punto final global yCNAME, a continuación, extraiga la AWS región del nombre resuelto.

ejemplo : DNS buscar en el punto final global

A continuación, el devuelve el punto de conexión de la región us-east-1. Este resultado le indica el punto final para el que debe utilizar. 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.