Für ähnliche Funktionen wie Amazon Timestream für sollten Sie Amazon Timestream for LiveAnalytics InfluxDB in Betracht ziehen. Es bietet eine vereinfachte Datenaufnahme und Antwortzeiten im einstelligen Millisekundenbereich für Analysen in Echtzeit. [Erfahren](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html) Sie hier mehr.

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.

# Verwenden der API
<a name="Using.API"></a>

 Darüber hinaus LiveAnalytics bietet Amazon Timestream for direkten REST-API-Zugriff über das *Endpoint Discovery Pattern*. [SDKs](getting-started-sdks.md) Das Endpoint Discovery Pattern wird im Folgenden zusammen mit seinen Anwendungsfällen beschrieben. 

## Das Endpoint Discovery-Muster
<a name="Using-API.endpoint-discovery"></a>

Da Timestream Live Analytics so konzipiert SDKs sind, dass sie transparent mit der Architektur des Dienstes zusammenarbeiten, einschließlich der Verwaltung und Zuordnung der Dienstendpunkte, wird empfohlen, sie SDKs für die meisten Anwendungen zu verwenden. Es gibt jedoch einige Fälle, in denen die Verwendung des Timestream for LiveAnalytics REST API-Endpunkterkennungsmusters erforderlich ist: 
+ Sie verwenden [VPC-Endpunkte (AWS PrivateLink) mit](VPCEndpoints.md) Timestream für LiveAnalytics
+ Ihre Anwendung verwendet eine Programmiersprache, die noch keine SDK-Unterstützung bietet
+ Sie benötigen eine bessere Kontrolle über die clientseitige Implementierung

Dieser Abschnitt enthält Informationen darüber, wie das Endpoint Discovery Pattern funktioniert, wie das Endpoint Discovery Pattern implementiert wird, sowie Nutzungshinweise. Wählen Sie unten ein Thema aus, um mehr zu erfahren. 

**Topics**
+ [

## Das Endpoint Discovery-Muster
](#Using-API.endpoint-discovery)
+ [

# So funktioniert das Endpoint Discovery Pattern
](Using-API.endpoint-discovery.how-it-works.md)
+ [

# Implementierung des Endpoint Discovery Patterns
](Using-API.endpoint-discovery.describe-endpoints.implementation.md)

# So funktioniert das Endpoint Discovery Pattern
<a name="Using-API.endpoint-discovery.how-it-works"></a>

 Timestream basiert auf einer [Mobilfunkarchitektur](architecture.md#cells), um eine bessere Skalierung und Isolierung des Datenverkehrs zu gewährleisten. Da jedes Kundenkonto einer bestimmten Zelle in einer Region zugeordnet ist, muss Ihre Anwendung die richtigen zellenspezifischen Endpunkte verwenden, denen Ihr Konto zugeordnet wurde. Wenn Sie den verwenden SDKs, wird diese Zuordnung transparent für Sie vorgenommen, und Sie müssen die zellenspezifischen Endpunkte nicht verwalten. Wenn Sie jedoch direkt auf die REST-API zugreifen, müssen Sie die richtigen Endpunkte selbst verwalten und zuordnen. Dieser Prozess, das *Endpoint Discovery Pattern*, wird im Folgenden beschrieben: 

1.  Das Endpoint Discovery Pattern beginnt mit einem Aufruf zur `DescribeEndpoints` Aktion (im [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html)Abschnitt beschrieben). 

1.  Der Endpunkt sollte zwischengespeichert und für den Zeitraum wiederverwendet werden, der durch den zurückgegebenen Wert time-to-live (TTL) (der) angegeben ist. [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) Aufrufe an die Timestream Live Analytics-API können dann für die Dauer der TTL getätigt werden. 

1.  Nach Ablauf der TTL DescribeEndpoints sollte ein neuer Aufruf an erfolgen, um den Endpunkt zu aktualisieren (mit anderen Worten, beginnen Sie bei Schritt 1 von vorne). 

**Anmerkung**  
 Syntax, Parameter und andere Nutzungsinformationen für die `DescribeEndpoints` Aktion werden in der [API-Referenz](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html) beschrieben. Beachten Sie, dass die `DescribeEndpoints` Aktion über beide SDKs verfügbar ist und für beide identisch ist. 

Informationen zur Implementierung des Endpoint Discovery Patterns finden Sie unter[Implementierung des Endpoint Discovery Patterns](Using-API.endpoint-discovery.describe-endpoints.implementation.md).

# Implementierung des Endpoint Discovery Patterns
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation"></a>

 Um das Endpoint Discovery Pattern zu implementieren, wählen Sie eine API (Write oder Query), erstellen Sie eine **DescribeEndpoints**Anfrage 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](#Using-API.endpoint-discovery.describe-endpoints.usage-notes) vertraut sind.

## Verfahren zur Implementierung
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation.procedure"></a>

1.  Ermitteln Sie mithilfe der Anfrage den Endpunkt für die API, gegen die Sie Aufrufe tätigen möchten ([Write](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) oder [Query](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)). [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html) 

   1.  Erstellen Sie mithilfe eines der beiden unten beschriebenen Endpunkte eine Anfrage, die der gewünschten API ([Write](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) oder [Query](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)) entspricht. [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html) Es gibt keine Eingabeparameter für die Anfrage. Stellen Sie sicher, dass Sie die folgenden Hinweise gelesen haben.   
*Schreiben Sie SDK:*  

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

      ```
      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 HTTP-Header „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**  
*<region>*Ersetzen Sie es durch die Regionskennung für die Region, in der die Anfrage gestellt wird, z. B. `us-east-1`

   1. Analysieren Sie die Antwort, um die Endpunkte zu extrahieren und die TTL-Werte zwischenzuspeichern. [Die Antwort ist ein Array von einem oder mehreren `Endpoint` Objekten.](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html) Jedes `Endpoint` Objekt enthält eine Endpunktadresse (`Address`) und die TTL für diesen Endpunkt (`CachePeriodInMinutes`). 

1.  Zwischenspeichern Sie den Endpunkt bis zur angegebenen TTL. 

1.  Wenn die 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
<a name="Using-API.endpoint-discovery.describe-endpoints.usage-notes"></a>
+ Die **DescribeEndpoints**Aktion 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-API-Aufrufe ausgeführt werden sollen. 
+  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-Aufrufe verwendet werden, und der Aufrufer 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 Verwendung 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 Ablauf der TTL **DescribeEndpoints**sollte ein neuer Aufruf an getätigt werden, um den zu verwendenden Endpunkt zu aktualisieren, da der Endpunkt nach Ablauf der TTL nicht mehr funktioniert.