Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
AWS Health è un servizio RESTful Web che utilizza HTTPS come trasporto e JSON come formato di serializzazione dei messaggi. Il codice dell'applicazione può effettuare richieste direttamente all'API di AWS Health . Quando utilizzi direttamente l'API REST, devi scrivere il codice necessario per firmare e autenticare le tue richieste. Per ulteriori informazioni sulle AWS Health operazioni e sui parametri, consulta l'AWS Health API Reference.
Nota
È necessario disporre di un piano Business, Enterprise On-Ramp o Enterprise Support Supporto AWSSubscriptionRequiredException errore.
Puoi utilizzare il AWS SDKs per eseguire il wrapping delle chiamate API AWS Health REST, il che può semplificare lo sviluppo delle applicazioni. Specificate AWS le vostre credenziali e queste librerie si occuperanno dell'autenticazione e della richiesta di firma per voi.
AWS Health fornisce inoltre una AWS Health dashboard AWS Management Console che è possibile utilizzare per visualizzare e cercare eventi ed entità interessate. Per informazioni, consulta Guida introduttiva alla AWS Health dashboard.
Argomenti
Firma AWS Health delle richieste API
Quando utilizzi AWS SDKs o the AWS Command Line Interface (AWS CLI) per effettuare richieste a AWS, questi strumenti firmano automaticamente le richieste per te con la chiave di accesso specificata al momento della configurazione degli strumenti. Ad esempio, se utilizzate la AWS SDK per Java precedente demo dell'endpoint ad alta disponibilità, non è necessario firmare personalmente le richieste.
Esempi di codice Java
Per altri esempi su come utilizzare l' AWS Health API con AWS SDK per Java, consulta questo codice di esempio.
Quando effettui richieste, ti consigliamo vivamente di non utilizzare le credenziali del tuo account AWS root per l'accesso regolare a AWS Health. Puoi utilizzare le credenziali di un utente IAM. Per ulteriori informazioni, consulta Lock Away Your AWS Account Root User Account nella Guida per l'utente IAM.
Se non usi il AWS SDKs o il AWS CLI, devi firmare tu stesso le tue richieste. Ti consigliamo di utilizzare la versione 4 di AWS Signature. Per ulteriori informazioni, consulta Signing AWS API Requests in Riferimenti generali di AWS.
Scelta degli endpoint per le richieste AWS Health API
L' AWS Health API segue un'architettura applicativa multiregionale Architettura applicativa e dispone di due endpoint regionali in una configurazione attiva-passiva. Per supportare il failover DNS attivo-passivo, fornisce un unico endpoint globale. AWS Health È possibile eseguire una ricerca DNS sull'endpoint globale per determinare l'endpoint attivo e la regione di firma corrispondente. AWS In questo modo è possibile sapere quale endpoint utilizzare nel codice, in modo da ottenere le informazioni più recenti. AWS Health
Quando effettui una richiesta all'endpoint globale, devi specificare le tue credenziali di AWS accesso all'endpoint regionale a cui desideri rivolgerti e configurare la firma per la tua regione. In caso contrario, l'autenticazione potrebbe fallire. Per ulteriori informazioni, consulta Firma AWS Health delle richieste API.
Per le IPv6 sole richieste, consigliamo di eseguire una ricerca DNS sull'endpoint globale per determinare l'endpoint attivo Regione AWS e quindi di chiamare l'endpoint dual-stack IPv6 supportato per quella regione.
La tabella seguente rappresenta la configurazione predefinita.
| Descrizione | Regione di firma | Endpoint | Protocollo |
|---|---|---|---|
| Attivo |
us-east-1 |
health.us-east-1.amazonaws.com (IPv4solo -) health.us-east-1.api.aws (e supportato) IPv4 IPv6 |
HTTPS |
| Passivo |
us-east-2 |
health.us-east-2.amazonaws.com (IPv4solo) health.us-east-2.api.aws (e supportato) IPv4 IPv6 |
HTTPS |
| Globale |
us-east-1 NotaQuesta è la regione di firma dell'endpoint attualmente attivo. |
global.health.amazonaws.com |
HTTPS |
Per determinare se un endpoint è l'endpoint attivo, esegui una ricerca DNS sull'endpoint globale CNAME, quindi estrai la regione dal nome risolto. AWS
Esempio : ricerca DNS sull'endpoint globale
Il comando restituisce quindi l'endpoint Region. Questo output indica per quale endpoint utilizzare. AWS Health
dig global.health.amazonaws.com | grep CNAMEglobal.health.amazonaws.com. 10 IN CNAME health.us-east-1.amazonaws.com
Suggerimento
Sia gli endpoint attivi che quelli passivi restituiscono AWS Health dati. Tuttavia, i AWS Health dati più recenti sono disponibili solo dall'endpoint attivo. I dati dell'endpoint passivo saranno alla fine coerenti con l'endpoint attivo. Ti consigliamo di riavviare qualsiasi flusso di lavoro quando l'endpoint attivo cambia.
