Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mempromosikan cluster DB sekunder yang ditentukan untuk menjadi cluster DB utama di cluster global ketika kegagalan atas cluster global terjadi.
Gunakan operasi ini untuk menanggapi peristiwa yang tidak direncanakan, seperti bencana regional di wilayah primer. Kegagalan dapat mengakibatkan hilangnya data transaksi tulis yang tidak direplikasi ke sekunder yang dipilih sebelum peristiwa failover terjadi. Namun, proses pemulihan yang mempromosikan instans DB pada cluster DB hari kedua yang dipilih menjadi instans DB penulis utama menjamin bahwa data dalam keadaan konsisten secara transaksional.
Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
- GlobalClusterIdentifier
-
Pengidentifikasi cluster global Amazon DocumentDB untuk menerapkan operasi ini. Identifier adalah kunci unik yang ditetapkan oleh pengguna saat cluster dibuat. Dengan kata lain, itu adalah nama cluster global.
Batasan:
-
Harus cocok dengan pengidentifikasi klaster global yang ada.
-
Panjang minimum 1. Panjang maksimum 255.
Pola:
[A-Za-z][0-9A-Za-z-:._]*Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.
Pola:
[A-Za-z][0-9A-Za-z-:._]*Wajib: Ya
-
- TargetDbClusterIdentifier
-
Pengidentifikasi klaster Amazon DocumentDB sekunder yang ingin Anda promosikan ke klaster utama untuk klaster global. Gunakan Amazon Resource Name (ARN) untuk pengidentifikasi sehingga Amazon DocumentDB dapat menemukan cluster di wilayahnya. AWS
Batasan:
-
Harus cocok dengan identifier dari cluster sekunder yang ada.
-
Panjang minimum 1. Panjang maksimum 255.
Pola:
[A-Za-z][0-9A-Za-z-:._]*Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.
Pola:
[A-Za-z][0-9A-Za-z-:._]*Wajib: Ya
-
- AllowDataLoss
-
Menentukan apakah untuk memungkinkan kehilangan data untuk operasi cluster global ini. Mengizinkan kehilangan data memicu operasi failover global.
Jika Anda tidak menentukan
AllowDataLoss, operasi cluster global default ke switchover.Batasan:
-
Tidak dapat ditentukan bersama dengan
Switchoverparameter.
Tipe: Boolean
Wajib: Tidak
-
- Switchover
-
Menentukan apakah akan beralih ke cluster database global ini.
Batasan:
-
Tidak dapat ditentukan bersama dengan
AllowDataLossparameter.
Tipe: Boolean
Wajib: Tidak
-
Elemen Respons
Elemen berikut dikembalikan oleh layanan.
- GlobalCluster
-
Sebuah tipe data yang mewakili sebuah klaster global Amazon DocumentDB.
Tipe: Objek GlobalCluster
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- DBClusterNotFoundFault
-
DBClusterIdentifiertidak mengacu ke sebuah klaster yang ada.Kode Status HTTP: 404
- GlobalClusterNotFoundFault
-
GlobalClusterIdentifiertidak mengacu ke sebuah klaster global yang ada.Kode Status HTTP: 404
- InvalidDBClusterStateFault
-
Klaster tidak dalam status valid.
Kode Status HTTP: 400
- InvalidGlobalClusterStateFault
-
Operasi yang diminta tidak dapat dilakukan saat klaster dalam keadaan ini.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
