Implementación del patrón de descubrimiento de puntos finales - Amazon Timestream
Procedimiento de implementaciónNotas de uso

Para obtener capacidades similares a las de Amazon Timestream, considere Amazon Timestream LiveAnalytics para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información aquí.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Implementación del patrón de descubrimiento de puntos finales

Para implementar el patrón de detección de puntos finales, elija una API (escritura o consulta), cree una DescribeEndpointssolicitud y utilice los puntos finales devueltos mientras duren los valores TTL devueltos. El procedimiento de implementación se describe a continuación.

nota

Asegúrese de estar familiarizado con las notas de uso.

Procedimiento de implementación

  1. Adquiera el punto final de la API contra la que desea realizar llamadas (Write o Query) mediante la solicitud. DescribeEndpoints

    1. Crea una solicitud DescribeEndpointsque corresponda a la API de tu interés (Write o Query) utilizando uno de los dos puntos finales que se describen a continuación. No hay parámetros de entrada para la solicitud. Asegúrese de leer las siguientes notas.

      Escribe el SDK:
      ingest.timestream.<region>.amazonaws.com
      SDK de consultas:
      query.timestream.<region>.amazonaws.com

      A us-east-1 continuación, se muestra un ejemplo de llamada CLI para la región.

      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

      El encabezado HTTP «Host» también debe contener el punto final de la API. La solicitud fallará si no se completa el encabezado. Este es un requisito estándar para todas las solicitudes HTTP/1.1. Si utilizas una biblioteca HTTP compatible con la versión 1.1 o posterior, la biblioteca HTTP debería rellenar automáticamente el encabezado.

      nota

      Sustituya <region> la región en la que se realiza la solicitud por el identificador de región, p. ej. us-east-1

    2. Analice la respuesta para extraer los puntos finales y almacenar en caché los valores TTL. La respuesta es una matriz de uno o más Endpointobjetos. Cada Endpoint objeto contiene una dirección de punto final (Address) y el TTL de ese punto final (CachePeriodInMinutes).

  2. Almacene en caché el punto final hasta el TTL especificado.

  3. Cuando el TTL caduque, recupere un nuevo punto final empezando desde el paso 1 de la implementación.

Notas de uso del patrón de detección de terminales

  • La DescribeEndpointsacción es la única acción que reconocen los puntos finales regionales de Timestream Live Analytics.

  • La respuesta contiene una lista de puntos de enlace desde los que realizar llamadas a la API de Timestream Live Analytics.

  • Si la respuesta es correcta, debe haber al menos un punto final en la lista. Si hay más de un punto final en la lista, cualquiera de ellos se puede utilizar por igual para las llamadas a la API, y la persona que llama puede elegir el punto final para usarlo de forma aleatoria.

  • Además de la dirección DNS del punto final, cada punto final de la lista especificará el tiempo de vida (TTL) permitido para usar el punto final especificado en minutos.

  • El punto final debe almacenarse en caché y reutilizarse durante el tiempo especificado en el valor TTL devuelto (en minutos). Cuando el TTL caduque, se DescribeEndpointsdebe realizar una nueva llamada a para actualizar el punto final y poder utilizarlo, ya que el punto final dejará de funcionar una vez que el TTL haya caducado.