Pour des fonctionnalités similaires à celles d'Amazon Timestream pour, pensez à Amazon Timestream LiveAnalytics pour InfluxDB. Il permet une ingestion simplifiée des données et des temps de réponse aux requêtes à un chiffre en millisecondes pour des analyses en temps réel. Pour en savoir plus, [cliquez ici](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation de l’API
<a name="Using.API"></a>

 En outre [SDKs](getting-started-sdks.md), Amazon Timestream LiveAnalytics pour fournit un accès direct à l'API REST via le modèle de découverte *des* terminaux. Le modèle de découverte des terminaux est décrit ci-dessous, ainsi que ses cas d'utilisation. 

## Le modèle de découverte des terminaux
<a name="Using-API.endpoint-discovery"></a>

Les Timestream Live Analytics étant SDKs conçus pour fonctionner de manière transparente avec l'architecture du service, y compris la gestion et le mappage des points de terminaison du service, il est recommandé de les utiliser pour la SDKs plupart des applications. Cependant, dans certains cas, l'utilisation du modèle de découverte des points de terminaison de l' LiveAnalytics API Timestream for REST est nécessaire : 
+ Vous utilisez des [points de terminaison VPC (AWS PrivateLink)](VPCEndpoints.md) avec Timestream pour LiveAnalytics
+ Votre application utilise un langage de programmation qui n'est pas encore compatible avec le SDK
+ Vous avez besoin d'un meilleur contrôle de la mise en œuvre côté client

Cette section contient des informations sur le fonctionnement du modèle de découverte des points de terminaison, comment implémenter le modèle de découverte des points de terminaison, ainsi que des notes d'utilisation. Sélectionnez un sujet ci-dessous pour en savoir plus. 

**Topics**
+ [

## Le modèle de découverte des terminaux
](#Using-API.endpoint-discovery)
+ [

# Comment fonctionne le modèle de découverte des terminaux
](Using-API.endpoint-discovery.how-it-works.md)
+ [

# Implémentation du modèle de découverte des terminaux
](Using-API.endpoint-discovery.describe-endpoints.implementation.md)

# Comment fonctionne le modèle de découverte des terminaux
<a name="Using-API.endpoint-discovery.how-it-works"></a>

 Timestream est construit à l'aide d'une [architecture cellulaire](architecture.md#cells) pour garantir une meilleure évolutivité et des propriétés d'isolation du trafic. Chaque compte client étant mappé à une cellule spécifique d'une région, votre application doit utiliser les points de terminaison spécifiques à la cellule auxquels votre compte a été mappé. Lorsque vous utilisez le SDKs, ce mappage est géré de manière transparente pour vous et vous n'avez pas besoin de gérer les points de terminaison spécifiques aux cellules. Toutefois, lorsque vous accédez directement à l'API REST, vous devez gérer et mapper vous-même les points de terminaison appropriés. Ce processus, le *modèle de découverte des terminaux*, est décrit ci-dessous : 

1.  Le modèle de découverte des terminaux commence par un appel à l'`DescribeEndpoints`action (décrit dans la [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html)section). 

1.  Le point de terminaison doit être mis en cache et réutilisé pendant la durée spécifiée par la valeur time-to-live (TTL) renvoyée (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) Les appels à l'API Timestream Live Analytics peuvent ensuite être effectués pendant la durée du TTL. 

1.  Une fois le TTL expiré, un nouvel appel DescribeEndpoints doit être effectué pour actualiser le point de terminaison (en d'autres termes, recommencer à zéro à l'étape 1). 

**Note**  
 La syntaxe, les paramètres et les autres informations d'utilisation de l'`DescribeEndpoints`action sont décrits dans la [référence de l'API](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html). Notez que l'`DescribeEndpoints`action est disponible via les deux et qu' SDKselle est identique pour chacune d'entre elles. 

Pour la mise en œuvre du modèle de découverte des terminaux, voir[Implémentation du modèle de découverte des terminaux](Using-API.endpoint-discovery.describe-endpoints.implementation.md).

# Implémentation du modèle de découverte des terminaux
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation"></a>

 Pour implémenter le modèle de découverte des points de terminaison, choisissez une API (Write ou Query), créez une **DescribeEndpoints**demande et utilisez le ou les points de terminaison renvoyés pendant la durée des valeurs TTL renvoyées. La procédure de mise en œuvre est décrite ci-dessous. 

**Note**  
Assurez-vous de bien connaître les [notes d'utilisation](#Using-API.endpoint-discovery.describe-endpoints.usage-notes).

## Procédure de mise en œuvre
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation.procedure"></a>

1.  Obtenez le point de terminaison de l'API à laquelle vous souhaitez effectuer des appels ([Write](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) ou [Query](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)) à l'aide de la [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html)requête. 

   1.  Créez une demande correspondant à l'API [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html)qui vous intéresse ([Write](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) ou [Query](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)) en utilisant l'un des deux points de terminaison décrits ci-dessous. Il n'y a aucun paramètre d'entrée pour la demande. Assurez-vous de lire les notes ci-dessous.   
*Écrire le SDK :*  

      ```
      ingest.timestream.<region>.amazonaws.com
      ```  
*SDK de requêtes :*  

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

      Voici un exemple d'appel CLI pour une `us-east-1` région.

      ```
      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
      ```
**Note**  
 L'en-tête HTTP « Host » *doit* également contenir le point de terminaison de l'API. La demande échouera si l'en-tête n'est pas renseigné. Il s'agit d'une exigence standard pour toutes les requêtes HTTP/1.1. Si vous utilisez une bibliothèque HTTP compatible avec la version 1.1 ou ultérieure, la bibliothèque HTTP doit automatiquement remplir l'en-tête pour vous.
**Note**  
Remplacez *<region>* par l'identifiant de région pour la région dans laquelle la demande est faite, par ex. `us-east-1`

   1. Analysez la réponse pour extraire le ou les points de terminaison et mettez en cache les valeurs TTL. La réponse est un tableau d'un ou de plusieurs [`Endpoint`objets](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html). Chaque `Endpoint` objet contient une adresse de point de terminaison (`Address`) et le TTL pour ce point de terminaison (`CachePeriodInMinutes`). 

1.  Mettez en cache le point de terminaison jusqu'au TTL spécifié. 

1.  Lorsque le TTL expire, récupérez un nouveau point de terminaison en recommençant à l'étape 1 de l'implémentation. 

## Remarques d'utilisation pour le modèle de découverte des terminaux
<a name="Using-API.endpoint-discovery.describe-endpoints.usage-notes"></a>
+ Il s'agit de la seule action reconnue par les points de terminaison régionaux de Timestream Live Analytics. **DescribeEndpoints** 
+ La réponse contient une liste de points de terminaison auxquels effectuer des appels d'API Timestream Live Analytics. 
+  En cas de réponse satisfaisante, il doit y avoir au moins un point final dans la liste. S'il y a plusieurs points de terminaison dans la liste, chacun d'entre eux est également utilisable pour les appels d'API, et l'appelant peut choisir le point de terminaison à utiliser au hasard. 
+ Outre l'adresse DNS du point de terminaison, chaque point de terminaison de la liste spécifiera une durée de vie (TTL) autorisée pour utiliser le point de terminaison spécifié en minutes.
+ Le point de terminaison doit être mis en cache et réutilisé pendant la durée spécifiée par la valeur TTL renvoyée (en minutes). Une fois le TTL expiré, un nouvel appel **DescribeEndpoints**doit être effectué pour actualiser le point de terminaison à utiliser, car le point de terminaison ne fonctionnera plus après l'expiration du TTL.