Implementierung des Endpoint Discovery Patterns - Amazon Timestream
Verfahren zur UmsetzungNutzungshinweise

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Implementierung des Endpoint Discovery Patterns

Um das Endpoint Discovery-Muster zu implementieren, wählen Sie ein API (Schreiben oder Abfragen), erstellen Sie eine DescribeEndpointsAnfrage und verwenden Sie die zurückgegebenen Endpunkte für die Dauer der zurückgegebenen TTL Werte. Das Implementierungsverfahren wird unten beschrieben.

Anmerkung

Stellen Sie sicher, dass Sie mit den Nutzungshinweisen vertraut sind.

Verfahren zur Implementierung

  1. Ermitteln API Sie mithilfe der Anfrage den Endpunkt für den, gegen den Sie Anrufe tätigen möchten (Write oder Query). DescribeEndpoints

    1. Erstellen Sie mithilfe eines API der beiden unten beschriebenen Endpunkte eine Anfrage, die der gewünschten Anfrage entspricht (Write oder Query). DescribeEndpoints Es gibt keine Eingabeparameter für die Anfrage. Stellen Sie sicher, dass Sie die folgenden Hinweise gelesen haben.

      Schreiben SieSDK:
      ingest.timestream.<region>.amazonaws.com
      AnfrageSDK:
      query.timestream.<region>.amazonaws.com

      Es us-east-1 folgt ein Beispiel für einen CLI Aufruf für die Region.

      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
      Anmerkung

      Der Header HTTP „Host“ muss auch den API Endpunkt enthalten. Die Anfrage schlägt fehl, wenn der Header nicht gefüllt ist. Dies ist eine Standardanforderung für alle HTTP /1.1-Anfragen. Wenn Sie eine HTTP Bibliothek verwenden, die 1.1 oder höher unterstützt, sollte die HTTP Bibliothek den Header automatisch für Sie ausfüllen.

      Anmerkung

      Ersetze <region> mit der Regionskennung für die Region, in der die Anfrage gestellt wird, z. B. us-east-1

    2. Analysieren Sie die Antwort, um die Endpunkte und die TTL Cache-Werte zu extrahieren. Die Antwort ist ein Array von einem oder mehreren EndpointObjekten. Jedes Endpoint Objekt enthält eine Endpunktadresse (Address) und die TTL für diesen Endpunkt (CachePeriodInMinutes).

  2. Zwischenspeichern Sie den Endpunkt bis zum angegebenen WertTTL.

  3. Wenn der TTL abläuft, rufen Sie einen neuen Endpunkt ab, indem Sie bei Schritt 1 der Implementierung von vorne beginnen.

Nutzungshinweise für das Endpoint Discovery Pattern

  • Die DescribeEndpointsAktion ist die einzige Aktion, die von den regionalen Endpunkten von Timestream Live Analytics erkannt wird.

  • Die Antwort enthält eine Liste von Endpunkten, gegen die Timestream Live Analytics-Aufrufe getätigt werden sollen. API

  • Bei erfolgreicher Antwort sollte die Liste mindestens einen Endpunkt enthalten. Wenn die Liste mehr als einen Endpunkt enthält, kann jeder von ihnen gleichermaßen für die API Anrufe verwendet werden, und der Anrufer kann den zu verwendenden Endpunkt nach dem Zufallsprinzip auswählen.

  • Zusätzlich zur DNS Adresse des Endpunkts gibt jeder Endpunkt in der Liste eine Gültigkeitsdauer (TTL) an, die für die Nutzung des angegebenen Endpunkts in Minuten zulässig ist.

  • Der Endpunkt sollte zwischengespeichert und für die durch den zurückgegebenen TTL Wert angegebene Zeit (in Minuten) wiederverwendet werden. Nach TTL Ablauf DescribeEndpointssollte ein neuer Aufruf an erfolgen, um den zu verwendenden Endpunkt zu aktualisieren, da der Endpunkt nach TTL Ablauf des nicht mehr funktioniert.