

Untuk kemampuan serupa dengan Amazon Timestream LiveAnalytics, pertimbangkan Amazon Timestream untuk InfluxDB. Ini menawarkan konsumsi data yang disederhanakan dan waktu respons kueri milidetik satu digit untuk analitik waktu nyata. Pelajari lebih lanjut [di sini](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Kueri Amazon Timestream
<a name="API_Operations_Amazon_Timestream_Query"></a>

Tindakan berikut didukung oleh Amazon Timestream Query:
+  [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
<a name="API_query_CancelQuery"></a>

 Membatalkan kueri yang telah dikeluarkan. Pembatalan diberikan hanya jika kueri belum selesai berjalan sebelum permintaan pembatalan dikeluarkan. Karena pembatalan adalah operasi idempoten, permintaan pembatalan berikutnya akan mengembalikan a`CancellationMessage`, yang menunjukkan bahwa kueri telah dibatalkan. Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.cancel-query.html) untuk detail. 

## Sintaksis Permintaan
<a name="API_query_CancelQuery_RequestSyntax"></a>

```
{
   "QueryId": "string"
}
```

## Parameter Permintaan
<a name="API_query_CancelQuery_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [QueryId](#API_query_CancelQuery_RequestSyntax) **   <a name="timestream-query_CancelQuery-request-QueryId"></a>
 ID kueri yang perlu dibatalkan. `QueryID`dikembalikan sebagai bagian dari hasil kueri.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.  
Pola: `[a-zA-Z0-9]+`   
Diperlukan: Ya

## Sintaksis Respons
<a name="API_query_CancelQuery_ResponseSyntax"></a>

```
{
   "CancellationMessage": "string"
}
```

## Elemen Respons
<a name="API_query_CancelQuery_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [CancellationMessage](#API_query_CancelQuery_ResponseSyntax) **   <a name="timestream-query_CancelQuery-response-CancellationMessage"></a>
 A `CancellationMessage` dikembalikan ketika `CancelQuery` permintaan untuk kueri yang ditentukan oleh `QueryId` telah dikeluarkan.   
Tipe: String

## Kesalahan
<a name="API_query_CancelQuery_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_CancelQuery_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_CreateScheduledQuery"></a>

 Buat kueri terjadwal yang akan dijalankan atas nama Anda pada jadwal yang dikonfigurasi. Timestream mengasumsikan peran eksekusi yang disediakan sebagai bagian dari `ScheduledQueryExecutionRoleArn` parameter untuk menjalankan kueri. Anda dapat menggunakan `NotificationConfiguration` parameter untuk mengonfigurasi notifikasi untuk operasi kueri terjadwal Anda.

## Sintaksis Permintaan
<a name="API_query_CreateScheduledQuery_RequestSyntax"></a>

```
{
   "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"
      }
   }
}
```

## Parameter Permintaan
<a name="API_query_CreateScheduledQuery_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ClientToken"></a>
Menggunakan ClientToken membuat panggilan ke CreateScheduledQuery idempoten, dengan kata lain, membuat permintaan yang sama berulang kali akan menghasilkan hasil yang sama. Membuat beberapa CreateScheduledQuery permintaan identik memiliki efek yang sama seperti membuat satu permintaan.   
+  Jika CreateScheduledQuery dipanggil tanpa a`ClientToken`, Query SDK menghasilkan atas nama Anda. `ClientToken`
+  Setelah 8 jam, permintaan apa pun dengan hal `ClientToken` yang sama diperlakukan sebagai permintaan baru. 
Tipe: String  
Kendala Panjang: Panjang minimum 32. Panjang maksimum 128.  
Wajib: Tidak

 ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ErrorReportConfiguration"></a>
Konfigurasi untuk pelaporan kesalahan. Laporan kesalahan akan dihasilkan ketika masalah ditemui saat menulis hasil kueri.   
Tipe: Objek [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Wajib: Ya

 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-KmsKeyId"></a>
Kunci Amazon KMS digunakan untuk mengenkripsi sumber daya kueri terjadwal, saat istirahat. Jika kunci Amazon KMS tidak ditentukan, sumber kueri terjadwal akan dienkripsi dengan kunci Amazon KMS milik Timestream. Untuk menentukan kunci KMS, gunakan ID kunci, kunci ARN, nama alias, atau alias ARN. *Saat menggunakan nama alias, awali nama dengan alias/*   
Jika ErrorReportConfiguration digunakan `SSE_KMS` sebagai jenis enkripsi, hal yang sama KmsKeyId digunakan untuk mengenkripsi laporan kesalahan saat istirahat.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.  
Wajib: Tidak

 ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Name"></a>
Nama kueri terjadwal.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.  
Pola: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Wajib: Ya

 ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-NotificationConfiguration"></a>
Konfigurasi pemberitahuan untuk kueri terjadwal. Pemberitahuan dikirim oleh Timestream saat proses kueri selesai, saat status diperbarui atau saat Anda menghapusnya.   
Tipe: Objek [NotificationConfiguration](API_query_NotificationConfiguration.md)  
Wajib: Ya

 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-QueryString"></a>
String query untuk dijalankan. Nama parameter dapat ditentukan dalam `@` karakter string query diikuti oleh identifier. Parameter bernama `@scheduled_runtime` dicadangkan dan dapat digunakan dalam kueri untuk mendapatkan waktu di mana kueri dijadwalkan untuk dijalankan.  
Stempel waktu yang dihitung sesuai dengan ScheduleConfiguration parameter, akan menjadi nilai `@scheduled_runtime` paramater untuk setiap kueri yang dijalankan. Misalnya, pertimbangkan instance kueri terjadwal yang dijalankan pada 2021-12-01 00:00:00. Untuk contoh ini, `@scheduled_runtime` parameter diinisialisasi ke stempel waktu 2021-12-01 00:00:00 saat menjalankan kueri.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 262144.  
Wajib: Ya

 ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduleConfiguration"></a>
Konfigurasi jadwal untuk kueri.  
Tipe: Objek [ScheduleConfiguration](API_query_ScheduleConfiguration.md)  
Wajib: Ya

 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduledQueryExecutionRoleArn"></a>
ARN untuk peran IAM yang Timestream akan asumsikan saat menjalankan kueri terjadwal.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.  
Wajib: Ya

 ** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Tags"></a>
Daftar pasangan kunci-nilai untuk memberi label pada kueri terjadwal.  
Tipe: Array objek [Tag](API_query_Tag.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.  
Wajib: Tidak

 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-TargetConfiguration"></a>
Konfigurasi yang digunakan untuk menulis hasil query.  
Tipe: Objek [TargetConfiguration](API_query_TargetConfiguration.md)  
Wajib: Tidak

## Sintaksis Respons
<a name="API_query_CreateScheduledQuery_ResponseSyntax"></a>

```
{
   "Arn": "string"
}
```

## Elemen Respons
<a name="API_query_CreateScheduledQuery_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) **   <a name="timestream-query_CreateScheduledQuery-response-Arn"></a>
ARN untuk kueri terjadwal yang dibuat.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.

## Kesalahan
<a name="API_query_CreateScheduledQuery_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** ConflictException **   
 Tidak dapat melakukan polling hasil untuk kueri yang dibatalkan.   
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ServiceQuotaExceededException **   
Anda telah melampaui kuota layanan.  
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_CreateScheduledQuery_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_DeleteScheduledQuery"></a>

Menghapus kueri terjadwal yang diberikan. Ini adalah operasi yang tidak dapat diubah. 

## Sintaksis Permintaan
<a name="API_query_DeleteScheduledQuery_RequestSyntax"></a>

```
{
   "ScheduledQueryArn": "string"
}
```

## Parameter Permintaan
<a name="API_query_DeleteScheduledQuery_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) **   <a name="timestream-query_DeleteScheduledQuery-request-ScheduledQueryArn"></a>
ARN dari kueri terjadwal.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.  
Wajib: Ya

## Elemen Respons
<a name="API_query_DeleteScheduledQuery_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_query_DeleteScheduledQuery_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang diminta tidak dapat ditemukan.    
 ** ScheduledQueryArn **   
ARN dari kueri terjadwal.
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_DeleteScheduledQuery_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_DescribeAccountSettings"></a>

Menjelaskan pengaturan untuk akun Anda yang menyertakan model harga kueri dan maksimum yang dikonfigurasi TCUs yang dapat digunakan layanan untuk beban kerja kueri Anda.

Anda dikenakan biaya hanya untuk durasi unit komputasi yang digunakan untuk beban kerja Anda.

## Sintaksis Respons
<a name="API_query_DescribeAccountSettings_ResponseSyntax"></a>

```
{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "ActiveQueryTCU": number,
         "LastUpdate": { 
            "Status": "string",
            "StatusMessage": "string",
            "TargetQueryTCU": number
         },
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         }
      }
   },
   "QueryPricingModel": "string"
}
```

## Elemen Respons
<a name="API_query_DescribeAccountSettings_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [MaxQueryTCU](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-MaxQueryTCU"></a>
Jumlah maksimum [unit komputasi Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/tcu.html) (TCUs) yang akan digunakan layanan kapan saja untuk melayani kueri Anda. Untuk menjalankan kueri, Anda harus menetapkan kapasitas minimum 4 TCU. Anda dapat mengatur jumlah maksimum TCU dalam kelipatan 4, misalnya, 4, 8, 16, 32, dan seterusnya. Konfigurasi ini hanya berlaku untuk penggunaan (TCUs) sesuai permintaan.   
Jenis: Integer

 ** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryCompute"></a>
Objek yang berisi setelan penggunaan untuk Timestream Compute Units (TCUs) di akun Anda untuk beban kerja kueri. QueryCompute hanya tersedia di wilayah Asia Pasifik (Mumbai).  
Tipe: Objek [QueryComputeResponse](API_query_QueryComputeResponse.md)

 ** [QueryPricingModel](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryPricingModel"></a>
Model harga untuk kueri di akun Anda.  
`QueryPricingModel`Parameter ini digunakan oleh beberapa operasi Timestream; namun, operasi `UpdateAccountSettings` API tidak mengenali nilai apa pun selain`COMPUTE_UNITS`.
Tipe: String  
Nilai yang Valid: `BYTES_SCANNED | COMPUTE_UNITS` 

## Kesalahan
<a name="API_query_DescribeAccountSettings_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_DescribeAccountSettings_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_DescribeEndpoints"></a>

DescribeEndpoints mengembalikan daftar titik akhir yang tersedia untuk membuat panggilan API Timestream terhadap. API ini tersedia melalui Write dan Query.

Karena Timestream SDKs dirancang untuk bekerja secara transparan dengan arsitektur layanan, termasuk pengelolaan dan pemetaan titik akhir layanan, *Anda tidak disarankan untuk menggunakan* API ini kecuali:
+ Anda menggunakan [titik akhir VPC ()AWS PrivateLink](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) dengan Timestream 
+ Aplikasi Anda menggunakan bahasa pemrograman yang belum memiliki dukungan SDK
+ Anda memerlukan kontrol yang lebih baik atas implementasi sisi klien

Untuk informasi rinci tentang bagaimana dan kapan menggunakan dan menerapkan DescribeEndpoints, lihat [The Endpoint Discovery Pattern](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery).

## Sintaksis Respons
<a name="API_query_DescribeEndpoints_ResponseSyntax"></a>

```
{
   "Endpoints": [ 
      { 
         "Address": "string",
         "CachePeriodInMinutes": number
      }
   ]
}
```

## Elemen Respons
<a name="API_query_DescribeEndpoints_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Endpoints](#API_query_DescribeEndpoints_ResponseSyntax) **   <a name="timestream-query_DescribeEndpoints-response-Endpoints"></a>
Sebuah `Endpoints` objek dikembalikan ketika `DescribeEndpoints` permintaan dibuat.  
Tipe: Array objek [Endpoint](API_query_Endpoint.md)

## Kesalahan
<a name="API_query_DescribeEndpoints_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_DescribeEndpoints_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_DescribeScheduledQuery"></a>

Memberikan informasi rinci tentang kueri terjadwal.

## Sintaksis Permintaan
<a name="API_query_DescribeScheduledQuery_RequestSyntax"></a>

```
{
   "ScheduledQueryArn": "string"
}
```

## Parameter Permintaan
<a name="API_query_DescribeScheduledQuery_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) **   <a name="timestream-query_DescribeScheduledQuery-request-ScheduledQueryArn"></a>
ARN dari kueri terjadwal.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.  
Wajib: Ya

## Sintaksis Respons
<a name="API_query_DescribeScheduledQuery_ResponseSyntax"></a>

```
{
   "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"
         }
      }
   }
}
```

## Elemen Respons
<a name="API_query_DescribeScheduledQuery_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [ScheduledQuery](#API_query_DescribeScheduledQuery_ResponseSyntax) **   <a name="timestream-query_DescribeScheduledQuery-response-ScheduledQuery"></a>
Permintaan yang dijadwalkan.  
Tipe: Objek [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md)

## Kesalahan
<a name="API_query_DescribeScheduledQuery_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang diminta tidak dapat ditemukan.    
 ** ScheduledQueryArn **   
ARN dari kueri terjadwal.
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_DescribeScheduledQuery_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_ExecuteScheduledQuery"></a>

 Anda dapat menggunakan API ini untuk menjalankan kueri terjadwal secara manual. 

Jika Anda mengaktifkan`QueryInsights`, API ini juga menampilkan insight dan metrik yang terkait dengan kueri yang Anda jalankan sebagai bagian dari notifikasi Amazon SNS. `QueryInsights`membantu penyetelan kinerja kueri Anda. Untuk informasi selengkapnya`QueryInsights`, lihat [Menggunakan wawasan kueri untuk mengoptimalkan kueri di Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).

## Sintaksis Permintaan
<a name="API_query_ExecuteScheduledQuery_RequestSyntax"></a>

```
{
   "ClientToken": "string",
   "InvocationTime": number,
   "QueryInsights": { 
      "Mode": "string"
   },
   "ScheduledQueryArn": "string"
}
```

## Parameter Permintaan
<a name="API_query_ExecuteScheduledQuery_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ClientToken"></a>
Tidak digunakan.   
Tipe: String  
Kendala Panjang: Panjang minimum 32. Panjang maksimum 128.  
Wajib: Tidak

 ** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-InvocationTime"></a>
Stempel waktu di UTC. Kueri akan dijalankan seolah-olah dipanggil pada stempel waktu ini.   
Tipe: Timestamp  
Wajib: Ya

 ** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-QueryInsights"></a>
Merangkum pengaturan untuk mengaktifkan. `QueryInsights`  
Mengaktifkan `QueryInsights` mengembalikan wawasan dan metrik sebagai bagian dari notifikasi Amazon SNS untuk kueri yang Anda jalankan. Anda dapat menggunakan `QueryInsights` untuk menyetel kinerja dan biaya kueri Anda.  
Tipe: Objek [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md)  
Wajib: Tidak

 ** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ScheduledQueryArn"></a>
ARN dari kueri terjadwal.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.  
Wajib: Ya

## Elemen Respons
<a name="API_query_ExecuteScheduledQuery_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_query_ExecuteScheduledQuery_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang diminta tidak dapat ditemukan.    
 ** ScheduledQueryArn **   
ARN dari kueri terjadwal.
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Contoh
<a name="API_query_ExecuteScheduledQuery_Examples"></a>

### Pesan pemberitahuan kueri terjadwal untuk mode ENABLED\$1WITH\$1RATE\$1CONTROL
<a name="API_query_ExecuteScheduledQuery_Example_1"></a>

Contoh berikut menunjukkan pesan notifikasi kueri terjadwal yang berhasil untuk `ENABLED_WITH_RATE_CONTROL` mode `QueryInsights` parameter.

```
"SuccessNotificationMessage": {
    "type": "MANUAL_TRIGGER_SUCCESS",
    "arn": "arn:aws:timestream:<Region>:<Account>: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:<Region>:<Account>:database/BaseDb/table/BaseTable",
                    "partitionKey": [
                        "measure_name"
                    ]
                }
            },
            "queryTemporalRange": {
                "max": {
                    "value": 2399999999999,
                    "tableArn": "arn:aws:timestream:<Region>:<Account>:database/BaseDb/table/BaseTable"
                }
            },
            "queryTableCount": 1,
            "outputRows": 1,
            "outputBytes": 59
        }
    }
}
```

### Pesan pemberitahuan kueri terjadwal untuk mode DISABLED
<a name="API_query_ExecuteScheduledQuery_Example_2"></a>

Contoh berikut menunjukkan pesan notifikasi kueri terjadwal yang berhasil untuk `DISABLED` mode `QueryInsights` parameter.

```
"SuccessNotificationMessage": {
    "type": "MANUAL_TRIGGER_SUCCESS",
    "arn": "arn:aws:timestream:<Region>:<Account>: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
        }
    }
}
```

### Pesan pemberitahuan kegagalan untuk mode ENABLED\$1WITH\$1RATE\$1CONTROL
<a name="API_query_ExecuteScheduledQuery_Example_3"></a>

Contoh berikut menunjukkan pesan pemberitahuan kueri terjadwal gagal untuk `ENABLED_WITH_RATE_CONTROL` mode `QueryInsights` parameter.

```
"FailureNotificationMessage": {
    "type": "MANUAL_TRIGGER_FAILURE",
    "arn": "arn:aws:timestream:<Region>:<Account>: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"
    }
}
```

### Pesan pemberitahuan kegagalan untuk mode DISABLED
<a name="API_query_ExecuteScheduledQuery_Example_4"></a>

Contoh berikut menunjukkan pesan pemberitahuan kueri terjadwal gagal untuk `DISABLED` mode `QueryInsights` parameter.

```
"FailureNotificationMessage": {
    "type": "MANUAL_TRIGGER_FAILURE",
    "arn": "arn:aws:timestream:<Region>:<Account>: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"
    }
}
```

## Lihat Juga
<a name="API_query_ExecuteScheduledQuery_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_ListScheduledQueries"></a>

Mendapat daftar semua kueri terjadwal di akun Amazon dan Wilayah pemanggil. `ListScheduledQueries`pada akhirnya konsisten. 

## Sintaksis Permintaan
<a name="API_query_ListScheduledQueries_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## Parameter Permintaan
<a name="API_query_ListScheduledQueries_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-MaxResults"></a>
Jumlah maksimum item untuk dikembalikan dalam output. Jika jumlah total item yang tersedia lebih dari nilai yang ditentukan, a `NextToken` disediakan dalam output. Untuk melanjutkan pagination, berikan `NextToken` nilai sebagai argumen untuk `ListScheduledQueriesRequest` panggilan berikutnya.  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 1000.  
Wajib: Tidak

 ** [NextToken](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-NextToken"></a>
 Token pagination untuk melanjutkan pagination.  
Tipe: String  
Wajib: Tidak

## Sintaksis Respons
<a name="API_query_ListScheduledQueries_ResponseSyntax"></a>

```
{
   "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"
            }
         }
      }
   ]
}
```

## Elemen Respons
<a name="API_query_ListScheduledQueries_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [NextToken](#API_query_ListScheduledQueries_ResponseSyntax) **   <a name="timestream-query_ListScheduledQueries-response-NextToken"></a>
Token untuk menentukan di mana harus memulai paginating. Ini adalah NextToken dari respons yang sebelumnya terpotong.  
Tipe: String

 ** [ScheduledQueries](#API_query_ListScheduledQueries_ResponseSyntax) **   <a name="timestream-query_ListScheduledQueries-response-ScheduledQueries"></a>
Daftar kueri terjadwal.  
Tipe: Array objek [ScheduledQuery](API_query_ScheduledQuery.md)

## Kesalahan
<a name="API_query_ListScheduledQueries_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_ListScheduledQueries_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_ListTagsForResource"></a>

Daftar semua tag pada sumber kueri Timestream.

## Sintaksis Permintaan
<a name="API_query_ListTagsForResource_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string",
   "ResourceARN": "string"
}
```

## Parameter Permintaan
<a name="API_query_ListTagsForResource_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-MaxResults"></a>
Jumlah maksimum tag untuk dikembalikan.  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 200.  
Wajib: Tidak

 ** [NextToken](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-NextToken"></a>
Token pagination untuk melanjutkan pagination.  
Tipe: String  
Wajib: Tidak

 ** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-ResourceARN"></a>
Sumber daya Timestream dengan tag yang akan dicantumkan. Nilai ini adalah sebuah Amazon Resource Name (ARN).  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.  
Wajib: Ya

## Sintaksis Respons
<a name="API_query_ListTagsForResource_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Elemen Respons
<a name="API_query_ListTagsForResource_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [NextToken](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-NextToken"></a>
Token pagination untuk melanjutkan pagination dengan panggilan berikutnya ke. `ListTagsForResourceResponse`  
Tipe: String

 ** [Tags](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-Tags"></a>
Tag yang saat ini terkait dengan sumber daya Timestream.   
Tipe: Array objek [Tag](API_query_Tag.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.

## Kesalahan
<a name="API_query_ListTagsForResource_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang diminta tidak dapat ditemukan.    
 ** ScheduledQueryArn **   
ARN dari kueri terjadwal.
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_ListTagsForResource_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_PrepareQuery"></a>

Operasi sinkron yang memungkinkan Anda mengirimkan kueri dengan parameter yang akan disimpan oleh Timestream untuk dijalankan nanti. Timestream hanya mendukung penggunaan operasi ini dengan `ValidateOnly` set to`true`. 

## Sintaksis Permintaan
<a name="API_query_PrepareQuery_RequestSyntax"></a>

```
{
   "QueryString": "string",
   "ValidateOnly": boolean
}
```

## Parameter Permintaan
<a name="API_query_PrepareQuery_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [QueryString](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-QueryString"></a>
String query Timestream yang ingin Anda gunakan sebagai pernyataan siap. Nama parameter dapat ditentukan dalam `@` karakter string query diikuti oleh identifier.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 262144.  
Wajib: Ya

 ** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-ValidateOnly"></a>
Dengan menyetel nilai ini`true`, Timestream hanya akan memvalidasi bahwa string kueri adalah kueri Timestream yang valid, dan tidak menyimpan kueri yang disiapkan untuk digunakan nanti.  
Tipe: Boolean  
Wajib: Tidak

## Sintaksis Respons
<a name="API_query_PrepareQuery_ResponseSyntax"></a>

```
{
   "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"
}
```

## Elemen Respons
<a name="API_query_PrepareQuery_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Columns](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Columns"></a>
Daftar kolom klausa SELECT dari string kueri yang dikirimkan.   
Tipe: Array objek [SelectColumn](API_query_SelectColumn.md)

 ** [Parameters](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Parameters"></a>
Daftar parameter yang digunakan dalam string kueri yang dikirimkan.   
Tipe: Array objek [ParameterMapping](API_query_ParameterMapping.md)

 ** [QueryString](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-QueryString"></a>
String kueri yang ingin Anda siapkan.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 262144.

## Kesalahan
<a name="API_query_PrepareQuery_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_PrepareQuery_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_Query"></a>

 `Query`adalah operasi sinkron yang memungkinkan Anda menjalankan kueri terhadap data Amazon Timestream Anda.

Jika Anda mengaktifkan`QueryInsights`, API ini juga menampilkan insight dan metrik yang terkait dengan kueri yang Anda jalankan. `QueryInsights`membantu penyetelan kinerja kueri Anda. Untuk informasi selengkapnya`QueryInsights`, lihat [Menggunakan wawasan kueri untuk mengoptimalkan kueri di Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).

**catatan**  
Jumlah maksimum permintaan `Query` API yang diizinkan untuk Anda buat dengan `QueryInsights` diaktifkan adalah 1 kueri per detik (QPS). Jika Anda melebihi tingkat kueri ini, itu mungkin mengakibatkan pelambatan.

 `Query`akan habis setelah 60 detik. Anda harus memperbarui batas waktu default di SDK untuk mendukung batas waktu 60 detik. Lihat [contoh kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html) untuk detailnya. 

Permintaan kueri Anda akan gagal dalam kasus berikut:
+  Jika Anda mengirimkan `Query` permintaan dengan token klien yang sama di luar jendela idempotensi 5 menit. 
+  Jika Anda mengirimkan `Query` permintaan dengan token klien yang sama, tetapi mengubah parameter lain, dalam jendela idempotensi 5 menit. 
+  Jika ukuran baris (termasuk metadata kueri) melebihi 1 MB, maka kueri akan gagal dengan pesan kesalahan berikut: 

   `Query aborted as max page response size has been exceeded by the output result row` 
+  Jika prinsipal IAM dari inisiator kueri dan pembaca hasil tidak sama and/or dengan inisiator kueri dan pembaca hasil tidak memiliki string kueri yang sama dalam permintaan kueri, kueri akan gagal dengan kesalahan. `Invalid pagination token` 

## Sintaksis Permintaan
<a name="API_query_Query_RequestSyntax"></a>

```
{
   "ClientToken": "string",
   "MaxRows": number,
   "NextToken": "string",
   "QueryInsights": { 
      "Mode": "string"
   },
   "QueryString": "string"
}
```

## Parameter Permintaan
<a name="API_query_Query_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [ClientToken](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-ClientToken"></a>
 String unik dan peka huruf besar/kecil hingga 64 karakter ASCII yang ditentukan saat permintaan dibuat. `Query` `ClientToken`Memberikan panggilan untuk `Query` *idempoten*. Ini berarti bahwa menjalankan kueri yang sama berulang kali akan menghasilkan hasil yang sama. Dengan kata lain, membuat beberapa `Query` permintaan identik memiliki efek yang sama seperti membuat permintaan tunggal. Saat menggunakan `ClientToken` dalam kueri, perhatikan hal berikut:   
+  Jika Query API dipakai tanpa a`ClientToken`, Query SDK akan menghasilkan `ClientToken` atas nama Anda.
+ Jika `Query` pemanggilan hanya berisi `ClientToken` tetapi tidak menyertakan a`NextToken`, pemanggilan tersebut diasumsikan sebagai `Query` kueri baru yang dijalankan.
+ Jika pemanggilan berisi`NextToken`, pemanggilan tertentu diasumsikan sebagai pemanggilan berikutnya dari panggilan sebelumnya ke Query API, dan kumpulan hasil dikembalikan.
+  Setelah 4 jam, permintaan apa pun dengan hal `ClientToken` yang sama diperlakukan sebagai permintaan baru. 
Tipe: String  
Kendala Panjang: Panjang minimum 32. Panjang maksimum 128.  
Wajib: Tidak

 ** [MaxRows](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-MaxRows"></a>
 Jumlah total baris yang akan dikembalikan dalam `Query` output. Proses awal `Query` dengan `MaxRows` nilai yang ditentukan akan mengembalikan kumpulan hasil kueri dalam dua kasus:   
+ Ukuran hasilnya kurang dari`1MB`.
+ Jumlah baris dalam set hasil kurang dari nilai`maxRows`.
Jika tidak, pemanggilan awal `Query` hanya mengembalikan a`NextToken`, yang kemudian dapat digunakan dalam panggilan berikutnya untuk mengambil set hasil. Untuk melanjutkan pagination, berikan `NextToken` nilai dalam perintah berikutnya.  
Jika ukuran baris besar (misalnya baris memiliki banyak kolom), Timestream dapat mengembalikan lebih sedikit baris agar ukuran respons tidak melebihi batas 1 MB. Jika tidak `MaxRows` disediakan, Timestream akan mengirimkan jumlah baris yang diperlukan untuk memenuhi batas 1 MB.  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 1000.  
Wajib: Tidak

 ** [NextToken](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-NextToken"></a>
 Token pagination digunakan untuk mengembalikan serangkaian hasil. Ketika `Query` API dipanggil menggunakan`NextToken`, pemanggilan tertentu diasumsikan sebagai pemanggilan berikutnya dari panggilan sebelumnya`Query`, dan kumpulan hasil dikembalikan. Namun, jika `Query` pemanggilan hanya berisi`ClientToken`, pemanggilan tersebut `Query` diasumsikan sebagai kueri baru yang dijalankan.   
Perhatikan hal berikut saat menggunakan NextToken dalam kueri:  
+ Token pagination dapat digunakan hingga lima `Query` pemanggilan, ATAU untuk durasi hingga 1 jam — mana yang lebih dulu.
+ Menggunakan yang sama `NextToken` akan mengembalikan set catatan yang sama. Untuk terus melakukan paginasi melalui set hasil, Anda harus menggunakan yang terbaru. `nextToken`
+ Misalkan `Query` pemanggilan mengembalikan dua `NextToken` nilai, `TokenA` dan. `TokenB` Jika `TokenB` digunakan dalam `Query` pemanggilan berikutnya, maka tidak valid dan `TokenA` tidak dapat digunakan kembali.
+ Untuk meminta set hasil sebelumnya dari kueri setelah pagination dimulai, Anda harus memanggil kembali Query API.
+ Yang terbaru `NextToken` harus digunakan untuk paginasi sampai `null` dikembalikan, pada titik mana yang baru `NextToken` harus digunakan.
+  Jika prinsipal IAM dari inisiator kueri dan pembaca hasil tidak sama and/or dengan inisiator kueri dan pembaca hasil tidak memiliki string kueri yang sama dalam permintaan kueri, kueri akan gagal dengan kesalahan. `Invalid pagination token` 
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.  
Wajib: Tidak

 ** [QueryInsights](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryInsights"></a>
Merangkum pengaturan untuk mengaktifkan. `QueryInsights`  
Mengaktifkan `QueryInsights` mengembalikan wawasan dan metrik selain hasil kueri untuk kueri yang Anda jalankan. Anda dapat menggunakan `QueryInsights` untuk menyetel kinerja kueri Anda.  
Tipe: Objek [QueryInsights](API_query_QueryInsights.md)  
Wajib: Tidak

 ** [QueryString](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryString"></a>
 Query yang akan dijalankan oleh Timestream.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 262144.  
Wajib: Ya

## Sintaksis Respons
<a name="API_query_Query_ResponseSyntax"></a>

```
{
   "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"
                  }
               ]
            }
         ]
      }
   ]
}
```

## Elemen Respons
<a name="API_query_Query_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [ColumnInfo](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-ColumnInfo"></a>
 Tipe data kolom dari set hasil yang dikembalikan.   
Tipe: Array objek [ColumnInfo](API_query_ColumnInfo.md)

 ** [NextToken](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-NextToken"></a>
 Token pagination yang dapat digunakan lagi pada `Query` panggilan untuk mendapatkan set hasil berikutnya.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.

 ** [QueryId](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryId"></a>
 ID unik untuk kueri yang diberikan.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.  
Pola: `[a-zA-Z0-9]+` 

 ** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryInsightsResponse"></a>
Merangkum `QueryInsights` berisi wawasan dan metrik yang terkait dengan kueri yang Anda jalankan.  
Tipe: Objek [QueryInsightsResponse](API_query_QueryInsightsResponse.md)

 ** [QueryStatus](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryStatus"></a>
Informasi tentang status kueri, termasuk kemajuan dan byte yang dipindai.  
Tipe: Objek [QueryStatus](API_query_QueryStatus.md)

 ** [Rows](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-Rows"></a>
 Hasil set baris dikembalikan oleh query.   
Tipe: Array objek [Row](API_query_Row.md)

## Kesalahan
<a name="API_query_Query_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** ConflictException **   
 Tidak dapat melakukan polling hasil untuk kueri yang dibatalkan.   
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** QueryExecutionException **   
 Timestream tidak dapat menjalankan kueri dengan sukses.   
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_Query_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/Query) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_TagResource"></a>

Kaitkan satu set tag dengan sumber daya Timestream. Anda kemudian dapat mengaktifkan tag yang ditentukan pengguna ini sehingga muncul di konsol Billing and Cost Management untuk melacak alokasi biaya. 

## Sintaksis Permintaan
<a name="API_query_TagResource_RequestSyntax"></a>

```
{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parameter Permintaan
<a name="API_query_TagResource_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [ResourceARN](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-ResourceARN"></a>
Mengidentifikasi sumber daya Timestream yang tag harus ditambahkan. Nilai ini adalah sebuah Amazon Resource Name (ARN).  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.  
Wajib: Ya

 ** [Tags](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-Tags"></a>
Tag yang akan ditetapkan ke sumber daya Timestream.  
Tipe: Array objek [Tag](API_query_Tag.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.  
Wajib: Ya

## Elemen Respons
<a name="API_query_TagResource_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_query_TagResource_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang diminta tidak dapat ditemukan.    
 ** ScheduledQueryArn **   
ARN dari kueri terjadwal.
Kode Status HTTP: 400

 ** ServiceQuotaExceededException **   
Anda telah melampaui kuota layanan.  
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_TagResource_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_UntagResource"></a>

Menghapus asosiasi tag dari sumber kueri Timestream.

## Sintaksis Permintaan
<a name="API_query_UntagResource_RequestSyntax"></a>

```
{
   "ResourceARN": "string",
   "TagKeys": [ "string" ]
}
```

## Parameter Permintaan
<a name="API_query_UntagResource_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [ResourceARN](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-ResourceARN"></a>
Sumber daya Timestream tempat tag akan dihapus. Nilai ini adalah sebuah Amazon Resource Name (ARN).   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.  
Wajib: Ya

 ** [TagKeys](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-TagKeys"></a>
Daftar kunci tag. Tag yang ada dari sumber daya yang kuncinya adalah anggota daftar ini akan dihapus dari sumber daya Timestream.   
Tipe: Array string  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.  
Wajib: Ya

## Elemen Respons
<a name="API_query_UntagResource_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_query_UntagResource_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang diminta tidak dapat ditemukan.    
 ** ScheduledQueryArn **   
ARN dari kueri terjadwal.
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_UntagResource_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_UpdateAccountSettings"></a>

Transisi akun Anda untuk digunakan TCUs untuk harga kueri dan memodifikasi unit komputasi kueri maksimum yang telah Anda konfigurasi. Jika Anda mengurangi nilai `MaxQueryTCU` ke konfigurasi yang diinginkan, nilai baru dapat memakan waktu hingga 24 jam untuk menjadi efektif.

**catatan**  
Setelah mentransisikan akun untuk digunakan TCUs untuk harga kueri, Anda tidak dapat beralih menggunakan byte yang dipindai untuk harga kueri.

## Sintaksis Permintaan
<a name="API_query_UpdateAccountSettings_RequestSyntax"></a>

```
{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         },
         "TargetQueryTCU": number
      }
   },
   "QueryPricingModel": "string"
}
```

## Parameter Permintaan
<a name="API_query_UpdateAccountSettings_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-MaxQueryTCU"></a>
Jumlah maksimum unit komputasi yang akan digunakan layanan kapan saja untuk melayani pertanyaan Anda. Untuk menjalankan kueri, Anda harus menetapkan kapasitas minimum 4 TCU. Anda dapat mengatur jumlah maksimum TCU dalam kelipatan 4, misalnya, 4, 8, 16, 32, dan seterusnya. Nilai maksimum yang didukung `MaxQueryTCU` adalah 1000. Untuk meminta peningkatan batas lunak ini, hubungi AWS Support. Untuk informasi tentang kuota default untuk maxQueryTCU, lihat Kuota default. Konfigurasi ini hanya berlaku untuk penggunaan Timestream Compute Units () sesuai permintaan. TCUs  
Nilai maksimum yang didukung `MaxQueryTCU` adalah 1000. Untuk meminta peningkatan batas lunak ini, hubungi AWS Support. Untuk informasi tentang kuota default`maxQueryTCU`, lihat [Kuota default](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.default).  
Tipe: Integer  
Wajib: Tidak

 ** [QueryCompute](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryCompute"></a>
Memodifikasi setelan komputasi kueri yang dikonfigurasi di akun Anda, termasuk model harga kueri dan Unit Komputasi Timestream () yang disediakan di akun Anda. TCUs QueryCompute hanya tersedia di wilayah Asia Pasifik (Mumbai).  
API ini idempoten, artinya membuat permintaan yang sama beberapa kali akan memiliki efek yang sama seperti membuat permintaan sekali.
Tipe: Objek [QueryComputeRequest](API_query_QueryComputeRequest.md)  
Wajib: Tidak

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryPricingModel"></a>
Model harga untuk kueri di akun.  
`QueryPricingModel`Parameter ini digunakan oleh beberapa operasi Timestream; namun, operasi `UpdateAccountSettings` API tidak mengenali nilai apa pun selain`COMPUTE_UNITS`.
Tipe: String  
Nilai yang Valid: `BYTES_SCANNED | COMPUTE_UNITS`   
Wajib: Tidak

## Sintaksis Respons
<a name="API_query_UpdateAccountSettings_ResponseSyntax"></a>

```
{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "ActiveQueryTCU": number,
         "LastUpdate": { 
            "Status": "string",
            "StatusMessage": "string",
            "TargetQueryTCU": number
         },
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         }
      }
   },
   "QueryPricingModel": "string"
}
```

## Elemen Respons
<a name="API_query_UpdateAccountSettings_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-MaxQueryTCU"></a>
Jumlah maksimum unit komputasi yang dikonfigurasi yang akan digunakan layanan kapan saja untuk melayani kueri Anda.  
Jenis: Integer

 ** [QueryCompute](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryCompute"></a>
Mengonfirmasi pengaturan akun yang diperbarui untuk menanyakan data di akun Anda. QueryCompute hanya tersedia di wilayah Asia Pasifik (Mumbai).  
Tipe: Objek [QueryComputeResponse](API_query_QueryComputeResponse.md)

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryPricingModel"></a>
Model harga untuk sebuah akun.  
Tipe: String  
Nilai yang Valid: `BYTES_SCANNED | COMPUTE_UNITS` 

## Kesalahan
<a name="API_query_UpdateAccountSettings_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_UpdateAccountSettings_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK para 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 untuk 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
<a name="API_query_UpdateScheduledQuery"></a>

Perbarui kueri terjadwal.

## Sintaksis Permintaan
<a name="API_query_UpdateScheduledQuery_RequestSyntax"></a>

```
{
   "ScheduledQueryArn": "string",
   "State": "string"
}
```

## Parameter Permintaan
<a name="API_query_UpdateScheduledQuery_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-ScheduledQueryArn"></a>
ARN dari kueri terjadwal.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.  
Wajib: Ya

 ** [State](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-State"></a>
Status kueri terjadwal.   
Tipe: String  
Nilai yang Valid: `ENABLED | DISABLED`   
Wajib: Ya

## Elemen Respons
<a name="API_query_UpdateScheduledQuery_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_query_UpdateScheduledQuery_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang diminta tidak dapat ditemukan.    
 ** ScheduledQueryArn **   
ARN dari kueri terjadwal.
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_UpdateScheduledQuery_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK para 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 untuk 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) 