Implementación del patrón de detección de puntos de conexión - 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 detección de puntos de conexión

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 de conexión de la API contra la que desea realizar llamadas (Write o Query) mediante la solicitud DescribeEndpoints.

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

      SDK de escritura:
      ingest.timestream.<region>.amazonaws.com
      SDK de consulta:
      query.timestream.<region>.amazonaws.com

      A continuación, se muestra un ejemplo de llamada CLI para la región 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

      El encabezado HTTP “Host” también debe contener el punto de conexión de la API. La solicitud fallará si no se completa el encabezado. Este es un requisito estándar para todas las solicitudes de HTTP/1.1. Si usa 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 de conexión y almacenar en caché los valores de TTL. La respuesta es una matriz de uno o más objetos Endpoint. Cada objeto Endpoint contiene una dirección de punto de conexión (Address) y el TTL de ese punto de conexión (CachePeriodInMinutes).

  2. Almacene en caché el punto de conexión hasta el TTL especificado.

  3. Cuando el TTL caduque, recupere un nuevo punto de conexión a partir del paso 1 de la implementación.

Notas de uso del patrón de detección de puntos de conexión

  • 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 conexión para realizar llamadas a la API de Timestream Live Analytics.

  • En caso de respuesta satisfactoria, debe haber al menos un punto de conexión en la lista. Si hay más de un punto de conexión en la lista, cualquiera de ellos se puede usar por igual para las llamadas a la API, y la persona que llama puede elegir el punto de conexión que desee usar de forma aleatoria.

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

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