Implémentation du modèle de découverte des terminaux

Pour implémenter le modèle de découverte des points de terminaison, choisissez une API (Write ou Query), créez une DescribeEndpointsdemande 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.

Procédure de mise en œuvre

1. Obtenez le point de terminaison de l'API à laquelle vous souhaitez effectuer des appels (Write ou Query) à l'aide de la DescribeEndpointsrequête.

   1. Créez une demande correspondant à l'API DescribeEndpointsqui vous intéresse (Write ou Query) 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

   2. 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 Endpointobjets. Chaque Endpoint objet contient une adresse de point de terminaison (Address) et le TTL pour ce point de terminaison (CachePeriodInMinutes).

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

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

• 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 DescribeEndpointsdoit être effectué pour actualiser le point de terminaison à utiliser, car le point de terminaison ne fonctionnera plus après l'expiration du TTL.