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

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 escritura de doble pila:
      timestream-ingest.<region>.api.aws
      SDK de consultas:
      query.timestream.<region>.amazonaws.com
      SDK de consultas de doble pila:
      timestream-query.<region>.api.aws

      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

      Para doble pila:

      REGION_ENDPOINT="https://timestream-query.us-east-1.api.aws"
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, por ejemplo, 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 puntos finales

  • 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 que desee utilizar 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 utilizarlo, ya que el punto final dejará de funcionar una vez que el TTL haya caducado.