

Para recursos semelhantes aos do Amazon Timestream para, considere o Amazon Timestream LiveAnalytics para InfluxDB. Ele oferece ingestão de dados simplificada e tempos de resposta de consulta de um dígito em milissegundos para análises em tempo real. Saiba mais [aqui](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Implementar o padrão de descoberta de endpoints
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation"></a>

 Para implementar o padrão de descoberta de endpoints, escolha uma API (gravação ou consulta), crie uma **DescribeEndpoints**solicitação e use os endpoints retornados durante a duração dos valores TTL retornados. O procedimento de implementação é descrito abaixo. 

**nota**  
Certifique-se de estar familiarizado com as [notas de uso](#Using-API.endpoint-discovery.describe-endpoints.usage-notes).

## Procedimento de implementação
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation.procedure"></a>

1.  Adquira o endpoint da API para a qual você gostaria de fazer chamadas ([Gravação](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) ou [Consulta](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)) usando a solicitação [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html). 

   1.  Crie uma solicitação para o [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html) que corresponda à API de interesse ([Gravação](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) ou [Consulta](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)) usando um dos dois endpoints descritos abaixo. Não há parâmetros de entrada para a solicitação. Certifique-se de ler as notas abaixo.   
*SDK de gravação:*  

      ```
      ingest.timestream.<region>.amazonaws.com
      ```  
*SDK de consulta:*  

      ```
      query.timestream.<region>.amazonaws.com
      ```

      Veja um exemplo de chamada de CLI para a região `us-east-1` a seguir.

      ```
      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**  
 O cabeçalho HTTP “Host” também *deve* conter o endpoint da API. A solicitação falhará se o cabeçalho não for preenchido. Esse é um requisito padrão para todas as solicitações HTTP/1.1. Se você usar uma biblioteca HTTP compatível com 1.1 ou posterior, a biblioteca HTTP deverá preencher automaticamente o cabeçalho para você.
**nota**  
*<region>*Substitua pelo identificador de região a região em que a solicitação está sendo feita, por exemplo `us-east-1`

   1. Analise a resposta para extrair o(s) endpoint(s) e armazenar em cache os valores de TTL. A resposta é uma matriz de um ou mais [objetos `Endpoint`](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html). Cada objeto `Endpoint` contém um endereço de endpoint (`Address`) e o TTL desse endpoint (`CachePeriodInMinutes`). 

1.  Armazene o endpoint em cache até o TTL especificado. 

1.  Quando o TTL expirar, recupere um novo endpoint recomeçando na etapa 1 da implementação. 

## Notas de uso do padrão de descoberta de endpoints
<a name="Using-API.endpoint-discovery.describe-endpoints.usage-notes"></a>
+ A **DescribeEndpoints**ação é a única ação que os endpoints regionais do Timestream Live Analytics reconhecem. 
+ A resposta contém uma lista de endpoints para os quais fazer chamadas à API do Timestream Live Analytics. 
+  Em caso de resposta bem-sucedida, deve haver pelo menos um endpoint na lista. Se houver mais de um endpoint na lista, qualquer um deles poderá ser usado igualmente para as chamadas de API, e o chamador poderá escolher o endpoint a ser usado aleatoriamente. 
+ Além do endereço DNS do endpoint, cada endpoint na lista especificará um tempo de vida (TTL) permitido para usar o endpoint especificado em minutos.
+ O endpoint deve ser armazenado em cache e reutilizado pelo tempo especificado pelo valor TTL retornado (em minutos). Depois que o TTL expirar, uma nova chamada **DescribeEndpoints**deve ser feita para atualizar o endpoint a ser usado, pois o endpoint não funcionará mais depois que o TTL expirar.