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á.
AWS Health é um serviço RESTful web 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.
nota
Você deve ter um plano Business, Enterprise On-Ramp ou Enterprise Support da AWS SupportSubscriptionRequiredException mensagem de erro.
Você pode usar o 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 AWS Management Console que você pode usar para visualizar e pesquisar eventos e entidades afetadas. Consulte Conceitos básicos do painel do AWS Health.
Tópicos
Assinatura AWS Health de solicitações de API
Quando você usa o AWS 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.
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 no Guia do usuário do IAM.
Se você não usa o 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 no Referência geral da AWS.
Escolha de endpoints para solicitações de AWS Health 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 de solicitações de API.
Para solicitações IPv6 somente, 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 IPv6 compatível para aquela região.
A tabela a seguir representa a configuração padrão.
| Descrição | Região de assinatura | Endpoint | Protocolo |
|---|---|---|---|
| Ativo |
us-east-1 |
health.us-east-1.amazonaws.com (IPv4somente) health.us-east-1.api.aws (e suportado) IPv4 IPv6 |
HTTPS |
| Passivo |
us-east-2 |
health.us-east-2.amazonaws.com (IPv4somente) health.us-east-2.api.aws (e compatível) IPv4 IPv6 |
HTTPS |
| Global |
us-east-1 notaEssa é 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.
exemplo : 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 CNAMEglobal.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.
