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 un punto API (escritura o consulta), cree una DescribeEndpointssolicitud y utilice los puntos finales devueltos mientras duren los TTL valores 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 contra el API que desea realizar llamadas (escribir o consultar) mediante la solicitud. DescribeEndpoints

    1. Cree una solicitud DescribeEndpointsque se corresponda con lo que le interesa (escribir o consultar) utilizando uno de los dos puntos finales que se describen a continuación. API No hay parámetros de entrada para la solicitud. Asegúrese de leer las siguientes notas.

      EscribeSDK:
      ingest.timestream.<region>.amazonaws.com
      ConsultaSDK:
      query.timestream.<region>.amazonaws.com

      A us-east-1 continuación se muestra un ejemplo de CLI llamada para una 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 API punto final. 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 HTTP biblioteca compatible con la versión 1.1 o posterior, la HTTP biblioteca debería rellenar automáticamente el encabezado.

      nota

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

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

  2. Almacene en caché el punto final hasta el valor especificadoTTL.

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

Notas de uso del patrón de descubrimiento 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 finales contra los que puede realizar llamadas de Timestream Live Analytics. API

  • 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 API llamadas, y la persona que llama puede elegir el punto final para usarlo de forma aleatoria.

  • Además de la DNS dirección 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 TTL valor devuelto (en minutos). Una vez que TTL caduque, se DescribeEndpointsdebe realizar una nueva llamada a para actualizar el dispositivo de punto final que se vaya a utilizar, ya que el punto final dejará de funcionar cuando TTL haya caducado.