UpdateDatabase - Amazon Timestream
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

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 untuk detail.

Sintaksis Permintaan

{
   "DatabaseName": "string",
   "KmsKeyId": "string"
}

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Permintaan menerima data berikut dalam JSON format.

DatabaseName

Nama basis data.

Tipe: String

Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.

Wajib: Ya

KmsKeyId

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

  • KunciARN: arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

  • Nama alias: alias/ExampleAlias

  • AliasARN: 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.

Data berikut dikembalikan dalam JSON format oleh layanan.

Database

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

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

AccessDeniedException

Anda tidak berwenang untuk melakukan tindakan ini.

HTTPKode Status: 400

InternalServerException

Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.

HTTPKode Status: 500

InvalidEndpointException

Endpoint yang diminta tidak valid.

HTTPKode Status: 400

ResourceNotFoundException

Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidakACTIVE.

HTTPKode Status: 400

ServiceQuotaExceededException

Kuota instans sumber daya terlampaui untuk akun ini.

HTTPKode Status: 400

ThrottlingException

Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.

HTTPKode Status: 400

ValidationException

Permintaan yang tidak valid atau cacat.

HTTPKode Status: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: