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á.
Integração AWS Health com outros sistemas usando o AWS Health API
AWS Health é um serviço RESTful web usado HTTPS como transporte e JSON formato de serialização de mensagens. O código do seu aplicativo pode fazer solicitações diretamente para AWS Health API o. Ao usar o REST API diretamente, você deve escrever 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 AWS Health APIReferência.
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 AWS Health REST API chamadas, 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
AWS Health APISolicitações de assinatura
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 for 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 obter mais exemplos de como usar o AWS Health API com o AWS SDK for 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 IAM usuário. Para obter mais informações, consulte Bloquear as chaves de acesso do usuário raiz da sua AWS conta no Guia IAM do usuário.
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 Assinar AWS API solicitações no Referência geral da AWS.
Escolha de endpoints para solicitações AWS Health API
A AWS Health API seguir, uma arquitetura de aplicativo multirregional Arquitetura de e tem dois endpoints regionais em uma configuração ativa-passiva. Para suportar o DNS failover ativo-passivo, AWS Health fornece um endpoint único e global. Você pode realizar uma DNS pesquisa no endpoint global para determinar o endpoint ativo e a região de assinatura AWS correspondente. 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 AWS Health APISolicitações de assinatura.
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 |
HTTPS |
Passivo |
us-east-2 |
health.us-east-2.amazonaws.com |
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 DNS pesquisa no endpoint global eCNAME, em seguida, extraia a AWS região do nome resolvido.
exemplo : DNS pesquisa 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.