Implementando o padrão de descoberta de endpoints - Amazon Timestream
Procedimento de implementaçãoObservações de uso

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

Implementando o padrão de descoberta de endpoints

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

nota

Certifique-se de estar familiarizado com as notas de uso.

Procedimento de implementação

  1. Adquira o endpoint para o API qual você gostaria de fazer chamadas (Gravação ou Consulta). usando a DescribeEndpointssolicitação.

    1. Crie uma solicitação DescribeEndpointsque API corresponda à de interesse (Gravação ou Consulta) 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.

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

      us-east-1Segue um exemplo de CLI chamada para região.

      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 API endpoint. 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 HTTP biblioteca compatível com 1.1 ou posterior, a HTTP biblioteca deverá preencher automaticamente o cabeçalho para você.

      nota

      Substituto <region> com o identificador de região para a região em que a solicitação está sendo feita, por exemplo us-east-1

    2. Analise a resposta para extrair o (s) ponto (s) final (s) e o (s) TTL valor (es) do cache. A resposta é uma matriz de um ou mais Endpointobjetos. Cada Endpoint objeto contém um endereço de endpoint (Address) e o TTL para esse endpoint (CachePeriodInMinutes).

  2. Armazene em cache o endpoint até o especificadoTTL.

  3. 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 DescribeEndpointsaçã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 do Timestream Live AnalyticsAPI.

  • 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 API chamadas, e o chamador poderá escolher o endpoint a ser usado aleatoriamente.

  • Além do DNS endereço do endpoint, cada endpoint na lista especificará um time to live (TTL) que é permitido para usar o endpoint especificado em minutos.

  • O endpoint deve ser armazenado em cache e reutilizado pelo tempo especificado pelo TTL valor retornado (em minutos). Após a TTL expiração, uma nova chamada DescribeEndpointsdeve ser feita para atualizar o endpoint a ser usado, pois o endpoint não funcionará mais após a expiração. TTL