Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CreateGlobalCluster
Membuat klaster global Amazon DocumentDB yang dapat menjangkau beberapa Wilayah AWS. Klaster global berisi satu klaster primer dengan kemampuan baca-tulis, dan hingga memberikan klaster sekunder hanya-baca. Klaster global menggunakan replikasi cepat berbasis penyimpanan di seluruh wilayah dengan latensi kurang dari satu detik, menggunakan infrastruktur khusus tanpa memengaruhi performa beban kerja Anda.
Anda dapat membuat sebuah klaster global yang awalnya kosong, dan kemudian menambahkan primer dan sekunder ke dalamnya. Atau Anda dapat menentukan klaster yang ada selama operasi pembuatan, dan klaster ini menjadi yang primer dari klaster global.
catatan
Tindakan ini hanya berlaku untuk klaster Amazon DocumentDB.
Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
- GlobalClusterIdentifier
-
Pengidentifikasi klaster dari klaster global baru.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.
Pola:
[A-Za-z][0-9A-Za-z-:._]*Wajib: Ya
- DatabaseName
-
Nama untuk basis data Anda hingga 64 karakter alfanumerik. Jika Anda tidak memberikan nama, Amazon DocumentDB tidak akan membuat basis data di klaster global yang sedang Anda buat.
Tipe: String
Wajib: Tidak
- DeletionProtection
-
Pengaturan perlindungan penghapusan untuk klaster global baru. Klaster global tidak dapat dihapus saat perlindungan penghapusan diaktifkan.
Tipe: Boolean
Wajib: Tidak
- Engine
-
Nama mesin basis data yang akan digunakan untuk klaster ini.
Tipe: String
Wajib: Tidak
- EngineVersion
-
Versi mesin dari klaster global.
Tipe: String
Wajib: Tidak
- SourceDBClusterIdentifier
-
Amazon Resource Name (ARN) untuk digunakan sebagai klaster primer dari klaster global. Parameter ini bersifat opsional.
Tipe: String
Wajib: Tidak
- StorageEncrypted
-
Pengaturan enkripsi penyimpanan untuk klaster global baru.
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
- GlobalClusterAlreadyExistsFault
-
Parameter
GlobalClusterIdentifiersudah ada. Pilih pengidentifikasi klaster global baru (nama unik) untuk membuat klaster global baru.Kode Status HTTP: 400
- GlobalClusterQuotaExceededFault
-
Jumlah klaster global untuk akun ini sudah mencapai batas maksimum yang diizinkan.
Kode Status HTTP: 400
- InvalidDBClusterStateFault
-
Klaster tidak dalam status valid.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
