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á.

# Usar a API
<a name="Using.API"></a>

 *Além do [SDKs](getting-started-sdks.md), o Amazon Timestream LiveAnalytics for fornece acesso direto à API REST por meio do padrão de descoberta de endpoints.* O padrão de descoberta de endpoints é descrito abaixo, junto com seus casos de uso. 

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

Como o Timestream Live Analytics foi projetado para trabalhar de forma transparente com a arquitetura do serviço, incluindo o gerenciamento e o mapeamento dos endpoints do serviço, é recomendável que você o use para a maioria dos SDKs aplicativos. SDKs No entanto, há alguns casos em que o uso do padrão de descoberta de endpoints da API Timestream for LiveAnalytics REST é necessário: 
+ Você está usando [VPC endpoints (AWS PrivateLink)](VPCEndpoints.md) com Timestream para LiveAnalytics
+ Seu aplicativo usa uma linguagem de programação que ainda não tem suporte para SDK
+ Você precisa de um melhor controle sobre a implantação do lado do cliente

Esta seção inclui informações sobre como o padrão de descoberta de endpoint funciona, como implementar o padrão de descoberta de endpoint e notas de uso. Selecione um tópico abaixo para saber mais. 

**Topics**
+ [

## O padrão de descoberta de endpoints
](#Using-API.endpoint-discovery)
+ [

# Como o padrão de descoberta de endpoints funciona
](Using-API.endpoint-discovery.how-it-works.md)
+ [

# Implementar o padrão de descoberta de endpoints
](Using-API.endpoint-discovery.describe-endpoints.implementation.md)

# Como o padrão de descoberta de endpoints funciona
<a name="Using-API.endpoint-discovery.how-it-works"></a>

 O Timestream é construído usando uma [arquitetura celular](architecture.md#cells) para garantir melhores propriedades de escalonamento e isolamento de tráfego. Como cada conta de cliente é mapeada para uma célula específica em uma região, seu aplicativo deve usar os endpoints corretos específicos da célula para os quais sua conta foi mapeada. Ao usar o SDKs, esse mapeamento é tratado de forma transparente para você e você não precisa gerenciar os endpoints específicos da célula. Porém, ao acessar diretamente a API REST, você mesmo precisará gerenciar e mapear os endpoints corretos. Esse processo do *padrão de descoberta de endpoints* é descrito abaixo: 

1.  O padrão de descoberta do endpoint começa com uma chamada para a ação `DescribeEndpoints` (descrita na seção [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html)). 

1.  O endpoint deve ser armazenado em cache e reutilizado pelo período de tempo especificado pelo valor retornado 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) As chamadas para a API Timestream Live Analytics podem então ser feitas durante o TTL. 

1.  Depois que o TTL expirar, uma nova chamada DescribeEndpoints deve ser feita para atualizar o endpoint (em outras palavras, recomeçar na Etapa 1). 

**nota**  
 A sintaxe, os parâmetros e outras informações de uso da ação `DescribeEndpoints` estão descritos na [Referência da API](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html). Observe que a `DescribeEndpoints` ação está disponível por meio de ambos SDKs e é idêntica para cada um. 

Para a implementação do padrão de descoberta de endpoints, consulte [Implementar o padrão de descoberta de endpoints](Using-API.endpoint-discovery.describe-endpoints.implementation.md).

# 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.