Per funzionalità simili a Amazon Timestream for, prendi in considerazione Amazon Timestream LiveAnalytics per InfluxDB. Offre un'acquisizione semplificata dei dati e tempi di risposta alle query di una sola cifra di millisecondi per analisi in tempo reale. [Scopri](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html) di più qui.

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à.

# Utilizzo dell’API
<a name="Using.API"></a>

 Oltre a [SDKs](getting-started-sdks.md), Amazon Timestream LiveAnalytics for fornisce l'accesso diretto all'API REST tramite il pattern di rilevamento *degli* endpoint. Il modello di rilevamento degli endpoint è descritto di seguito, insieme ai relativi casi d'uso. 

## Il modello di scoperta degli endpoint
<a name="Using-API.endpoint-discovery"></a>

Poiché Timestream Live Analytics è SDKs progettato per funzionare in modo trasparente con l'architettura del servizio, inclusa la gestione e la mappatura degli endpoint del servizio, si consiglia di utilizzarlo per la maggior parte delle applicazioni. SDKs Tuttavia, ci sono alcuni casi in cui è necessario utilizzare il modello di rilevamento degli endpoint dell'API Timestream for LiveAnalytics REST: 
+ Stai utilizzando [endpoint VPC (AWS PrivateLink)](VPCEndpoints.md) con Timestream per LiveAnalytics
+ L'applicazione utilizza un linguaggio di programmazione che non supporta ancora l'SDK
+ È necessario un controllo migliore sull'implementazione lato client

Questa sezione include informazioni su come funziona il pattern di rilevamento degli endpoint, su come implementarlo e note sull'utilizzo. Seleziona uno degli argomenti seguenti per saperne di più. 

**Topics**
+ [

## Il modello di scoperta degli endpoint
](#Using-API.endpoint-discovery)
+ [

# Come funziona il modello di scoperta degli endpoint
](Using-API.endpoint-discovery.how-it-works.md)
+ [

# Implementazione del modello di rilevamento degli endpoint
](Using-API.endpoint-discovery.describe-endpoints.implementation.md)

# Come funziona il modello di scoperta degli endpoint
<a name="Using-API.endpoint-discovery.how-it-works"></a>

 Timestream è costruito utilizzando un'[architettura cellulare](architecture.md#cells) per garantire una migliore scalabilità e proprietà di isolamento del traffico. Poiché ogni account cliente è mappato su una cella specifica in una regione, l'applicazione deve utilizzare gli endpoint corretti specifici della cella a cui è stato mappato l'account. Quando si utilizza SDKs, questa mappatura viene gestita in modo trasparente e non è necessario gestire gli endpoint specifici della cella. Tuttavia, quando accedi direttamente all'API REST, dovrai gestire e mappare personalmente gli endpoint corretti. Questo processo, il *modello di rilevamento degli endpoint*, è descritto di seguito: 

1.  Il pattern di rilevamento degli endpoint inizia con una chiamata all'`DescribeEndpoints`azione (descritta nella [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html)sezione). 

1.  L'endpoint deve essere memorizzato nella cache e riutilizzato per il periodo di tempo specificato dal valore time-to-live (TTL) restituito (the). [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html#timestream-Type-Endpoint-CachePeriodInMinutes.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html#timestream-Type-Endpoint-CachePeriodInMinutes.html) Le chiamate all'API Timestream Live Analytics possono quindi essere effettuate per la durata del TTL. 

1.  Dopo la scadenza del TTL, è necessario effettuare una nuova chiamata a per DescribeEndpoints aggiornare l'endpoint (in altre parole, ricominciare dalla Fase 1). 

**Nota**  
 [La sintassi, i parametri e altre informazioni sull'utilizzo dell'`DescribeEndpoints`azione sono descritte nell'API Reference.](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html) Tieni presente che l'`DescribeEndpoints`azione è disponibile tramite entrambi SDKs ed è identica per ciascuno. 

Per l'implementazione del modello di rilevamento degli endpoint, vedere[Implementazione del modello di rilevamento degli endpoint](Using-API.endpoint-discovery.describe-endpoints.implementation.md).

# Implementazione del modello di rilevamento degli endpoint
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation"></a>

 Per implementare il modello di rilevamento degli endpoint, scegli un'API (Write o Query), crea una **DescribeEndpoints**richiesta e utilizza gli endpoint restituiti per la durata dei valori TTL restituiti. La procedura di implementazione è descritta di seguito. 

**Nota**  
Assicurati di avere familiarità con le [note sull'utilizzo](#Using-API.endpoint-discovery.describe-endpoints.usage-notes).

## Procedura di implementazione
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation.procedure"></a>

1.  Acquisisci l'endpoint per l'API verso cui desideri effettuare chiamate ([Write](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) o [Query](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)). utilizzando la richiesta. [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html) 

   1.  Crea una richiesta [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html)corrispondente all'API di interesse ([Write](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) o [Query](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)) utilizzando uno dei due endpoint descritti di seguito. Non ci sono parametri di input per la richiesta. Assicurati di leggere le note riportate di seguito.   
*Scrivi SDK:*  

      ```
      ingest.timestream.<region>.amazonaws.com
      ```  
*SDK di interrogazione:*  

      ```
      query.timestream.<region>.amazonaws.com
      ```

      Segue un esempio di chiamata CLI per la regione. `us-east-1`

      ```
      REGION_ENDPOINT="https://query.timestream.us-east-1.amazonaws.com"
      REGION=us-east-1
      aws timestream-write describe-endpoints \
      --endpoint-url $REGION_ENDPOINT \
      --region $REGION
      ```
**Nota**  
 L'intestazione HTTP «Host» *deve* contenere anche l'endpoint dell'API. La richiesta avrà esito negativo se l'intestazione non è compilata. Questo è un requisito standard per tutte le richieste HTTP/1.1. Se utilizzi una libreria HTTP che supporta 1.1 o versioni successive, la libreria HTTP dovrebbe compilare automaticamente l'intestazione per te.
**Nota**  
*<region>*Sostituiscila con l'identificatore di regione la regione in cui viene effettuata la richiesta, ad es. `us-east-1`

   1. Analizza la risposta per estrarre gli endpoint e memorizza nella cache i valori TTL. [La risposta è una matrice di uno o più oggetti. `Endpoint`](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html) Ogni `Endpoint` oggetto contiene un indirizzo endpoint (`Address`) e il TTL per quell'endpoint (). `CachePeriodInMinutes` 

1.  Memorizza l'endpoint nella cache fino al TTL specificato. 

1.  Quando il TTL scade, recupera un nuovo endpoint ricominciando dalla fase 1 dell'implementazione. 

## Note d'uso per il pattern di rilevamento degli endpoint
<a name="Using-API.endpoint-discovery.describe-endpoints.usage-notes"></a>
+ L'**DescribeEndpoints**azione è l'unica azione riconosciuta dagli endpoint regionali di Timestream Live Analytics. 
+ La risposta contiene un elenco di endpoint contro cui effettuare chiamate all'API Timestream Live Analytics. 
+  In caso di risposta corretta, dovrebbe esserci almeno un endpoint nell'elenco. Se nell'elenco è presente più di un endpoint, ognuno di essi è ugualmente utilizzabile per le chiamate API e il chiamante può scegliere l'endpoint da utilizzare a caso. 
+ Oltre all'indirizzo DNS dell'endpoint, ogni endpoint nell'elenco specificherà un time to live (TTL) consentito per l'utilizzo dell'endpoint specificato in minuti.
+ L'endpoint deve essere memorizzato nella cache e riutilizzato per il periodo di tempo specificato dal valore TTL restituito (in minuti). Dopo la scadenza del TTL, è **DescribeEndpoints**necessario effettuare una nuova chiamata per aggiornare l'endpoint da utilizzare, poiché l'endpoint non funzionerà più dopo la scadenza del TTL.