As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Integrar AWS Health com outros sistemas usando o AWS Health solicitações de
AWS Health é um serviço web RESTful que usa HTTPS como transporte e JSON como formato de serialização de mensagens. O código de seu aplicativo pode fazer solicitações diretamente à API do AWS Health . Quando usar a API REST diretamente, você deverá gravar o código necessário para assinar e autenticar suas solicitações. Para obter mais informações sobre as AWS Health operações e os parâmetros, consulte a [Referência AWS Health da API](https://docs.aws.amazon.com/health/latest/APIReference/).
**nota**
Você deve ter um plano AWS Business Support\+, AWS Enterprise Support ou AWS Unified Operations [AWS Support](https://aws.amazon.com/premiumsupport/)para usar a AWS Health API. Se você estiver em um plano Região da AWS que não ofereça um desses AWS Support planos ou se não tiver feito a transição para um desses planos, poderá usar a AWS Health API com um plano Business On-Ramp, Enterprise ou Enterprise Support. Se você chamar a AWS Health API de alguém Conta da AWS que não está inscrito em um desses planos, receberá uma `SubscriptionRequiredException` mensagem de erro.
Você pode usar os AWS SDKs para agrupar as chamadas da API AWS Health REST, o que pode simplificar o desenvolvimento do seu aplicativo. Você especifica suas AWS credenciais, e essas bibliotecas cuidam da autenticação e solicitam a assinatura para você.
AWS Health também fornece um AWS Health painel no Console de gerenciamento da AWS que você pode usar para visualizar e pesquisar eventos e entidades afetadas. Consulte [Começando com seu AWS Health Painel](getting-started-health-dashboard.md).
**Topics**
+ [Assinatura AWS Health Solicitações de API](#signing)
+ [Escolhendo endpoints para AWS Health Solicitações de API](#endpoints)
+ [Demonstrações: Recuperando os últimos sete dias de AWS Health dados de eventos de forma programática](using-global-endpoints-demo.md)
+ [Tutorial: Usando o AWS Health Exemplos de API com Java](code-sample-java.md)
## Assinatura AWS Health Solicitações de API
Quando você usa AWS os SDKs ou o AWS Command Line Interface (AWS CLI) para fazer solicitações AWS, essas ferramentas assinam automaticamente as solicitações para você com a chave de acesso que você especifica ao configurar as ferramentas. Por exemplo, se você usar o AWS SDK para Java para a demonstração anterior de endpoint de alta disponibilidade, não precisará assinar as solicitações sozinho.
**Exemplos de código Java**
Para ver mais exemplos de como usar a AWS Health API com o AWS SDK para Java, consulte este [código de exemplo](code-sample-java.md).
Ao fazer solicitações, é altamente recomendável que você não use as credenciais AWS da sua conta raiz para AWS Health acesso regular a. Você pode usar as credenciais de um usuário do IAM. Para obter mais informações, consulte [Bloquear as chaves de acesso do usuário raiz da sua AWS conta](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials) no *Guia do usuário do IAM*.
Se você não usa os AWS SDKs ou o AWS CLI, então você mesmo deve assinar suas solicitações. Recomendamos que você use o AWS Signature Version 4. Para obter mais informações, consulte [Assinatura de solicitações de AWS API](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) no *Referência geral da AWS*.
## Escolhendo endpoints para AWS Health Solicitações de API
A AWS Health API segue uma arquitetura de aplicativo multirregional Arquitetura de e tem dois endpoints regionais em uma configuração ativa-passiva. Para oferecer compatibilidade com o failover de DNS ativo-passivo, AWS Health fornece um endpoint único e global. Você pode realizar uma pesquisa de DNS no endpoint global para determinar o endpoint ativo e a região de assinatura correspondente. AWS Isso ajuda você a saber qual endpoint usar em seu código, para que você possa obter as informações mais recentes. AWS Health
Ao fazer uma solicitação ao endpoint global, você deve especificar suas credenciais de AWS acesso ao endpoint regional de destino e configurar a assinatura para sua região. Caso contrário, sua autenticação poderá falhar. Para obter mais informações, consulte [Assinatura AWS Health Solicitações de API](#signing).
Para IPv6-only solicitações, recomendamos realizar uma pesquisa de DNS no endpoint global para determinar o endpoint ativo Região da AWS e, em seguida, chamar o endpoint de pilha dupla compatível com IPv6 para aquela região.
A tabela a seguir representa a configuração padrão.
| Description | Região de assinatura | Endpoint | Protocolo |
| --- | --- | --- | --- |
| Ativo | us-east-1 | health.us-east-1.amazonaws.com (IPv4-only)
health.us-east-1.api.aws (compatível com IPv4 e IPv6) | HTTPS |
| Passivo | us-east-2 | health.us-east-2.amazonaws.com (IPv4-only)
health.us-east-2.api.aws (compatível com IPv4 e IPv6) | HTTPS |
| Global | us-east-1 Essa é a região de assinatura do endpoint ativo atual. | global.health.amazonaws.com | HTTPS |
Para determinar se um endpoint é o *endpoint ativo*, faça uma pesquisa de DNS no CNAME do *endpoint global* e, em seguida, extraia a AWS região do nome resolvido.
**Example : pesquisa de DNS no endpoint global**
. Em seguida, o comando retorna o endpoint Região us-east-1. Essa saída informa para qual endpoint você deve usar. AWS Health
```
dig global.health.amazonaws.com | grep CNAME
global.health.amazonaws.com. 10 IN CNAME health.us-east-1.amazonaws.com
```
**dica**
Tanto os endpoints ativos quanto os passivos retornam AWS Health dados. No entanto, os dados AWS Health mais recentes só estão disponíveis no endpoint ativo. Os dados do endpoint passivo acabarão sendo consistentes com o endpoint ativo. Recomendamos que você reinicie todos os fluxos de trabalho quando o endpoint ativo for alterado.