Implémentation du modèle de découverte des terminaux - Amazon Timestream
Procédure de mise en œuvreNotes d’utilisation

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.

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

Pour implémenter le modèle de découverte du point de terminaison, choisissez un API (écriture ou requête), créez une DescribeEndpointsdemande et utilisez le ou les points de terminaison renvoyés pendant la durée de la ou des TTL valeurs 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 pour lequel API vous souhaitez passer des appels (Write ou Query) à l'aide de la DescribeEndpointsdemande.

    1. Créez une demande correspondant à l'APIobjet DescribeEndpointsqui vous intéresse (écriture ou requête) 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.

      Écrivez SDK :
      ingest.timestream.<region>.amazonaws.com
      Requête SDK :
      query.timestream.<region>.amazonaws.com

      Voici un exemple CLI d'appel 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 API point de terminaison. 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 HTTP bibliothèque compatible avec la version 1.1 ou une version ultérieure, la HTTP bibliothèque doit automatiquement remplir l'en-tête pour vous.

      Note

      Substitut <region> avec 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 les TTL valeurs du cache. La réponse est un tableau d'un ou de plusieurs Endpointobjets. Chaque Endpoint objet contient une adresse de point de terminaison (Address) et celle TTL pour ce point de terminaison (CachePeriodInMinutes).

  2. Mettez en cache le point de terminaison jusqu'à la valeur spécifiéeTTL.

  3. À l'TTLexpiration, 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 Timestream Live AnalyticsAPI.

  • 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 API appels, et l'appelant peut choisir le point de terminaison à utiliser au hasard.

  • Outre l'DNSadresse 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 TTL valeur renvoyée (en minutes). Après l'TTLexpiration, un nouvel appel DescribeEndpointsdoit être effectué pour actualiser le point de terminaison à utiliser, car le point de terminaison ne fonctionnera plus après TTL son expiration.