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.
# Amazon Timestream Timestream-Abfrage
Die folgenden Aktionen werden von Amazon Timestream Query unterstützt:
+ [CancelQuery](API_query_CancelQuery.md)
+ [CreateScheduledQuery](API_query_CreateScheduledQuery.md)
+ [DeleteScheduledQuery](API_query_DeleteScheduledQuery.md)
+ [DescribeAccountSettings](API_query_DescribeAccountSettings.md)
+ [DescribeEndpoints](API_query_DescribeEndpoints.md)
+ [DescribeScheduledQuery](API_query_DescribeScheduledQuery.md)
+ [ExecuteScheduledQuery](API_query_ExecuteScheduledQuery.md)
+ [ListScheduledQueries](API_query_ListScheduledQueries.md)
+ [ListTagsForResource](API_query_ListTagsForResource.md)
+ [PrepareQuery](API_query_PrepareQuery.md)
+ [Query](API_query_Query.md)
+ [TagResource](API_query_TagResource.md)
+ [UntagResource](API_query_UntagResource.md)
+ [UpdateAccountSettings](API_query_UpdateAccountSettings.md)
+ [UpdateScheduledQuery](API_query_UpdateScheduledQuery.md)
# CancelQuery
Bricht eine ausgegebene Abfrage ab. Eine Stornierung ist nur möglich, wenn die Abfrage nicht vollständig ausgeführt wurde, bevor die Stornierungsanforderung gestellt wurde. Da es sich bei der Stornierung um eine idempotente Operation handelt, geben nachfolgende Stornierungsanforderungen a zurück`CancellationMessage`, was darauf hinweist, dass die Abfrage bereits abgebrochen wurde. Einzelheiten finden Sie unter [Codebeispiel](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.cancel-query.html).
## Anforderungssyntax
```
{
"QueryId": "string"
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [QueryId](#API_query_CancelQuery_RequestSyntax) **
Die ID der Abfrage, die storniert werden muss. `QueryID`wird als Teil des Abfrageergebnisses zurückgegeben.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `[a-zA-Z0-9]+`
Erforderlich: Ja
## Antwortsyntax
```
{
"CancellationMessage": "string"
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [CancellationMessage](#API_query_CancelQuery_ResponseSyntax) **
A `CancellationMessage` wird zurückgegeben, wenn eine `CancelQuery` Anforderung für die von angegebene Abfrage `QueryId` bereits gestellt wurde.
Typ: Zeichenfolge
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.
HTTP-Statuscode: 400
** InternalServerException **
Bei der Bearbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CancelQuery)
# CreateScheduledQuery
Erstellen Sie eine geplante Abfrage, die in Ihrem Namen nach dem konfigurierten Zeitplan ausgeführt wird. Timestream übernimmt die Ausführungsrolle, die als Teil des `ScheduledQueryExecutionRoleArn`-Parameters bereitgestellt wird, um die Abfrage auszuführen. Sie können den `NotificationConfiguration`-Parameter verwenden, um die Benachrichtigung für Ihre geplanten Abfragevorgänge zu konfigurieren.
## Anforderungssyntax
```
{
"ClientToken": "string",
"ErrorReportConfiguration": {
"S3Configuration": {
"BucketName": "string",
"EncryptionOption": "string",
"ObjectKeyPrefix": "string"
}
},
"KmsKeyId": "string",
"Name": "string",
"NotificationConfiguration": {
"SnsConfiguration": {
"TopicArn": "string"
}
},
"QueryString": "string",
"ScheduleConfiguration": {
"ScheduleExpression": "string"
},
"ScheduledQueryExecutionRoleArn": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"TargetConfiguration": {
"TimestreamConfiguration": {
"DatabaseName": "string",
"DimensionMappings": [
{
"DimensionValueType": "string",
"Name": "string"
}
],
"MeasureNameColumn": "string",
"MixedMeasureMappings": [
{
"MeasureName": "string",
"MeasureValueType": "string",
"MultiMeasureAttributeMappings": [
{
"MeasureValueType": "string",
"SourceColumn": "string",
"TargetMultiMeasureAttributeName": "string"
}
],
"SourceColumn": "string",
"TargetMeasureName": "string"
}
],
"MultiMeasureMappings": {
"MultiMeasureAttributeMappings": [
{
"MeasureValueType": "string",
"SourceColumn": "string",
"TargetMultiMeasureAttributeName": "string"
}
],
"TargetMultiMeasureName": "string"
},
"TableName": "string",
"TimeColumn": "string"
}
}
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) **
Die Verwendung von a ClientToken macht den Aufruf CreateScheduledQuery idempotent, mit anderen Worten, wenn dieselbe Anfrage wiederholt gestellt wird, führt dies zu demselben Ergebnis. Das Stellen mehrerer identischer CreateScheduledQuery Anfragen hat den gleichen Effekt wie das Stellen einer einzelnen Anfrage.
+ Wenn ohne a aufgerufen CreateScheduledQuery wird`ClientToken`, generiert das Query SDK in `ClientToken` Ihrem Namen eine.
+ Nach 8 Stunden wird jede Anforderung mit dem gleichen `ClientToken` als neue Anforderung behandelt.
Typ: Zeichenfolge
Längenbeschränkungen: Mindestlänge von 32. Maximale Länge beträgt 128 Zeichen.
Erforderlich: Nein
** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **
Konfiguration für die Fehler-Berichterstellung. Fehlerberichte werden generiert, wenn beim Schreiben der Abfrage-Ergebnisse ein Problem auftritt.
Typ: [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) Objekt
Erforderlich: Ja
** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) **
Der Amazon-KMS-Schlüssel, der zur Verschlüsselung der geplanten Abfrage-Ressource verwendet wird, at-rest. Wenn der Amazon-KMS-Schlüssel nicht angegeben ist, wird die geplante Abfrage-Ressource mit einem Timestream-eigenen Amazon-KMS-Schlüssel verschlüsselt. Um einen KMS-Schlüssel anzugeben, verwenden Sie seine Schlüssel-ID, seinen Schlüssel-ARN, seinen Aliasnamen oder seinen Alias-ARN. Wenn Sie einen Aliasnamen verwenden, stellen Sie dem Namen *alias/* voran.
Wenn `SSE_KMS` als Verschlüsselungstyp ErrorReportConfiguration verwendet wird, KmsKeyId wird derselbe verwendet, um den Fehlerbericht im Ruhezustand zu verschlüsseln.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Erforderlich: Nein
** [Name](#API_query_CreateScheduledQuery_RequestSyntax) **
Name der geplanten Abfrage.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`
Erforderlich: Ja
** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **
Benachrichtigungs-Konfiguration für eine geplante Abfrage. Timestream sendet eine Benachrichtigung, wenn ein Abfragelauf abgeschlossen ist, wenn der Status aktualisiert wird oder wenn Sie ihn löschen.
Typ: [NotificationConfiguration](API_query_NotificationConfiguration.md) Objekt
Erforderlich: Ja
** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) **
Die auszuführende Abfragezeichenfolge. Parameternamen können in der Abfragezeichenfolge `@` Zeichen gefolgt von einer Kennung angegeben werden. Der benannte Parameter `@scheduled_runtime` ist reserviert und kann in der Abfrage verwendet werden, um den Zeitpunkt abzurufen, zu dem die Abfrage planmäßig ausgeführt werden soll.
Der anhand des ScheduleConfiguration Parameters berechnete Zeitstempel entspricht dem Wert von `@scheduled_runtime` paramater für jeden Abfragelauf. Stellen Sie sich zum Beispiel eine Instance einer geplanten Abfrage vor, die am 01.12.2021 00:00:00 ausgeführt wird. In dieser Instance wird der `@scheduled_runtime` Parameter beim Aufrufen der Abfrage mit dem Zeitstempel 2021-12-01 00:00:00 initialisiert.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 262144.
Erforderlich: Ja
** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **
Die Zeitplankonfiguration für die Abfrage.
Typ: [ScheduleConfiguration](API_query_ScheduleConfiguration.md) Objekt
Erforderlich: Ja
** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **
Der ARN für die IAM-Rolle, die Timestream beim Ausführen der geplanten Abfrage übernimmt.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Erforderlich: Ja
** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) **
Eine Liste von Schlüssel-Wert-Paaren zur Benennung der geplanten Abfrage.
Typ: Array von [Tag](API_query_Tag.md)-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.
Erforderlich: Nein
** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **
Konfiguration, die zum Schreiben des Ergebnisses einer Abfrage verwendet wird.
Typ: [TargetConfiguration](API_query_TargetConfiguration.md) Objekt
Erforderlich: Nein
## Antwortsyntax
```
{
"Arn": "string"
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) **
ARN für die erstellte geplante Abfrage.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.
HTTP-Statuscode: 400
** ConflictException **
Die Ergebnisse für eine stornierte Abfrage konnten nicht abgefragt werden.
HTTP-Statuscode: 400
** InternalServerException **
Bei der Verarbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ServiceQuotaExceededException **
Sie haben das Dienstkontingent überschritten.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery)
# DeleteScheduledQuery
Löscht eine angegebene geplante Abfrage. Dieser Vorgang kann nicht rückgängig gemacht werden.
## Anforderungssyntax
```
{
"ScheduledQueryArn": "string"
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) **
Der ARN der geplanten Abfrage.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Erforderlich: Ja
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.
HTTP-Statuscode: 400
** InternalServerException **
Bei der Bearbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ResourceNotFoundException **
Die angeforderte Ressource wurde nicht gefunden.
** ScheduledQueryArn **
Der ARN der geplanten Abfrage.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DeleteScheduledQuery)
# DescribeAccountSettings
Beschreibt die Einstellungen für Ihr Konto, zu denen das Abfragepreismodell und das konfigurierte Maximum gehören, TCUs das der Dienst für Ihre Abfrage-Workloads verwenden kann.
Ihnen wird nur die Dauer der Recheneinheiten in Rechnung gestellt, die für Ihre Workloads verwendet werden.
## Antwortsyntax
```
{
"MaxQueryTCU": number,
"QueryCompute": {
"ComputeMode": "string",
"ProvisionedCapacity": {
"ActiveQueryTCU": number,
"LastUpdate": {
"Status": "string",
"StatusMessage": "string",
"TargetQueryTCU": number
},
"NotificationConfiguration": {
"RoleArn": "string",
"SnsConfiguration": {
"TopicArn": "string"
}
}
}
},
"QueryPricingModel": "string"
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [MaxQueryTCU](#API_query_DescribeAccountSettings_ResponseSyntax) **
Die maximale Anzahl von [Timestream-Recheneinheiten](https://docs.aws.amazon.com/timestream/latest/developerguide/tcu.html) (TCUs), die der Service zu einem beliebigen Zeitpunkt zur Bearbeitung Ihrer Anfragen verwendet. Um Abfragen ausführen zu können, müssen Sie eine Mindestkapazität von 4 TCU festlegen. Sie können die maximale Anzahl von TCU in Vielfachen von 4 festlegen, z. B. 4, 8, 16, 32 usw. Diese Konfiguration gilt nur für die On-Demand-Verwendung von ()TCUs.
Typ: Ganzzahl
** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) **
Ein Objekt, das die Nutzungseinstellungen für Timestream-Recheneinheiten (TCUs) in Ihrem Konto für den Abfrage-Workload enthält. QueryCompute ist nur in der Region Asien-Pazifik (Mumbai) verfügbar.
Typ: [QueryComputeResponse](API_query_QueryComputeResponse.md) Objekt
** [QueryPricingModel](#API_query_DescribeAccountSettings_ResponseSyntax) **
Das Preismodell für Anfragen in Ihrem Konto.
Der `QueryPricingModel` Parameter wird von mehreren Timestream-Vorgängen verwendet. Der `UpdateAccountSettings` API-Vorgang erkennt jedoch keine anderen Werte als`COMPUTE_UNITS`.
Typ: Zeichenfolge
Zulässige Werte: `BYTES_SCANNED | COMPUTE_UNITS`
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.
HTTP-Statuscode: 400
** InternalServerException **
Bei der Bearbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeAccountSettings)
# DescribeEndpoints
DescribeEndpoints gibt eine Liste verfügbarer Endpunkte zurück, für die Timestream-API-Aufrufe ausgeführt werden können. Diese API ist sowohl über Write als auch über Query verfügbar.
Da Timestream so konzipiert SDKs sind, dass sie transparent mit der Architektur des Dienstes zusammenarbeiten, einschließlich der Verwaltung und Zuordnung der Dienstendpunkte, wird die *Verwendung dieser API nicht empfohlen, es sei denn*:
+ Sie verwenden [VPC-Endpunkte (AWS PrivateLink)](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) mit Timestream
+ Ihre Anwendung verwendet eine Programmiersprache, die noch keine SDK-Unterstützung bietet
+ Sie benötigen eine bessere Kontrolle über die clientseitige Implementierung
Ausführliche Informationen darüber, wie und wann Sie es verwenden und implementieren sollten DescribeEndpoints, finden Sie unter [The Endpoint Discovery Pattern](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery).
## Antwortsyntax
```
{
"Endpoints": [
{
"Address": "string",
"CachePeriodInMinutes": number
}
]
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [Endpoints](#API_query_DescribeEndpoints_ResponseSyntax) **
Ein `Endpoints` Objekt wird zurückgegeben, wenn eine `DescribeEndpoints` Anfrage gestellt wird.
Typ: Array von [Endpoint](API_query_Endpoint.md)-Objekten
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** InternalServerException **
Bei der Bearbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeEndpoints)
# DescribeScheduledQuery
Stellt detaillierte Informationen zu einer geplanten Abfrage bereit.
## Anforderungssyntax
```
{
"ScheduledQueryArn": "string"
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) **
Der ARN der geplanten Abfrage.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Erforderlich: Ja
## Antwortsyntax
```
{
"ScheduledQuery": {
"Arn": "string",
"CreationTime": number,
"ErrorReportConfiguration": {
"S3Configuration": {
"BucketName": "string",
"EncryptionOption": "string",
"ObjectKeyPrefix": "string"
}
},
"KmsKeyId": "string",
"LastRunSummary": {
"ErrorReportLocation": {
"S3ReportLocation": {
"BucketName": "string",
"ObjectKey": "string"
}
},
"ExecutionStats": {
"BytesMetered": number,
"CumulativeBytesScanned": number,
"DataWrites": number,
"ExecutionTimeInMillis": number,
"QueryResultRows": number,
"RecordsIngested": number
},
"FailureReason": "string",
"InvocationTime": number,
"QueryInsightsResponse": {
"OutputBytes": number,
"OutputRows": number,
"QuerySpatialCoverage": {
"Max": {
"PartitionKey": [ "string" ],
"TableArn": "string",
"Value": number
}
},
"QueryTableCount": number,
"QueryTemporalRange": {
"Max": {
"TableArn": "string",
"Value": number
}
}
},
"RunStatus": "string",
"TriggerTime": number
},
"Name": "string",
"NextInvocationTime": number,
"NotificationConfiguration": {
"SnsConfiguration": {
"TopicArn": "string"
}
},
"PreviousInvocationTime": number,
"QueryString": "string",
"RecentlyFailedRuns": [
{
"ErrorReportLocation": {
"S3ReportLocation": {
"BucketName": "string",
"ObjectKey": "string"
}
},
"ExecutionStats": {
"BytesMetered": number,
"CumulativeBytesScanned": number,
"DataWrites": number,
"ExecutionTimeInMillis": number,
"QueryResultRows": number,
"RecordsIngested": number
},
"FailureReason": "string",
"InvocationTime": number,
"QueryInsightsResponse": {
"OutputBytes": number,
"OutputRows": number,
"QuerySpatialCoverage": {
"Max": {
"PartitionKey": [ "string" ],
"TableArn": "string",
"Value": number
}
},
"QueryTableCount": number,
"QueryTemporalRange": {
"Max": {
"TableArn": "string",
"Value": number
}
}
},
"RunStatus": "string",
"TriggerTime": number
}
],
"ScheduleConfiguration": {
"ScheduleExpression": "string"
},
"ScheduledQueryExecutionRoleArn": "string",
"State": "string",
"TargetConfiguration": {
"TimestreamConfiguration": {
"DatabaseName": "string",
"DimensionMappings": [
{
"DimensionValueType": "string",
"Name": "string"
}
],
"MeasureNameColumn": "string",
"MixedMeasureMappings": [
{
"MeasureName": "string",
"MeasureValueType": "string",
"MultiMeasureAttributeMappings": [
{
"MeasureValueType": "string",
"SourceColumn": "string",
"TargetMultiMeasureAttributeName": "string"
}
],
"SourceColumn": "string",
"TargetMeasureName": "string"
}
],
"MultiMeasureMappings": {
"MultiMeasureAttributeMappings": [
{
"MeasureValueType": "string",
"SourceColumn": "string",
"TargetMultiMeasureAttributeName": "string"
}
],
"TargetMultiMeasureName": "string"
},
"TableName": "string",
"TimeColumn": "string"
}
}
}
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [ScheduledQuery](#API_query_DescribeScheduledQuery_ResponseSyntax) **
Die geplante Abfrage.
Typ: [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) Objekt
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.
HTTP-Statuscode: 400
** InternalServerException **
Bei der Bearbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ResourceNotFoundException **
Die angeforderte Ressource wurde nicht gefunden.
** ScheduledQueryArn **
Der ARN der geplanten Abfrage.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeScheduledQuery)
# ExecuteScheduledQuery
Sie können diese API verwenden, um eine geplante Abfrage manuell auszuführen.
Wenn Sie diese API aktiviert haben`QueryInsights`, gibt sie auch Einblicke und Metriken zu der Abfrage zurück, die Sie als Teil einer Amazon SNS SNS-Benachrichtigung ausgeführt haben. `QueryInsights`hilft bei der Leistungsoptimierung Ihrer Anfrage. Weitere Informationen `QueryInsights` dazu finden Sie unter [Verwenden von Abfrageerkenntnissen zur Optimierung von Abfragen in Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).
## Anforderungssyntax
```
{
"ClientToken": "string",
"InvocationTime": number,
"QueryInsights": {
"Mode": "string"
},
"ScheduledQueryArn": "string"
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) **
Nicht verwendet
Typ: Zeichenfolge
Längenbeschränkungen: Mindestlänge von 32. Maximale Länge beträgt 128 Zeichen.
Erforderlich: Nein
** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) **
Der Zeitstempel in UTC. Die Abfrage wird so ausgeführt, als ob sie zu diesem Zeitstempel aufgerufen worden wäre.
Typ: Zeitstempel
Erforderlich: Ja
** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) **
Kapselt Einstellungen für die Aktivierung. `QueryInsights`
Wenn Sie Insights und Metriken als Teil der Amazon SNS SNS-Benachrichtigung für die von Ihnen ausgeführte Abfrage aktivieren`QueryInsights`. Sie können es verwenden`QueryInsights`, um die Leistung und die Kosten Ihrer Abfrage zu optimieren.
Typ: [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) Objekt
Erforderlich: Nein
** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) **
ARN der geplanten Abfrage.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Erforderlich: Ja
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.
HTTP-Statuscode: 400
** InternalServerException **
Bei der Bearbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ResourceNotFoundException **
Die angeforderte Ressource wurde nicht gefunden.
** ScheduledQueryArn **
Der ARN der geplanten Abfrage.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Beispiele
### Geplante Abfragebenachrichtigung für den Modus ENABLED\$1WITH\$1RATE\$1CONTROL
Das folgende Beispiel zeigt eine erfolgreiche Benachrichtigung über eine geplante Abfrage für den Modus des Parameters. `ENABLED_WITH_RATE_CONTROL` `QueryInsights`
```
"SuccessNotificationMessage": {
"type": "MANUAL_TRIGGER_SUCCESS",
"arn": "arn:aws:timestream:::scheduled-query/sq-test-49c6ed55-c2e7-4cc2-9956-4a0ecea13420-80e05b035236a4c3",
"scheduledQueryRunSummary": {
"invocationEpochSecond": 1723710546,
"triggerTimeMillis": 1723710547490,
"runStatus": "MANUAL_TRIGGER_SUCCESS",
"executionStats": {
"executionTimeInMillis": 17343,
"dataWrites": 1024,
"bytesMetered": 0,
"cumulativeBytesScanned": 600,
"recordsIngested": 1,
"queryResultRows": 1
},
"queryInsightsResponse": {
"querySpatialCoverage": {
"max": {
"value": 1.0,
"tableArn": "arn:aws:timestream:::database/BaseDb/table/BaseTable",
"partitionKey": [
"measure_name"
]
}
},
"queryTemporalRange": {
"max": {
"value": 2399999999999,
"tableArn": "arn:aws:timestream:::database/BaseDb/table/BaseTable"
}
},
"queryTableCount": 1,
"outputRows": 1,
"outputBytes": 59
}
}
}
```
### Benachrichtigung über geplante Abfragen für den Modus DISABLED
Das folgende Beispiel zeigt eine erfolgreiche Benachrichtigung über eine geplante Abfrage für den `DISABLED` Modus des `QueryInsights` Parameters.
```
"SuccessNotificationMessage": {
"type": "MANUAL_TRIGGER_SUCCESS",
"arn": "arn:aws:timestream:::scheduled-query/sq-test-fa109d9e-6528-4a0d-ac40-482fa05e657f-140faaeecdc5b2a7",
"scheduledQueryRunSummary": {
"invocationEpochSecond": 1723711401,
"triggerTimeMillis": 1723711402144,
"runStatus": "MANUAL_TRIGGER_SUCCESS",
"executionStats": {
"executionTimeInMillis": 17992,
"dataWrites": 1024,
"bytesMetered": 0,
"cumulativeBytesScanned": 600,
"recordsIngested": 1,
"queryResultRows": 1
}
}
}
```
### Fehlerbenachrichtigung für den Modus ENABLED\$1WITH\$1RATE\$1CONTROL
Das folgende Beispiel zeigt eine Benachrichtigung über eine fehlgeschlagene geplante Abfrage für den Modus des Parameters. `ENABLED_WITH_RATE_CONTROL` `QueryInsights`
```
"FailureNotificationMessage": {
"type": "MANUAL_TRIGGER_FAILURE",
"arn": "arn:aws:timestream:::scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d",
"scheduledQueryRunSummary": {
"invocationEpochSecond": 1727915513,
"triggerTimeMillis": 1727915513894,
"runStatus": "MANUAL_TRIGGER_FAILURE",
"executionStats": {
"executionTimeInMillis": 10777,
"dataWrites": 0,
"bytesMetered": 0,
"cumulativeBytesScanned": 0,
"recordsIngested": 0,
"queryResultRows": 4
},
"errorReportLocation": {
"s3ReportLocation": {
"bucketName": "amzn-s3-demo-bucket",
"objectKey": "4my-organization-f7a3c5d065a1a95e/1727915513/MANUAL/1727915513894/5e14b3df-b147-49f4-9331-784f749b68ae"
}
},
"failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details"
}
}
```
### Fehlerbenachrichtigung für den DISABLED-Modus
Das folgende Beispiel zeigt eine Benachrichtigung über eine fehlgeschlagene geplante Abfrage für den `DISABLED` Modus des `QueryInsights` Parameters.
```
"FailureNotificationMessage": {
"type": "MANUAL_TRIGGER_FAILURE",
"arn": "arn:aws:timestream:::scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d",
"scheduledQueryRunSummary": {
"invocationEpochSecond": 1727915194,
"triggerTimeMillis": 1727915195119,
"runStatus": "MANUAL_TRIGGER_FAILURE",
"executionStats": {
"executionTimeInMillis": 10777,
"dataWrites": 0,
"bytesMetered": 0,
"cumulativeBytesScanned": 0,
"recordsIngested": 0,
"queryResultRows": 4
},
"errorReportLocation": {
"s3ReportLocation": {
"bucketName": "amzn-s3-demo-bucket",
"objectKey": "4my-organization-b7e27a1d79be226d/1727915194/MANUAL/1727915195119/08dea9f5-9a0a-4e63-a5f7-ded23247bb98"
}
},
"failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details"
}
}
```
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecuteScheduledQuery)
# ListScheduledQueries
Ruft eine Liste aller geplanten Abfragen im Amazon-Konto und in der Region des Anrufers ab. `ListScheduledQueries`ist letztendlich konsistent.
## Anforderungssyntax
```
{
"MaxResults": number,
"NextToken": "string"
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) **
Die maximale Anzahl von Elementen, die in der Ausgabe zurückgegeben werden sollen. Wenn die Gesamtzahl der verfügbaren Elemente den angegebenen Wert überschreitet, `NextToken` wird in der Ausgabe ein Wert bereitgestellt. Um die Paginierung fortzusetzen, geben Sie den `NextToken` Wert als Argument für den nachfolgenden Aufruf von an an an an`ListScheduledQueriesRequest`.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 1. Maximaler Wert von 1 000.
Erforderlich: Nein
** [NextToken](#API_query_ListScheduledQueries_RequestSyntax) **
Ein Paginierungstoken, um die Paginierung fortzusetzen.
Typ: Zeichenfolge
Erforderlich: Nein
## Antwortsyntax
```
{
"NextToken": "string",
"ScheduledQueries": [
{
"Arn": "string",
"CreationTime": number,
"ErrorReportConfiguration": {
"S3Configuration": {
"BucketName": "string",
"EncryptionOption": "string",
"ObjectKeyPrefix": "string"
}
},
"LastRunStatus": "string",
"Name": "string",
"NextInvocationTime": number,
"PreviousInvocationTime": number,
"State": "string",
"TargetDestination": {
"TimestreamDestination": {
"DatabaseName": "string",
"TableName": "string"
}
}
}
]
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [NextToken](#API_query_ListScheduledQueries_ResponseSyntax) **
Ein Token für den Beginn der Seitennummerierung. Dies ist das Ergebnis NextToken einer zuvor gekürzten Antwort.
Typ: Zeichenfolge
** [ScheduledQueries](#API_query_ListScheduledQueries_ResponseSyntax) **
Eine Liste von geplanten Abfragen.
Typ: Array von [ScheduledQuery](API_query_ScheduledQuery.md)-Objekten
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.
HTTP-Statuscode: 400
** InternalServerException **
Bei der Bearbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListScheduledQueries)
# ListTagsForResource
Listet alle Tags in einer Timestream-Abfrageressource auf.
## Anforderungssyntax
```
{
"MaxResults": number,
"NextToken": "string",
"ResourceARN": "string"
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) **
Die maximale Anzahl von Tags, die zurückgegeben werden sollen.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 1. Maximalwert 200.
Erforderlich: Nein
** [NextToken](#API_query_ListTagsForResource_RequestSyntax) **
Ein Paginierungstoken zur Wiederaufnahme der Paginierung.
Typ: Zeichenfolge
Erforderlich: Nein
** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) **
Die Timestream-Ressource mit den Tags, die aufgelistet werden sollen. Dieser Wert ist ein Amazon-Ressourcenname (ARN).
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Erforderlich: Ja
## Antwortsyntax
```
{
"NextToken": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [NextToken](#API_query_ListTagsForResource_ResponseSyntax) **
Ein Paginierungstoken, um die Paginierung mit einem nachfolgenden Aufruf von fortzusetzen. `ListTagsForResourceResponse`
Typ: Zeichenfolge
** [Tags](#API_query_ListTagsForResource_ResponseSyntax) **
Die aktuell mit der Timestream-Ressource verknüpften Tags.
Typ: Array von [Tag](API_query_Tag.md)-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ResourceNotFoundException **
Die angeforderte Ressource wurde nicht gefunden.
** ScheduledQueryArn **
Der ARN der geplanten Abfrage.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListTagsForResource)
# PrepareQuery
Ein synchroner Vorgang, mit dem Sie eine Abfrage mit Parametern senden können, die von Timestream für die spätere Ausführung gespeichert werden sollen. Timestream unterstützt nur die Verwendung dieses Vorgangs mit `ValidateOnly` der Einstellung auf. `true`
## Anforderungssyntax
```
{
"QueryString": "string",
"ValidateOnly": boolean
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [QueryString](#API_query_PrepareQuery_RequestSyntax) **
Die Timestream-Abfragezeichenfolge, die Sie als vorbereitete Anweisung verwenden möchten. Parameternamen können in der Abfragezeichenfolge `@` Zeichen gefolgt von einer Kennung angegeben werden.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 262144.
Erforderlich: Ja
** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) **
Wenn Sie diesen Wert auf festlegen`true`, überprüft Timestream nur, ob es sich bei der Abfragezeichenfolge um eine gültige Timestream-Abfrage handelt, und speichert die vorbereitete Abfrage nicht für die spätere Verwendung.
Typ: Boolesch
Erforderlich: Nein
## Antwortsyntax
```
{
"Columns": [
{
"Aliased": boolean,
"DatabaseName": "string",
"Name": "string",
"TableName": "string",
"Type": {
"ArrayColumnInfo": {
"Name": "string",
"Type": "Type"
},
"RowColumnInfo": [
{
"Name": "string",
"Type": "Type"
}
],
"ScalarType": "string",
"TimeSeriesMeasureValueColumnInfo": {
"Name": "string",
"Type": "Type"
}
}
}
],
"Parameters": [
{
"Name": "string",
"Type": {
"ArrayColumnInfo": {
"Name": "string",
"Type": "Type"
},
"RowColumnInfo": [
{
"Name": "string",
"Type": "Type"
}
],
"ScalarType": "string",
"TimeSeriesMeasureValueColumnInfo": {
"Name": "string",
"Type": "Type"
}
}
}
],
"QueryString": "string"
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [Columns](#API_query_PrepareQuery_ResponseSyntax) **
Eine Liste von SELECT-Klauselspalten der übermittelten Abfragezeichenfolge.
Typ: Array von [SelectColumn](API_query_SelectColumn.md)-Objekten
** [Parameters](#API_query_PrepareQuery_ResponseSyntax) **
Eine Liste von Parametern, die in der übermittelten Abfragezeichenfolge verwendet wurden.
Typ: Array von [ParameterMapping](API_query_ParameterMapping.md)-Objekten
** [QueryString](#API_query_PrepareQuery_ResponseSyntax) **
Die Abfragezeichenfolge, die Sie vorbereiten möchten.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 262144.
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.
HTTP-Statuscode: 400
** InternalServerException **
Bei der Bearbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/PrepareQuery)
# Query
`Query`ist ein synchroner Vorgang, mit dem Sie eine Abfrage für Ihre Amazon Timestream Timestream-Daten ausführen können.
Wenn Sie diese API aktiviert haben`QueryInsights`, gibt sie auch Erkenntnisse und Metriken zurück, die sich auf die von Ihnen ausgeführte Abfrage beziehen. `QueryInsights`hilft bei der Leistungsoptimierung Ihrer Abfrage. Weitere Informationen `QueryInsights` dazu finden Sie unter [Verwenden von Abfrageerkenntnissen zur Optimierung von Abfragen in Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).
**Anmerkung**
Die maximale Anzahl von `Query` API-Anfragen, die Sie bei `QueryInsights` aktivierter Option stellen dürfen, beträgt 1 Abfrage pro Sekunde (QPS). Wenn Sie diese Abfragerate überschreiten, kann dies zu einer Drosselung führen.
`Query`wird nach 60 Sekunden ein Timeout ausgelöst. Sie müssen das Standard-Timeout im SDK so aktualisieren, dass es ein Timeout von 60 Sekunden unterstützt. Einzelheiten finden Sie im [Codebeispiel](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html).
Ihre Abfrageanfrage schlägt in den folgenden Fällen fehl:
+ Wenn Sie eine `Query` Anfrage mit demselben Client-Token außerhalb des 5-minütigen Idempotenzfensters einreichen.
+ Wenn Sie innerhalb des 5-minütigen Idempotenzfensters eine `Query` Anfrage mit demselben Client-Token einreichen, aber andere Parameter ändern.
+ Wenn die Größe der Zeile (einschließlich der Abfrage-Metadaten) 1 MB überschreitet, schlägt die Abfrage fehl und die folgende Fehlermeldung wird angezeigt:
`Query aborted as max page response size has been exceeded by the output result row`
+ Wenn der IAM-Prinzipal des Abfrageinitiators und des Ergebnislesers nicht identisch sind, and/or der Abfrageinitiator und der Ergebnisleser nicht dieselbe Abfragezeichenfolge in den Abfrageanforderungen haben, schlägt die Abfrage mit einem Fehler fehl. `Invalid pagination token`
## Anforderungssyntax
```
{
"ClientToken": "string",
"MaxRows": number,
"NextToken": "string",
"QueryInsights": {
"Mode": "string"
},
"QueryString": "string"
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [ClientToken](#API_query_Query_RequestSyntax) **
Eindeutige Zeichenfolge mit bis zu 64 ASCII-Zeichen, bei der Groß- und Kleinschreibung berücksichtigt wird, wenn eine Anfrage gestellt wird. `Query` *Die Angabe von a `ClientToken` macht den Aufruf idempotent. `Query`* Das bedeutet, dass das wiederholte Ausführen derselben Abfrage zum gleichen Ergebnis führt. Mit anderen Worten, das Stellen mehrerer identischer `Query` Anfragen hat den gleichen Effekt wie das Stellen einer einzelnen Anfrage. Beachten Sie `ClientToken` bei der Verwendung in einer Abfrage Folgendes:
+ Wenn die Abfrage-API ohne a instanziiert wird`ClientToken`, generiert das Query-SDK in `ClientToken` Ihrem Namen eine.
+ Wenn der `Query` Aufruf nur die, `ClientToken` aber keine enthält, wird davon ausgegangen`NextToken`, dass es sich bei diesem Aufruf von um einen neuen Abfragelauf `Query` handelt.
+ Wenn der Aufruf Folgendes enthält`NextToken`, wird davon ausgegangen, dass es sich bei diesem speziellen Aufruf um einen nachfolgenden Aufruf eines vorherigen Aufrufs der Abfrage-API handelt, und es wird eine Ergebnismenge zurückgegeben.
+ Nach 4 Stunden `ClientToken` wird jede Anfrage mit demselben Inhalt wie eine neue Anfrage behandelt.
Typ: Zeichenfolge
Längenbeschränkungen: Mindestlänge von 32. Maximale Länge beträgt 128 Zeichen.
Erforderlich: Nein
** [MaxRows](#API_query_Query_RequestSyntax) **
Die Gesamtzahl der Zeilen, die in der `Query` Ausgabe zurückgegeben werden sollen. Bei der ersten Ausführung von `Query` mit einem angegebenen `MaxRows` Wert wird in zwei Fällen die Ergebnismenge der Abfrage zurückgegeben:
+ Die Größe des Ergebnisses ist kleiner als`1MB`.
+ Die Anzahl der Zeilen in der Ergebnismenge ist geringer als der Wert von`maxRows`.
Andernfalls gibt der erste Aufruf von `Query` only a zurück`NextToken`, das dann in nachfolgenden Aufrufen zum Abrufen der Ergebnismenge verwendet werden kann. Um die Paginierung fortzusetzen, geben Sie den `NextToken` Wert im nachfolgenden Befehl ein.
Wenn die Zeilengröße groß ist (z. B. eine Zeile hat viele Spalten), gibt Timestream möglicherweise weniger Zeilen zurück, um zu verhindern, dass die Antwortgröße die Grenze von 1 MB überschreitet. Wenn nicht `MaxRows` angegeben, sendet Timestream die erforderliche Anzahl von Zeilen, um das Limit von 1 MB einzuhalten.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 1. Maximaler Wert von 1 000.
Erforderlich: Nein
** [NextToken](#API_query_Query_RequestSyntax) **
Ein Paginierungstoken, das verwendet wird, um eine Reihe von Ergebnissen zurückzugeben. Wenn die `Query` API mit aufgerufen wird, wird davon ausgegangen`NextToken`, dass es sich bei diesem bestimmten Aufruf um einen nachfolgenden Aufruf eines vorherigen Aufrufs von handelt`Query`, und es wird eine Ergebnismenge zurückgegeben. Wenn der `Query` Aufruf jedoch nur den enthält, `Query` wird davon ausgegangen`ClientToken`, dass es sich bei diesem Aufruf von um einen neuen Abfragelauf handelt.
Beachten Sie bei der Verwendung NextToken in einer Abfrage Folgendes:
+ Ein Paginierungstoken kann für bis zu fünf `Query` Aufrufe ODER für eine Dauer von bis zu 1 Stunde verwendet werden — je nachdem, was zuerst eintritt.
+ Wenn Sie dasselbe verwenden, `NextToken` wird derselbe Satz von Datensätzen zurückgegeben. Um die Ergebnismenge weiterhin paginieren zu können, müssen Sie die neueste Version verwenden. `nextToken`
+ Angenommen, ein `Query` Aufruf gibt zwei `NextToken` Werte zurück, und. `TokenA` `TokenB` Wenn in einem nachfolgenden `Query` Aufruf verwendet `TokenB` wird, `TokenA` ist es ungültig und kann nicht wiederverwendet werden.
+ Um nach Beginn der Paginierung eine vorherige Ergebnismenge aus einer Abfrage anzufordern, müssen Sie die Abfrage-API erneut aufrufen.
+ Die neueste Version `NextToken` sollte verwendet werden, um zu paginieren, bis sie zurückgegeben `null` wird. Ab diesem Zeitpunkt sollte eine neue `NextToken` Version verwendet werden.
+ Wenn der IAM-Prinzipal des Abfrageinitiators und des Ergebnislesers nicht identisch sind, and/or der Abfrageinitiator und der Ergebnisleser nicht dieselbe Abfragezeichenfolge in den Abfrageanforderungen haben, schlägt die Abfrage mit einem Fehler fehl. `Invalid pagination token`
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Erforderlich: Nein
** [QueryInsights](#API_query_Query_RequestSyntax) **
Kapselt Einstellungen für die Aktivierung. `QueryInsights`
Durch die Aktivierung werden zusätzlich zu den Abfrageergebnissen für die von Ihnen ausgeführte Abfrage auch Erkenntnisse und Metriken `QueryInsights` zurückgegeben. Sie können es verwenden`QueryInsights`, um Ihre Abfrageleistung zu optimieren.
Typ: [QueryInsights](API_query_QueryInsights.md) Objekt
Erforderlich: Nein
** [QueryString](#API_query_Query_RequestSyntax) **
Die Abfrage, die von Timestream ausgeführt werden soll.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 262144.
Erforderlich: Ja
## Antwortsyntax
```
{
"ColumnInfo": [
{
"Name": "string",
"Type": {
"ArrayColumnInfo": "ColumnInfo",
"RowColumnInfo": [
"ColumnInfo"
],
"ScalarType": "string",
"TimeSeriesMeasureValueColumnInfo": "ColumnInfo"
}
}
],
"NextToken": "string",
"QueryId": "string",
"QueryInsightsResponse": {
"OutputBytes": number,
"OutputRows": number,
"QuerySpatialCoverage": {
"Max": {
"PartitionKey": [ "string" ],
"TableArn": "string",
"Value": number
}
},
"QueryTableCount": number,
"QueryTemporalRange": {
"Max": {
"TableArn": "string",
"Value": number
}
},
"UnloadPartitionCount": number,
"UnloadWrittenBytes": number,
"UnloadWrittenRows": number
},
"QueryStatus": {
"CumulativeBytesMetered": number,
"CumulativeBytesScanned": number,
"ProgressPercentage": number
},
"Rows": [
{
"Data": [
{
"ArrayValue": [
"Datum"
],
"NullValue": boolean,
"RowValue": "Row",
"ScalarValue": "string",
"TimeSeriesValue": [
{
"Time": "string",
"Value": "Datum"
}
]
}
]
}
]
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [ColumnInfo](#API_query_Query_ResponseSyntax) **
Die Spaltendatentypen der zurückgegebenen Ergebnismenge.
Typ: Array von [ColumnInfo](API_query_ColumnInfo.md)-Objekten
** [NextToken](#API_query_Query_ResponseSyntax) **
Ein Paginierungstoken, das bei einem `Query` Aufruf erneut verwendet werden kann, um die nächsten Ergebnisse abzurufen.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
** [QueryId](#API_query_Query_ResponseSyntax) **
Eine eindeutige ID für die angegebene Abfrage.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `[a-zA-Z0-9]+`
** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) **
Kapselt, `QueryInsights` die Erkenntnisse und Metriken zu der von Ihnen ausgeführten Abfrage enthalten.
Typ: [QueryInsightsResponse](API_query_QueryInsightsResponse.md) Objekt
** [QueryStatus](#API_query_Query_ResponseSyntax) **
Informationen zum Status der Abfrage, einschließlich des Fortschritts und der gescannten Byte.
Typ: [QueryStatus](API_query_QueryStatus.md) Objekt
** [Rows](#API_query_Query_ResponseSyntax) **
Die von der Abfrage zurückgegebenen Ergebnismengenzeilen.
Typ: Array von [Row](API_query_Row.md)-Objekten
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.
HTTP-Statuscode: 400
** ConflictException **
Die Ergebnisse für eine stornierte Abfrage konnten nicht abgefragt werden.
HTTP-Statuscode: 400
** InternalServerException **
Bei der Verarbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** QueryExecutionException **
Timestream konnte die Abfrage nicht erfolgreich ausführen.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/Query)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/Query)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Query)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/Query)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Query)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/Query)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/Query)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/Query)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/Query)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Query)
# TagResource
Ordnen Sie einer Timestream-Ressource eine Reihe von Tags zu. Anschließend können Sie diese benutzerdefinierten Tags aktivieren, sodass sie in der Billing and Cost Management-Konsole zur Nachverfolgung der Kostenzuweisung angezeigt werden.
## Anforderungssyntax
```
{
"ResourceARN": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [ResourceARN](#API_query_TagResource_RequestSyntax) **
Identifiziert die Timestream-Ressource, zu der Tags hinzugefügt werden sollen. Dieser Wert ist ein Amazon-Ressourcenname (ARN).
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Erforderlich: Ja
** [Tags](#API_query_TagResource_RequestSyntax) **
Die Tags, die der Timestream-Ressource zugewiesen werden sollen.
Typ: Array von [Tag](API_query_Tag.md)-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.
Erforderlich: Ja
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ResourceNotFoundException **
Die angeforderte Ressource wurde nicht gefunden.
** ScheduledQueryArn **
Der ARN der geplanten Abfrage.
HTTP-Statuscode: 400
** ServiceQuotaExceededException **
Sie haben das Dienstkontingent überschritten.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/TagResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/TagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TagResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/TagResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TagResource)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/TagResource)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/TagResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/TagResource)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/TagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TagResource)
# UntagResource
Entfernt die Zuordnung von Tags aus einer Timestream-Abfrageressource.
## Anforderungssyntax
```
{
"ResourceARN": "string",
"TagKeys": [ "string" ]
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [ResourceARN](#API_query_UntagResource_RequestSyntax) **
Die Timestream-Ressource, aus der die Tags entfernt werden. Dieser Wert ist ein Amazon-Ressourcenname (ARN).
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Erforderlich: Ja
** [TagKeys](#API_query_UntagResource_RequestSyntax) **
Eine Liste von Tag-Schlüsseln. Bestehende Tags der Ressource, deren Schlüssel Mitglieder dieser Liste sind, werden aus der Timestream-Ressource entfernt.
Typ: Zeichenfolgen-Array
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Erforderlich: Ja
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ResourceNotFoundException **
Die angeforderte Ressource wurde nicht gefunden.
** ScheduledQueryArn **
Der ARN der geplanten Abfrage.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UntagResource)
# UpdateAccountSettings
Stellt Ihr Konto so um, dass es TCUs für die Preisgestaltung von Abfragen verwendet wird, und ändert die maximale Anzahl an Recheneinheiten für Abfragen, die Sie konfiguriert haben. Wenn Sie den Wert von `MaxQueryTCU` auf eine gewünschte Konfiguration reduzieren, kann es bis zu 24 Stunden dauern, bis der neue Wert wirksam wird.
**Anmerkung**
Nachdem Sie Ihr Konto auf die Verwendung TCUs für Preisabfragen umgestellt haben, können Sie nicht mehr zur Verwendung von gescannten Bytes für die Preisabfrage übergehen.
## Anforderungssyntax
```
{
"MaxQueryTCU": number,
"QueryCompute": {
"ComputeMode": "string",
"ProvisionedCapacity": {
"NotificationConfiguration": {
"RoleArn": "string",
"SnsConfiguration": {
"TopicArn": "string"
}
},
"TargetQueryTCU": number
}
},
"QueryPricingModel": "string"
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) **
Die maximale Anzahl von Recheneinheiten, die der Service zu einem beliebigen Zeitpunkt für die Bearbeitung Ihrer Anfragen verwendet. Um Abfragen ausführen zu können, müssen Sie eine Mindestkapazität von 4 TCU festlegen. Sie können die maximale Anzahl von TCU in Vielfachen von 4 festlegen, z. B. 4, 8, 16, 32 usw. Der unterstützte Höchstwert `MaxQueryTCU` ist 1000. Um eine Erhöhung dieses Soft-Limits zu beantragen, wenden Sie sich an den AWS Support. Informationen zum Standardkontingent für MaxQueryTCU finden Sie unter Standardkontingente. Diese Konfiguration gilt nur für die On-Demand-Nutzung von Timestream Compute Units (). TCUs
Der unterstützte Höchstwert `MaxQueryTCU` ist 1000. Um eine Erhöhung dieses Soft-Limits zu beantragen, wenden Sie sich an den AWS Support. Informationen zum Standardkontingent für finden Sie `maxQueryTCU` unter [Standardkontingente](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.default).
Typ: Ganzzahl
Erforderlich: Nein
** [QueryCompute](#API_query_UpdateAccountSettings_RequestSyntax) **
Ändert die in Ihrem Konto konfigurierten Query-Computing-Einstellungen, einschließlich des Preismodells für Abfragen und der bereitgestellten Timestream-Recheneinheiten (TCUs) in Ihrem Konto. QueryCompute ist nur in der Region Asien-Pazifik (Mumbai) verfügbar.
Diese API ist idempotent, was bedeutet, dass das mehrmalige Stellen derselben Anfrage den gleichen Effekt hat wie das einmalige Stellen der Anfrage.
Typ: [QueryComputeRequest](API_query_QueryComputeRequest.md) Objekt
Erforderlich: Nein
** [QueryPricingModel](#API_query_UpdateAccountSettings_RequestSyntax) **
Das Preismodell für Anfragen in einem Konto.
Der `QueryPricingModel` Parameter wird von mehreren Timestream-Vorgängen verwendet. Der `UpdateAccountSettings` API-Vorgang erkennt jedoch keine anderen Werte als`COMPUTE_UNITS`.
Typ: Zeichenfolge
Zulässige Werte: `BYTES_SCANNED | COMPUTE_UNITS`
Erforderlich: Nein
## Antwortsyntax
```
{
"MaxQueryTCU": number,
"QueryCompute": {
"ComputeMode": "string",
"ProvisionedCapacity": {
"ActiveQueryTCU": number,
"LastUpdate": {
"Status": "string",
"StatusMessage": "string",
"TargetQueryTCU": number
},
"NotificationConfiguration": {
"RoleArn": "string",
"SnsConfiguration": {
"TopicArn": "string"
}
}
}
},
"QueryPricingModel": "string"
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [MaxQueryTCU](#API_query_UpdateAccountSettings_ResponseSyntax) **
Die konfigurierte maximale Anzahl von Recheneinheiten, die der Service zu einem beliebigen Zeitpunkt für die Bearbeitung Ihrer Abfragen verwendet.
Typ: Ganzzahl
** [QueryCompute](#API_query_UpdateAccountSettings_ResponseSyntax) **
Bestätigt die aktualisierten Kontoeinstellungen für die Abfrage von Daten in Ihrem Konto. QueryCompute ist nur in der Region Asien-Pazifik (Mumbai) verfügbar.
Typ: [QueryComputeResponse](API_query_QueryComputeResponse.md) Objekt
** [QueryPricingModel](#API_query_UpdateAccountSettings_ResponseSyntax) **
Das Preismodell für ein Konto.
Typ: Zeichenfolge
Zulässige Werte: `BYTES_SCANNED | COMPUTE_UNITS`
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.
HTTP-Statuscode: 400
** InternalServerException **
Bei der Bearbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateAccountSettings)
# UpdateScheduledQuery
Aktualisieren Sie eine geplante Abfrage.
## Anforderungssyntax
```
{
"ScheduledQueryArn": "string",
"State": "string"
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) **
ARN der geplanten Abfrage.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Erforderlich: Ja
** [State](#API_query_UpdateScheduledQuery_RequestSyntax) **
Status der geplanten Abfrage.
Typ: Zeichenfolge
Zulässige Werte: `ENABLED | DISABLED`
Erforderlich: Ja
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.
HTTP-Statuscode: 400
** InternalServerException **
Bei der Bearbeitung der Anfrage ist ein interner Serverfehler aufgetreten.
HTTP-Statuscode: 400
** InvalidEndpointException **
Der angeforderte Endpunkt ist ungültig.
HTTP-Statuscode: 400
** ResourceNotFoundException **
Die angeforderte Ressource wurde nicht gefunden.
** ScheduledQueryArn **
Der ARN der geplanten Abfrage.
HTTP-Statuscode: 400
** ThrottlingException **
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.
HTTP-Statuscode: 400
** ValidationException **
Ungültige oder falsch formatierte Anfrage.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateScheduledQuery)