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à.
Integrazione AWS Health con altri sistemi tramite AWS Health API
AWS Health è un servizio RESTful Web che utilizza HTTPS come formato di trasporto e JSON serializzazione dei messaggi. Il codice dell'applicazione può effettuare richieste direttamente a. AWS Health API Quando si utilizza REST API direttamente, è necessario scrivere il codice necessario per firmare e autenticare le richieste. Per ulteriori informazioni sulle AWS Health operazioni e sui parametri, consulta la Guida AWS Health APIdi riferimento.
Nota
È necessario disporre di un piano Business, Enterprise On-Ramp o Enterprise Support di Supporto AWSSubscriptionRequiredException
errore.
Puoi utilizzare il AWS SDKs per completare le AWS Health REST API chiamate, 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 delle richieste AWS Health API
Quando utilizzi AWS SDKs o the AWS Command Line Interface (AWS CLI) per effettuare richieste 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 for Java precedente demo dell'endpoint ad alta disponibilità, non è necessario firmare personalmente le richieste.
Esempi di codice Java
Per ulteriori esempi su come utilizzare AWS Health API with the AWS SDK for 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. È possibile utilizzare le credenziali di un IAM utente. Per ulteriori informazioni, consulta Lock Away Your AWS Account Root User Access Keys nella Guida per l'IAMutente.
Se non utilizzi 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, vedere AWS APIRichieste di firma in Riferimenti generali di AWS.
Scelta degli endpoint per le richieste AWS Health API
AWS Health APISegue un'architettura applicativa multiregionale Architettura applicativa con due endpoint regionali in una configurazione attiva-passiva. Per supportare il DNS failover attivo-passivo, fornisce un unico endpoint globale. AWS Health È possibile eseguire una DNS ricerca 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 delle richieste AWS Health API.
La tabella seguente rappresenta la configurazione predefinita.
Descrizione | Regione di firma | Endpoint | Protocollo |
---|---|---|---|
Attivo |
us-east-1 |
health.us-east-1.amazonaws.com |
HTTPS |
Passiva |
us-east-2 |
health.us-east-2.amazonaws.com |
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 DNS ricerca sull'endpoint globale, quindi estrai la regione dal nome risolto. CNAME AWS
Esempio : ricerca sull'endpoint globale DNS
Il comando restituisce quindi l'endpoint Region. Questo output indica per quale endpoint utilizzare. AWS Health
dig global.health.amazonaws.com | grep CNAME
global.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.