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.
# Amazon Timestream Menulis
Tindakan berikut didukung oleh Amazon Timestream Write:
+ [CreateBatchLoadTask](API_CreateBatchLoadTask.md)
+ [CreateDatabase](API_CreateDatabase.md)
+ [CreateTable](API_CreateTable.md)
+ [DeleteDatabase](API_DeleteDatabase.md)
+ [DeleteTable](API_DeleteTable.md)
+ [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md)
+ [DescribeDatabase](API_DescribeDatabase.md)
+ [DescribeEndpoints](API_DescribeEndpoints.md)
+ [DescribeTable](API_DescribeTable.md)
+ [ListBatchLoadTasks](API_ListBatchLoadTasks.md)
+ [ListDatabases](API_ListDatabases.md)
+ [ListTables](API_ListTables.md)
+ [ListTagsForResource](API_ListTagsForResource.md)
+ [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md)
+ [TagResource](API_TagResource.md)
+ [UntagResource](API_UntagResource.md)
+ [UpdateDatabase](API_UpdateDatabase.md)
+ [UpdateTable](API_UpdateTable.md)
+ [WriteRecords](API_WriteRecords.md)
# CreateBatchLoadTask
Membuat tugas pemuatan batch Timestream baru. Tugas pemuatan batch memproses data dari sumber CSV di lokasi S3 dan menulis ke tabel Timestream. Pemetaan dari sumber ke target didefinisikan dalam tugas pemuatan batch. Kesalahan dan peristiwa ditulis ke laporan di lokasi S3. Untuk laporan, jika AWS KMS kunci tidak ditentukan, laporan akan dienkripsi dengan kunci terkelola S3 saat opsi `SSE_S3` tersebut. Jika tidak, kesalahan akan dilemparkan. Untuk informasi selengkapnya, lihat [kunci AWS terkelola](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk). [Service quotas berlaku](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Untuk detailnya, lihat [contoh kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html).
## Sintaksis Permintaan
```
{
"ClientToken": "string",
"DataModelConfiguration": {
"DataModel": {
"DimensionMappings": [
{
"DestinationColumn": "string",
"SourceColumn": "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"
},
"TimeColumn": "string",
"TimeUnit": "string"
},
"DataModelS3Configuration": {
"BucketName": "string",
"ObjectKey": "string"
}
},
"DataSourceConfiguration": {
"CsvConfiguration": {
"ColumnSeparator": "string",
"EscapeChar": "string",
"NullValue": "string",
"QuoteChar": "string",
"TrimWhiteSpace": boolean
},
"DataFormat": "string",
"DataSourceS3Configuration": {
"BucketName": "string",
"ObjectKeyPrefix": "string"
}
},
"RecordVersion": number,
"ReportConfiguration": {
"ReportS3Configuration": {
"BucketName": "string",
"EncryptionOption": "string",
"KmsKeyId": "string",
"ObjectKeyPrefix": "string"
}
},
"TargetDatabaseName": "string",
"TargetTableName": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) **
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Wajib: Tidak
** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **
Tipe: Objek [DataModelConfiguration](API_DataModelConfiguration.md)
Wajib: Tidak
** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **
Mendefinisikan detail konfigurasi tentang sumber data untuk tugas pemuatan batch.
Tipe: Objek [DataSourceConfiguration](API_DataSourceConfiguration.md)
Wajib: Ya
** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) **
Tipe: Panjang
Wajib: Tidak
** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **
Laporkan konfigurasi untuk tugas pemuatan batch. Ini berisi rincian tentang di mana laporan kesalahan disimpan.
Tipe: Objek [ReportConfiguration](API_ReportConfiguration.md)
Wajib: Ya
** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) **
Target database Timestream untuk tugas pemuatan batch.
Tipe: String
Pola: `[a-zA-Z0-9_.-]+`
Wajib: Ya
** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) **
Target tabel Timestream untuk tugas pemuatan batch.
Tipe: String
Pola: `[a-zA-Z0-9_.-]+`
Diperlukan: Ya
## Sintaksis Respons
```
{
"TaskId": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) **
ID tugas pemuatan batch.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum sebesar 32.
Pola: `[A-Z0-9]+`
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** ConflictException **
Timestream tidak dapat memproses permintaan ini karena berisi sumber daya yang sudah ada.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ServiceQuotaExceededException **
Kuota instans sumber daya terlampaui untuk akun ini.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/CreateBatchLoadTask)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask)
# CreateDatabase
Menciptakan basis data Timestream baru. Jika AWS KMS kunci tidak ditentukan, database akan dienkripsi dengan kunci terkelola Timestream yang terletak di AWS KMS akun Anda. Untuk informasi selengkapnya, lihat [kunci AWS terkelola](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk). [Service quotas berlaku](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Untuk detailnya, lihat [contoh kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html).
## Sintaksis Permintaan
```
{
"DatabaseName": "string",
"KmsKeyId": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [DatabaseName](#API_CreateDatabase_RequestSyntax) **
Nama basis data Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Pola: `[a-zA-Z0-9_.-]+`
Wajib: Ya
** [KmsKeyId](#API_CreateDatabase_RequestSyntax) **
AWS KMS Kunci untuk database. Jika AWS KMS kunci tidak ditentukan, database akan dienkripsi dengan kunci terkelola Timestream yang terletak di AWS KMS akun Anda. Untuk informasi selengkapnya, lihat [kunci AWS terkelola](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk).
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.
Wajib: Tidak
** [Tags](#API_CreateDatabase_RequestSyntax) **
Daftar pasangan kunci-nilai untuk memberi label pada tabel.
Tipe: Array objek [Tag](API_Tag.md)
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.
Wajib: Tidak
## Sintaksis Respons
```
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Database](#API_CreateDatabase_ResponseSyntax) **
Database Timestream yang baru dibuat.
Tipe: Objek [Database](API_Database.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** ConflictException **
Timestream tidak dapat memproses permintaan ini karena berisi sumber daya yang sudah ada.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ServiceQuotaExceededException **
Kuota instans sumber daya terlampaui untuk akun ini.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/CreateDatabase)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateDatabase)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateDatabase)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateDatabase)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateDatabase)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateDatabase)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateDatabase)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateDatabase)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateDatabase)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateDatabase)
# CreateTable
Menambahkan tabel baru ke database yang ada di akun Anda. Dalam sebuah Akun AWS, nama tabel harus setidaknya unik dalam setiap Wilayah jika mereka berada dalam database yang sama. Anda mungkin memiliki nama tabel yang identik di Wilayah yang sama jika tabel berada dalam database terpisah. Saat membuat tabel, Anda harus menentukan nama tabel, nama basis data, dan properti retensi. [Service quotas berlaku](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html) untuk detail.
## Sintaksis Permintaan
```
{
"DatabaseName": "string",
"MagneticStoreWriteProperties": {
"EnableMagneticStoreWrites": boolean,
"MagneticStoreRejectedDataLocation": {
"S3Configuration": {
"BucketName": "string",
"EncryptionOption": "string",
"KmsKeyId": "string",
"ObjectKeyPrefix": "string"
}
}
},
"RetentionProperties": {
"MagneticStoreRetentionPeriodInDays": number,
"MemoryStoreRetentionPeriodInHours": number
},
"Schema": {
"CompositePartitionKey": [
{
"EnforcementInRecord": "string",
"Name": "string",
"Type": "string"
}
]
},
"TableName": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [DatabaseName](#API_CreateTable_RequestSyntax) **
Nama basis data Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Pola: `[a-zA-Z0-9_.-]+`
Wajib: Ya
** [MagneticStoreWriteProperties](#API_CreateTable_RequestSyntax) **
Berisi properti untuk diatur di atas meja saat mengaktifkan penulisan penyimpanan magnetik.
Tipe: Objek [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)
Wajib: Tidak
** [RetentionProperties](#API_CreateTable_RequestSyntax) **
Durasi data deret waktu Anda harus disimpan di penyimpanan memori dan penyimpanan magnetik.
Tipe: Objek [RetentionProperties](API_RetentionProperties.md)
Wajib: Tidak
** [Schema](#API_CreateTable_RequestSyntax) **
Skema tabel.
Tipe: Objek [Schema](API_Schema.md)
Wajib: Tidak
** [TableName](#API_CreateTable_RequestSyntax) **
Nama tabel Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Pola: `[a-zA-Z0-9_.-]+`
Wajib: Ya
** [Tags](#API_CreateTable_RequestSyntax) **
Daftar pasangan kunci-nilai untuk memberi label pada tabel.
Tipe: Array objek [Tag](API_Tag.md)
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.
Wajib: Tidak
## Sintaksis Respons
```
{
"Table": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"LastUpdatedTime": number,
"MagneticStoreWriteProperties": {
"EnableMagneticStoreWrites": boolean,
"MagneticStoreRejectedDataLocation": {
"S3Configuration": {
"BucketName": "string",
"EncryptionOption": "string",
"KmsKeyId": "string",
"ObjectKeyPrefix": "string"
}
}
},
"RetentionProperties": {
"MagneticStoreRetentionPeriodInDays": number,
"MemoryStoreRetentionPeriodInHours": number
},
"Schema": {
"CompositePartitionKey": [
{
"EnforcementInRecord": "string",
"Name": "string",
"Type": "string"
}
]
},
"TableName": "string",
"TableStatus": "string"
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Table](#API_CreateTable_ResponseSyntax) **
Tabel Timestream yang baru dibuat.
Tipe: Objek [Table](API_Table.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** ConflictException **
Timestream tidak dapat memproses permintaan ini karena berisi sumber daya yang sudah ada.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Titik akhir yang diminta tidak valid.
Kode Status HTTP: 400
** InvalidEndpointException **
Titik akhir yang diminta tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ServiceQuotaExceededException **
Kuota instance sumber daya terlampaui untuk akun ini.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/CreateTable)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateTable)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateTable)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateTable)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateTable)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateTable)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateTable)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateTable)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateTable)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateTable)
# DeleteDatabase
Menghapus database Timestream yang diberikan. *Ini adalah operasi yang tidak dapat diubah. Setelah database dihapus, data deret waktu dari tabelnya tidak dapat dipulihkan.*
**catatan**
Semua tabel dalam database harus dihapus terlebih dahulu, atau ValidationException kesalahan akan dilemparkan.
Karena sifat percobaan ulang yang didistribusikan, operasi dapat mengembalikan keberhasilan atau a ResourceNotFoundException. Klien harus menganggap mereka setara.
Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html) untuk detail.
## Sintaksis Permintaan
```
{
"DatabaseName": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [DatabaseName](#API_DeleteDatabase_RequestSyntax) **
Nama database Timestream yang akan dihapus.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/DeleteDatabase)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteDatabase)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteDatabase)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteDatabase)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteDatabase)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteDatabase)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteDatabase)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteDatabase)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteDatabase)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteDatabase)
# DeleteTable
Menghapus tabel Timestream yang diberikan. Ini adalah operasi yang tidak dapat diubah. Setelah tabel database Timestream dihapus, data deret waktu yang disimpan dalam tabel tidak dapat dipulihkan.
**catatan**
Karena sifat percobaan ulang yang didistribusikan, operasi dapat mengembalikan keberhasilan atau a ResourceNotFoundException. Klien harus menganggapnya setara.
Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html) untuk detail.
## Sintaksis Permintaan
```
{
"DatabaseName": "string",
"TableName": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [DatabaseName](#API_DeleteTable_RequestSyntax) **
Nama database tempat database Timestream akan dihapus.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
** [TableName](#API_DeleteTable_RequestSyntax) **
Nama tabel Timestream yang akan dihapus.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Titik akhir yang diminta tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/DeleteTable)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteTable)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteTable)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteTable)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteTable)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteTable)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteTable)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteTable)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteTable)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteTable)
# DescribeBatchLoadTask
Mengembalikan informasi tentang tugas pemuatan batch, termasuk konfigurasi, pemetaan, kemajuan, dan detail lainnya. [Service quotas berlaku](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-batch-load.html) untuk detail.
## Sintaksis Permintaan
```
{
"TaskId": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [TaskId](#API_DescribeBatchLoadTask_RequestSyntax) **
ID tugas pemuatan batch.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum sebesar 32.
Pola: `[A-Z0-9]+`
Diperlukan: Ya
## Sintaksis Respons
```
{
"BatchLoadTaskDescription": {
"CreationTime": number,
"DataModelConfiguration": {
"DataModel": {
"DimensionMappings": [
{
"DestinationColumn": "string",
"SourceColumn": "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"
},
"TimeColumn": "string",
"TimeUnit": "string"
},
"DataModelS3Configuration": {
"BucketName": "string",
"ObjectKey": "string"
}
},
"DataSourceConfiguration": {
"CsvConfiguration": {
"ColumnSeparator": "string",
"EscapeChar": "string",
"NullValue": "string",
"QuoteChar": "string",
"TrimWhiteSpace": boolean
},
"DataFormat": "string",
"DataSourceS3Configuration": {
"BucketName": "string",
"ObjectKeyPrefix": "string"
}
},
"ErrorMessage": "string",
"LastUpdatedTime": number,
"ProgressReport": {
"BytesMetered": number,
"FileFailures": number,
"ParseFailures": number,
"RecordIngestionFailures": number,
"RecordsIngested": number,
"RecordsProcessed": number
},
"RecordVersion": number,
"ReportConfiguration": {
"ReportS3Configuration": {
"BucketName": "string",
"EncryptionOption": "string",
"KmsKeyId": "string",
"ObjectKeyPrefix": "string"
}
},
"ResumableUntil": number,
"TargetDatabaseName": "string",
"TargetTableName": "string",
"TaskId": "string",
"TaskStatus": "string"
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [BatchLoadTaskDescription](#API_DescribeBatchLoadTask_ResponseSyntax) **
Deskripsi tugas pemuatan batch.
Tipe: Objek [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/DescribeBatchLoadTask)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeBatchLoadTask)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeBatchLoadTask)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeBatchLoadTask)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeBatchLoadTask)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeBatchLoadTask)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeBatchLoadTask)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeBatchLoadTask)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeBatchLoadTask)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeBatchLoadTask)
# DescribeDatabase
Mengembalikan informasi tentang database, termasuk nama database, waktu database dibuat, dan jumlah total tabel yang ditemukan dalam database. [Service quotas berlaku](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html) untuk detail.
## Sintaksis Permintaan
```
{
"DatabaseName": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [DatabaseName](#API_DescribeDatabase_RequestSyntax) **
Nama basis data Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
## Sintaksis Respons
```
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Database](#API_DescribeDatabase_ResponseSyntax) **
Nama tabel Timestream.
Tipe: Objek [Database](API_Database.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/DescribeDatabase)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeDatabase)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeDatabase)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeDatabase)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeDatabase)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeDatabase)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeDatabase)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeDatabase)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeDatabase)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeDatabase)
# DescribeEndpoints
Mengembalikan daftar endpoint yang tersedia untuk membuat panggilan Timestream API terhadap. Operasi API ini tersedia melalui Write dan Query APIs.
Karena Timestream SDKs dirancang untuk bekerja secara transparan dengan arsitektur layanan, termasuk pengelolaan dan pemetaan titik akhir layanan, *kami tidak menyarankan Anda menggunakan operasi 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
```
{
"Endpoints": [
{
"Address": "string",
"CachePeriodInMinutes": number
}
]
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Endpoints](#API_DescribeEndpoints_ResponseSyntax) **
Sebuah `Endpoints` objek dikembalikan ketika `DescribeEndpoints` permintaan dibuat.
Tipe: Array objek [Endpoint](API_Endpoint.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/DescribeEndpoints)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeEndpoints)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeEndpoints)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeEndpoints)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeEndpoints)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeEndpoints)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeEndpoints)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeEndpoints)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeEndpoints)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeEndpoints)
# DescribeTable
Mengembalikan informasi tentang tabel, termasuk nama tabel, nama database, durasi retensi penyimpanan memori dan penyimpanan magnetik. [Service quotas berlaku](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html) untuk detail.
## Sintaksis Permintaan
```
{
"DatabaseName": "string",
"TableName": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [DatabaseName](#API_DescribeTable_RequestSyntax) **
Nama basis data Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
** [TableName](#API_DescribeTable_RequestSyntax) **
Nama tabel Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
## Sintaksis Respons
```
{
"Table": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"LastUpdatedTime": number,
"MagneticStoreWriteProperties": {
"EnableMagneticStoreWrites": boolean,
"MagneticStoreRejectedDataLocation": {
"S3Configuration": {
"BucketName": "string",
"EncryptionOption": "string",
"KmsKeyId": "string",
"ObjectKeyPrefix": "string"
}
}
},
"RetentionProperties": {
"MagneticStoreRetentionPeriodInDays": number,
"MemoryStoreRetentionPeriodInHours": number
},
"Schema": {
"CompositePartitionKey": [
{
"EnforcementInRecord": "string",
"Name": "string",
"Type": "string"
}
]
},
"TableName": "string",
"TableStatus": "string"
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Table](#API_DescribeTable_ResponseSyntax) **
Tabel Timestream.
Tipe: Objek [Table](API_Table.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/DescribeTable)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeTable)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeTable)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeTable)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeTable)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeTable)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeTable)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeTable)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeTable)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeTable)
# ListBatchLoadTasks
Menyediakan daftar tugas pemuatan batch, bersama dengan nama, status, kapan tugas dapat dilanjutkan hingga, dan detail lainnya. Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-batch-load-tasks.html) untuk detail.
## Sintaksis Permintaan
```
{
"MaxResults": number,
"NextToken": "string",
"TaskStatus": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [MaxResults](#API_ListBatchLoadTasks_RequestSyntax) **
Jumlah total item yang akan 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 dari pemanggilan API berikutnya.
Tipe: Bilangan Bulat
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 100.
Wajib: Tidak
** [NextToken](#API_ListBatchLoadTasks_RequestSyntax) **
Token untuk menentukan di mana harus memulai paginating. Ini adalah NextToken dari respons yang sebelumnya terpotong.
Tipe: String
Wajib: Tidak
** [TaskStatus](#API_ListBatchLoadTasks_RequestSyntax) **
Status tugas pemuatan batch.
Tipe: String
Nilai yang Valid: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME`
Wajib: Tidak
## Sintaksis Respons
```
{
"BatchLoadTasks": [
{
"CreationTime": number,
"DatabaseName": "string",
"LastUpdatedTime": number,
"ResumableUntil": number,
"TableName": "string",
"TaskId": "string",
"TaskStatus": "string"
}
],
"NextToken": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [BatchLoadTasks](#API_ListBatchLoadTasks_ResponseSyntax) **
Daftar detail tugas pemuatan batch.
Tipe: Array objek [BatchLoadTask](API_BatchLoadTask.md)
** [NextToken](#API_ListBatchLoadTasks_ResponseSyntax) **
Token untuk menentukan di mana harus memulai paginating. Berikan yang berikutnya ListBatchLoadTasksRequest.
Tipe: String
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/ListBatchLoadTasks)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListBatchLoadTasks)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListBatchLoadTasks)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListBatchLoadTasks)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListBatchLoadTasks)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListBatchLoadTasks)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListBatchLoadTasks)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListBatchLoadTasks)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListBatchLoadTasks)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListBatchLoadTasks)
# ListDatabases
Mengembalikan daftar database Timestream Anda. [Service quotas berlaku](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html) untuk detail.
## Sintaksis Permintaan
```
{
"MaxResults": number,
"NextToken": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [MaxResults](#API_ListDatabases_RequestSyntax) **
Jumlah total item yang akan 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 dari pemanggilan API berikutnya.
Tipe: Bilangan Bulat
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 20.
Wajib: Tidak
** [NextToken](#API_ListDatabases_RequestSyntax) **
Token pagination. Untuk melanjutkan pagination, berikan NextToken nilai sebagai argumen dari pemanggilan API berikutnya.
Tipe: String
Wajib: Tidak
## Sintaksis Respons
```
{
"Databases": [
{
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
],
"NextToken": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Databases](#API_ListDatabases_ResponseSyntax) **
Daftar nama database.
Tipe: Array objek [Database](API_Database.md)
** [NextToken](#API_ListDatabases_ResponseSyntax) **
Token pagination. Parameter ini dikembalikan ketika respon terpotong.
Tipe: String
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/ListDatabases)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListDatabases)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListDatabases)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListDatabases)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListDatabases)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListDatabases)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListDatabases)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListDatabases)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListDatabases)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListDatabases)
# ListTables
Menyediakan daftar tabel, bersama dengan nama, status, dan properti retensi dari setiap tabel. Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html) untuk detail.
## Sintaksis Permintaan
```
{
"DatabaseName": "string",
"MaxResults": number,
"NextToken": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [DatabaseName](#API_ListTables_RequestSyntax) **
Nama basis data Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Tidak
** [MaxResults](#API_ListTables_RequestSyntax) **
Jumlah total item yang akan 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 dari pemanggilan API berikutnya.
Tipe: Bilangan Bulat
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 20.
Wajib: Tidak
** [NextToken](#API_ListTables_RequestSyntax) **
Token pagination. Untuk melanjutkan pagination, berikan NextToken nilai sebagai argumen dari pemanggilan API berikutnya.
Tipe: String
Wajib: Tidak
## Sintaksis Respons
```
{
"NextToken": "string",
"Tables": [
{
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"LastUpdatedTime": number,
"MagneticStoreWriteProperties": {
"EnableMagneticStoreWrites": boolean,
"MagneticStoreRejectedDataLocation": {
"S3Configuration": {
"BucketName": "string",
"EncryptionOption": "string",
"KmsKeyId": "string",
"ObjectKeyPrefix": "string"
}
}
},
"RetentionProperties": {
"MagneticStoreRetentionPeriodInDays": number,
"MemoryStoreRetentionPeriodInHours": number
},
"Schema": {
"CompositePartitionKey": [
{
"EnforcementInRecord": "string",
"Name": "string",
"Type": "string"
}
]
},
"TableName": "string",
"TableStatus": "string"
}
]
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [NextToken](#API_ListTables_ResponseSyntax) **
Token untuk menentukan di mana harus memulai paginating. Ini adalah NextToken dari respons yang sebelumnya terpotong.
Tipe: String
** [Tables](#API_ListTables_ResponseSyntax) **
Daftar tabel.
Tipe: Array objek [Table](API_Table.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/ListTables)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTables)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTables)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTables)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTables)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTables)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTables)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTables)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTables)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTables)
# ListTagsForResource
Daftar semua tag pada sumber daya Timestream.
## Sintaksis Permintaan
```
{
"ResourceARN": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [ResourceARN](#API_ListTagsForResource_RequestSyntax) **
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 1011.
Wajib: Ya
## Sintaksis Respons
```
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Tags](#API_ListTagsForResource_ResponseSyntax) **
Tag yang saat ini terkait dengan sumber daya Timestream.
Tipe: Array objek [Tag](API_Tag.md)
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.
## Kesalahan
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 **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/ListTagsForResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTagsForResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTagsForResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTagsForResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTagsForResource)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTagsForResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTagsForResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTagsForResource)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTagsForResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTagsForResource)
# ResumeBatchLoadTask
## Sintaksis Permintaan
```
{
"TaskId": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [TaskId](#API_ResumeBatchLoadTask_RequestSyntax) **
ID tugas pemuatan batch untuk dilanjutkan.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum sebesar 32.
Pola: `[A-Z0-9]+`
Diperlukan: Ya
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/ResumeBatchLoadTask)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ResumeBatchLoadTask)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ResumeBatchLoadTask)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ResumeBatchLoadTask)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ResumeBatchLoadTask)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ResumeBatchLoadTask)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ResumeBatchLoadTask)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ResumeBatchLoadTask)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ResumeBatchLoadTask)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ResumeBatchLoadTask)
# TagResource
Mengaitkan 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
```
{
"ResourceARN": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [ResourceARN](#API_TagResource_RequestSyntax) **
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 1011.
Wajib: Ya
** [Tags](#API_TagResource_RequestSyntax) **
Tag yang akan ditetapkan ke sumber daya Timestream.
Tipe: Array objek [Tag](API_Tag.md)
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.
Wajib: Ya
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
## Kesalahan
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 **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ServiceQuotaExceededException **
Kuota instans sumber daya terlampaui untuk akun ini.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/TagResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/TagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/TagResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/TagResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/TagResource)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/TagResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/TagResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/TagResource)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/TagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/TagResource)
# UntagResource
Menghapus asosiasi tag dari sumber daya Timestream.
## Sintaksis Permintaan
```
{
"ResourceARN": "string",
"TagKeys": [ "string" ]
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [ResourceARN](#API_UntagResource_RequestSyntax) **
Sumber daya Timestream tempat tag akan dihapus. Nilai ini adalah sebuah Amazon Resource Name (ARN).
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 1011.
Wajib: Ya
** [TagKeys](#API_UntagResource_RequestSyntax) **
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
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
## Kesalahan
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 **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ServiceQuotaExceededException **
Kuota instans sumber daya terlampaui untuk akun ini.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/UntagResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UntagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UntagResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UntagResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UntagResource)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UntagResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UntagResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UntagResource)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UntagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UntagResource)
# UpdateDatabase
Memodifikasi AWS KMS kunci untuk database yang ada. Saat memperbarui database, Anda harus menentukan nama database dan pengidentifikasi AWS KMS kunci baru yang akan digunakan (`KmsKeyId`). Jika ada `UpdateDatabase` permintaan bersamaan, penulis pertama menang.
Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html) untuk detail.
## Sintaksis Permintaan
```
{
"DatabaseName": "string",
"KmsKeyId": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [DatabaseName](#API_UpdateDatabase_RequestSyntax) **
Nama basis data.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) **
Pengidentifikasi AWS KMS kunci baru (`KmsKeyId`) yang akan digunakan untuk mengenkripsi data yang disimpan dalam database. Jika yang `KmsKeyId` saat ini terdaftar dengan database sama dengan permintaan, tidak akan ada pembaruan apa pun. `KmsKeyId`
Anda dapat menentukan `KmsKeyId` menggunakan salah satu hal berikut:
+ ID kunci: `1234abcd-12ab-34cd-56ef-1234567890ab`
+ ARN kunci: `arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`
+ Nama alias: `alias/ExampleAlias`
+ Alias ARN: `arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias`
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.
Wajib: Ya
## Sintaksis Respons
```
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Database](#API_UpdateDatabase_ResponseSyntax) **
Wadah tingkat atas untuk sebuah meja. Database dan tabel adalah konsep manajemen dasar di Amazon Timestream. Semua tabel dalam database dienkripsi dengan kunci yang sama AWS KMS .
Tipe: Objek [Database](API_Database.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ServiceQuotaExceededException **
Kuota instans sumber daya terlampaui untuk akun ini.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/UpdateDatabase)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateDatabase)
# UpdateTable
Memodifikasi durasi retensi penyimpanan memori dan penyimpanan magnetik untuk tabel Timestream Anda. Perhatikan bahwa perubahan durasi retensi segera berlaku. Misalnya, jika periode retensi penyimpanan memori awalnya diatur ke 2 jam dan kemudian diubah menjadi 24 jam, penyimpanan memori akan mampu menyimpan 24 jam data, tetapi akan diisi dengan 24 jam data 22 jam setelah perubahan ini dilakukan. Timestream tidak mengambil data dari penyimpanan magnetik untuk mengisi penyimpanan memori.
Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html) untuk detail.
## Sintaksis Permintaan
```
{
"DatabaseName": "string",
"MagneticStoreWriteProperties": {
"EnableMagneticStoreWrites": boolean,
"MagneticStoreRejectedDataLocation": {
"S3Configuration": {
"BucketName": "string",
"EncryptionOption": "string",
"KmsKeyId": "string",
"ObjectKeyPrefix": "string"
}
}
},
"RetentionProperties": {
"MagneticStoreRetentionPeriodInDays": number,
"MemoryStoreRetentionPeriodInHours": number
},
"Schema": {
"CompositePartitionKey": [
{
"EnforcementInRecord": "string",
"Name": "string",
"Type": "string"
}
]
},
"TableName": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [DatabaseName](#API_UpdateTable_RequestSyntax) **
Nama basis data Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
** [MagneticStoreWriteProperties](#API_UpdateTable_RequestSyntax) **
Berisi properti untuk diatur di atas meja saat mengaktifkan penulisan penyimpanan magnetik.
Tipe: Objek [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)
Wajib: Tidak
** [RetentionProperties](#API_UpdateTable_RequestSyntax) **
Durasi retensi penyimpanan memori dan penyimpanan magnetik.
Tipe: Objek [RetentionProperties](API_RetentionProperties.md)
Wajib: Tidak
** [Schema](#API_UpdateTable_RequestSyntax) **
Skema tabel.
Tipe: Objek [Schema](API_Schema.md)
Wajib: Tidak
** [TableName](#API_UpdateTable_RequestSyntax) **
Nama tabel Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
## Sintaksis Respons
```
{
"Table": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"LastUpdatedTime": number,
"MagneticStoreWriteProperties": {
"EnableMagneticStoreWrites": boolean,
"MagneticStoreRejectedDataLocation": {
"S3Configuration": {
"BucketName": "string",
"EncryptionOption": "string",
"KmsKeyId": "string",
"ObjectKeyPrefix": "string"
}
}
},
"RetentionProperties": {
"MagneticStoreRetentionPeriodInDays": number,
"MemoryStoreRetentionPeriodInHours": number
},
"Schema": {
"CompositePartitionKey": [
{
"EnforcementInRecord": "string",
"Name": "string",
"Type": "string"
}
]
},
"TableName": "string",
"TableStatus": "string"
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Table](#API_UpdateTable_ResponseSyntax) **
Tabel Timestream yang diperbarui.
Tipe: Objek [Table](API_Table.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/UpdateTable)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateTable)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateTable)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateTable)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateTable)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateTable)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateTable)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateTable)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateTable)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateTable)
# WriteRecords
Memungkinkan Anda untuk menulis data deret waktu Anda ke Timestream. Anda dapat menentukan satu titik data atau sekumpulan titik data yang akan dimasukkan ke dalam sistem. Timestream menawarkan skema fleksibel yang secara otomatis mendeteksi nama kolom dan tipe data untuk tabel Timestream Anda berdasarkan nama dimensi dan tipe data dari titik data yang Anda tentukan saat menjalankan penulisan ke dalam database.
Timestream mendukung semantik baca konsistensi akhirnya. Ini berarti bahwa ketika Anda melakukan kueri data segera setelah menulis kumpulan data ke Timestream, hasil kueri mungkin tidak mencerminkan hasil operasi penulisan yang baru saja selesai. Hasilnya mungkin juga mencakup beberapa data basi. Jika Anda mengulangi permintaan kueri setelah waktu yang singkat, hasilnya akan mengembalikan data terbaru. [Service quotas berlaku](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html).
Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html) untuk detail.
**Upserts**
Anda dapat menggunakan `Version` parameter dalam `WriteRecords` permintaan untuk memperbarui titik data. Timestream melacak nomor versi dengan setiap catatan. `Version`default `1` ketika itu tidak ditentukan untuk catatan dalam permintaan. Timestream memperbarui nilai ukuran rekaman yang ada bersama dengan `Version` saat menerima permintaan tulis dengan `Version` angka yang lebih tinggi untuk catatan itu. Ketika menerima permintaan pembaruan di mana nilai ukurannya sama dengan catatan yang ada, Timestream masih memperbarui`Version`, jika lebih besar dari `Version` nilai yang ada. Anda dapat memperbarui titik data sebanyak yang diinginkan, selama nilai `Version` terus meningkat.
Misalnya, misalkan Anda menulis catatan baru tanpa menunjukkan `Version` dalam permintaan. Timestream menyimpan catatan ini, dan diatur `Version` ke`1`. Sekarang, misalkan Anda mencoba memperbarui catatan ini dengan `WriteRecords` permintaan catatan yang sama dengan nilai ukuran yang berbeda tetapi, seperti sebelumnya, jangan berikan`Version`. Dalam hal ini, Timestream akan menolak pembaruan ini dengan `RejectedRecordsException` karena versi rekaman yang diperbarui tidak lebih besar dari nilai Versi yang ada.
Namun, jika Anda mengirim ulang permintaan pembaruan dengan `Version` set ke`2`, Timestream kemudian akan berhasil memperbarui nilai catatan, dan `Version` akan disetel ke. `2` Selanjutnya, misalkan Anda mengirim `WriteRecords` permintaan dengan catatan yang sama dan nilai ukuran yang identik, tetapi dengan `Version` set ke`3`. Dalam hal ini, Timestream hanya akan memperbarui `Version` ke`3`. Setiap pembaruan lebih lanjut perlu mengirim nomor versi yang lebih besar dari`3`, atau permintaan pembaruan akan menerima file`RejectedRecordsException`.
## Sintaksis Permintaan
```
{
"CommonAttributes": {
"Dimensions": [
{
"DimensionValueType": "string",
"Name": "string",
"Value": "string"
}
],
"MeasureName": "string",
"MeasureValue": "string",
"MeasureValues": [
{
"Name": "string",
"Type": "string",
"Value": "string"
}
],
"MeasureValueType": "string",
"Time": "string",
"TimeUnit": "string",
"Version": number
},
"DatabaseName": "string",
"Records": [
{
"Dimensions": [
{
"DimensionValueType": "string",
"Name": "string",
"Value": "string"
}
],
"MeasureName": "string",
"MeasureValue": "string",
"MeasureValues": [
{
"Name": "string",
"Type": "string",
"Value": "string"
}
],
"MeasureValueType": "string",
"Time": "string",
"TimeUnit": "string",
"Version": number
}
],
"TableName": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [CommonAttributes](#API_WriteRecords_RequestSyntax) **
Catatan yang berisi atribut ukuran, dimensi, waktu, dan versi umum yang dibagikan di semua catatan dalam permintaan. Atribut ukuran dan dimensi yang ditentukan akan digabungkan dengan atribut ukuran dan dimensi dalam objek rekaman saat data ditulis ke Timestream. Dimensi mungkin tidak tumpang tindih, atau `ValidationException` akan dilemparkan. Dengan kata lain, catatan harus berisi dimensi dengan nama unik.
Tipe: Objek [Record](API_Record.md)
Wajib: Tidak
** [DatabaseName](#API_WriteRecords_RequestSyntax) **
Nama basis data Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
** [Records](#API_WriteRecords_RequestSyntax) **
Larik catatan yang berisi atribut ukuran, dimensi, waktu, dan versi unik untuk setiap titik data deret waktu.
Tipe: Array objek [Record](API_Record.md)
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 100 item.
Wajib: Ya
** [TableName](#API_WriteRecords_RequestSyntax) **
Nama tabel Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
## Sintaksis Respons
```
{
"RecordsIngested": {
"MagneticStore": number,
"MemoryStore": number,
"Total": number
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [RecordsIngested](#API_WriteRecords_ResponseSyntax) **
Informasi tentang catatan yang dicerna oleh permintaan ini.
Tipe: Objek [RecordsIngested](API_RecordsIngested.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** RejectedRecordsException **
WriteRecords akan membuang pengecualian ini dalam kasus berikut:
+ Rekaman dengan data duplikat di mana ada beberapa catatan dengan dimensi, stempel waktu, dan nama ukuran yang sama tetapi:
+ Nilai ukur berbeda
+ Versi tidak hadir dalam permintaan *atau* nilai versi dalam catatan baru sama dengan atau lebih rendah dari nilai yang ada
Dalam hal ini, jika Timestream menolak data, `ExistingVersion` bidang dalam `RejectedRecords` respons akan menunjukkan versi rekaman saat ini. Untuk memaksa pembaruan, Anda dapat mengirim ulang permintaan dengan versi untuk catatan yang ditetapkan ke nilai yang lebih besar dari`ExistingVersion`.
+ Catatan dengan stempel waktu yang berada di luar durasi retensi penyimpanan memori.
+ Rekaman dengan dimensi atau ukuran yang melebihi batas yang ditentukan Timestream.
Untuk informasi selengkapnya, lihat [Kuota](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) di Panduan Pengembang Amazon Timestream.
** RejectedRecords **
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
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-write-2018-11-01/WriteRecords)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/WriteRecords)