AWS Health API를 사용하여 AWS Health 다른 시스템과 통합

AWS Health 는 HTTPS를 전송으로 사용하고 JSON을 메시지 직렬화 형식으로 사용하는 RESTful 웹 서비스입니다. 애플리케이션 코드는 AWS Health API로 직접 요청할 수 있습니다. REST API를 직접 사용하는 경우 요청에 서명하고 이를 인증하기 위해 필요한 코드를 작성해야 합니다. AWS Health 작업 및 파라미터에 대한 자세한 내용은 AWS Health API 참조를 참조하세요.

AWS SDKs를 사용하여 AWS Health REST API 호출을 래핑할 수 있으므로 애플리케이션 개발을 간소화할 수 있습니다. 자격 AWS 증명을 지정하면 이러한 라이브러리가 인증 및 요청 서명을 처리합니다.

AWS Health 또한는 이벤트 및 영향을 받는 개체를 보고 검색하는 데 사용할 수 AWS Management Console 있는 AWS Health 대시보드를에 제공합니다. AWS Health 대시보드 시작하기을 참조하세요.

AWS Health API 요청 서명

AWS SDKs 또는 AWS Command Line Interface (AWS CLI)를 사용하여에 요청할 때 AWS이러한 도구는 도구를 구성할 때 지정한 액세스 키로 요청에 자동으로 서명합니다. 예를 들어 이전 고가용성 엔드포인트 데모에 AWS SDK for Java 를 사용하는 경우 직접 요청에 서명할 필요가 없습니다.

Java 코드 예

에서 AWS Health API를 사용하는 방법에 대한 자세한 예는이 예제 코드를 AWS SDK for Java참조하세요.

요청을 할 때는 정기적으로 액세스하기 위해 AWS 루트 계정 자격 증명을 사용하지 않는 것이 좋습니다 AWS Health. 그 대신 IAM 사용자의 자격 증명을 사용하면 됩니다. 자세한 내용은 IAM 사용 설명서의 AWS 계정 루트 사용자 액세스 키 잠금을 참조하세요.

AWS SDKs 또는를 사용하지 않는 경우 직접 요청에 서명해야 AWS CLI합니다. AWS 서명 버전 4를 사용하는 것이 좋습니다. 자세한 내용은의 AWS API 요청 서명을 참조하세요AWS 일반 참조.

AWS Health API 요청에 대한 엔드포인트 선택

AWS Health API는 다중 리전 애플리케이션 아키텍처 를 따르며 액티브-패시브 구성에 두 개의 리전 엔드포인트가 있습니다. 액티브-패시브 DNS 장애 조치를 지원하기 위해 AWS Health 각 단일 글로벌 엔드포인트를 제공합니다. 글로벌 엔드포인트에서 DNS 조회를 수행하여 활성 엔드포인트와 해당 서명 AWS 리전을 확인할 수 있습니다. 이렇게 하면 코드에 사용할 엔드포인트를 알 수 있으므로 최신 정보를 얻을 수 있습니다 AWS Health.

글로벌 엔드포인트에 요청할 때 대상 리전 엔드포인트에 AWS 액세스 자격 증명을 지정하고 리전에 대한 서명을 구성해야 합니다. 그렇지 않으면 인증이 실패할 수 있습니다. 자세한 내용은 AWS Health API 요청 서명 단원을 참조하십시오.

IPv6-only 요청의 경우 전역 엔드포인트에서 DNS 조회를 수행하여 활성를 확인한 AWS 리전 다음 해당 리전에 대해 IPv6 지원 듀얼 스택 엔드포인트를 호출하는 것이 좋습니다.

다음 표는 기본 구성을 나타낸 것입니다.

엔드포인트가 활성 엔드포인트인지 확인하려면 글로벌 엔드포인트 CNAME에서 DNS 조회를 수행한 다음 확인된 이름에서 AWS 리전을 추출합니다.

dig global.health.amazonaws.com | grep CNAME
global.health.amazonaws.com. 10 IN CNAME health.us-east-1.amazonaws.com