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í](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

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.

# Uso de la API
<a name="Using.API"></a>

 Además [SDKs](getting-started-sdks.md), Amazon Timestream LiveAnalytics for proporciona acceso directo a la API REST mediante el patrón de detección de puntos *finales*. El patrón de detección de puntos de conexión se describe a continuación, junto con sus casos de uso. 

## El patrón de detección de puntos de conexión
<a name="Using-API.endpoint-discovery"></a>

Dado que los Timestream Live Analytics SDKs están diseñados para funcionar de forma transparente con la arquitectura del servicio, incluida la administración y el mapeo de los puntos finales del servicio, se recomienda utilizarlos para la mayoría de las aplicaciones. SDKs Sin embargo, hay algunos casos en los que es necesario utilizar el patrón de descubrimiento de puntos finales de la API Timestream for LiveAnalytics REST: 
+ Está utilizando [puntos finales de VPC (AWS PrivateLink)](VPCEndpoints.md) con Timestream para LiveAnalytics
+ Su aplicación utiliza un lenguaje de programación que aún no es compatible con SDK.
+ Necesita un mejor control sobre la implementación por parte del cliente

Esta sección incluye información sobre cómo funciona el patrón de detección de puntos de conexión, cómo implementarlo y notas de uso. Seleccione un tema a continuación para obtener más información al respecto. 

**Topics**
+ [

## El patrón de detección de puntos de conexión
](#Using-API.endpoint-discovery)
+ [

# Cómo funciona el patrón de detección de puntos de conexión
](Using-API.endpoint-discovery.how-it-works.md)
+ [

# Implementación del patrón de detección de puntos de conexión
](Using-API.endpoint-discovery.describe-endpoints.implementation.md)

# Cómo funciona el patrón de detección de puntos de conexión
<a name="Using-API.endpoint-discovery.how-it-works"></a>

 Timestream se creó con una [Arquitectura celular](architecture.md#cells) para garantizar una mejor escalabilidad y propiedades de aislamiento del tráfico. Dado que cada cuenta de cliente se mapea a una celda específica de una región, la aplicación debe usar los puntos de conexión específicos de celda correctos a los que se ha mapeado su cuenta. Al utilizar el SDKs, este mapeo se gestiona de forma transparente y no es necesario gestionar los puntos finales específicos de la celda. Sin embargo, cuando acceda directamente a la API de REST, tendrá que gestionar y mapear los puntos de conexión correctos personalmente. A continuación, se describe este proceso de *Patrón de detección de puntos de conexión*: 

1.  El patrón de detección de puntos de conexión comienza con una llamada a la acción `DescribeEndpoints` (que se describe en la sección [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html)). 

1.  El punto final debe almacenarse en caché y reutilizarse durante el tiempo especificado en el valor devuelto time-to-live (TTL) (the). [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html#timestream-Type-Endpoint-CachePeriodInMinutes.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html#timestream-Type-Endpoint-CachePeriodInMinutes.html) De este modo, se pueden realizar llamadas a la API de Timestream Live Analytics mientras dure el TTL. 

1.  Cuando el TTL caduque, se DescribeEndpoints debe realizar una nueva llamada a para actualizar el punto final (en otras palabras, volver a empezar por el paso 1). 

**nota**  
 La sintaxis, los parámetros y otra información de uso de la acción `DescribeEndpoints` se describen en la [Referencia de la API.](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html) Tenga en cuenta que la `DescribeEndpoints` acción está disponible a través de ambos SDKs y es idéntica para cada uno. 

Para obtener información sobre la implementación del patrón de detección de puntos de conexión, consulte [Implementación del patrón de detección de puntos de conexión](Using-API.endpoint-discovery.describe-endpoints.implementation.md).

# Implementación del patrón de detección de puntos de conexión
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation"></a>

 Para implementar el patrón de detección de puntos finales, elija una API (escritura o consulta), cree una **DescribeEndpoints**solicitud 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](#Using-API.endpoint-discovery.describe-endpoints.usage-notes).

## Procedimiento de implementación
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation.procedure"></a>

1.  Adquiera el punto de conexión de la API contra la que desea realizar llamadas ([Write](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) o [Query](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)) mediante la solicitud [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html). 

   1.  Cree una solicitud [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html) que corresponda a la API de su interés ([Write](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) o [Query](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)) 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`

   1. 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`](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html). Cada objeto `Endpoint` contiene una dirección de punto de conexión (`Address`) y el TTL de ese punto de conexión (`CachePeriodInMinutes`). 

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

1.  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
<a name="Using-API.endpoint-discovery.describe-endpoints.usage-notes"></a>
+ La **DescribeEndpoints**acció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 **DescribeEndpoints**debe 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.