Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
RestoreDBClusterFromSnapshot
Membuat klaster baru dari snapshot atau snapshot klaster.
Jika snapshot ditentukan, klaster target dibuat dari snapshot DB sumber dengan konfigurasi default dan grup keamanan default.
Jika snapshot klaster ditentukan, klaster target dibuat dari titik pemulihan klaster sumber dengan konfigurasi yang sama seperti klaster DB sumber asli, kecuali klaster baru dibuat dengan grup keamanan default.
Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
- DBClusterIdentifier
-
Nama klaster yang akan dibuat dari snapshot atau snapshot klaster. Parameter ini tidak peka huruf besar kecil.
Batas:
-
Harus berisi 1 hingga 63 huruf, angka, atau tanda hubung.
-
Karakter pertama harus berupa huruf.
-
Tidak dapat diakhiri dengan tanda hubung atau mengandung dua tanda hubung berturut-turut.
Contoh:
my-snapshot-idTipe: String
Diperlukan: Ya
-
- Engine
-
Mesin basis data yang akan digunakan untuk klaster baru.
Default: Sama seperti sumber.
Kendala: Harus kompatibel dengan mesin sumber.
Tipe: String
Diperlukan: Ya
- SnapshotIdentifier
-
Pengidentifikasi untuk snapshot atau snapshot klaster yang akan dipulihkan.
Anda dapat menggunakan nama atau Amazon Resource Name (ARN) untuk menentukan snapshot klaster. Namun, Anda dapat menggunakan hanya ARN untuk menentukan snapshot.
Batas:
-
Harus cocok dengan pengidentifikasi snapshot yang ada.
Tipe: String
Diperlukan: Ya
-
- AvailabilityZones. AvailabilityZone.N
-
Menyediakan daftar Availability Zone Amazon EC2 tempat instans dalam klaster DB yang dipulihkan dapat dibuat.
Tipe: Array string
Wajib: Tidak
- DBClusterParameterGroupName
-
Nama grup parameter klaster yang akan dikaitkan dengan klaster DB ini.
Tipe: String. Diperlukan: Tidak.
Jika argumen ini dihilangkan, grup parameter cluster DB default digunakan. Jika disediakan, harus cocok dengan nama grup parameter cluster DB default yang ada. String harus terdiri dari 1 hingga 255 huruf, angka atau tanda hubung. Karakter pertamanya harus berupa huruf, dan tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berturut-turut.
Tipe: String
Wajib: Tidak
- DBSubnetGroupName
-
Nama grup subnet yang akan digunakan untuk klaster baru.
Kendala: Jika disediakan, harus cocok dengan nama
DBSubnetGroupyang ada.Contoh:
mySubnetgroupTipe: String
Wajib: Tidak
- DeletionProtection
-
Menentukan apakah klaster ini dapat dihapus. Jika
DeletionProtectiondiaktifkan, klaster tidak dapat dihapus kecuali jika diubah danDeletionProtectiondinonaktifkan.DeletionProtectionmelindungi klaster agar tidak terhapus secara tidak sengaja.Tipe: Boolean
Wajib: Tidak
- EnableCloudwatchLogsExports.member.n
-
Daftar jenis log yang harus diaktifkan untuk mengekspor ke Amazon CloudWatch Logs.
Tipe: Array string
Wajib: Tidak
- EngineVersion
-
Versi mesin basis data yang akan digunakan untuk klaster baru.
Tipe: String
Wajib: Tidak
- KmsKeyId
-
Pengidentifikasi AWS KMS kunci yang akan digunakan saat memulihkan cluster terenkripsi dari snapshot DB atau snapshot cluster.
Pengidentifikasi AWS KMS kunci adalah Amazon Resource Name (ARN) untuk kunci enkripsi AWS KMS . Jika Anda memulihkan cluster dengan yang sama Akun AWS yang memiliki kunci AWS KMS enkripsi yang digunakan untuk mengenkripsi cluster baru, maka Anda dapat menggunakan alias AWS KMS kunci alih-alih ARN untuk kunci enkripsi. AWS KMS
Jika Anda tidak menentukan nilai untuk parameter
KmsKeyId, maka hal berikut akan terjadi:-
Jika snapshot atau snapshot cluster
SnapshotIdentifierdienkripsi, maka cluster yang dipulihkan dienkripsi menggunakan AWS KMS kunci yang digunakan untuk mengenkripsi snapshot atau snapshot cluster. -
Jika snapshot atau snapshot klaster di
SnapshotIdentifiertidak dienkripsi, maka klaster DB yang dipulihkan tidak dienkripsi.
Tipe: String
Wajib: Tidak
-
- Port
-
Nomor port tempat klaster baru menerima koneksi.
Kendala: Harus berupa nilai dari
1150hingga65535.Default: Port yang sama dengan klaster asli.
Tipe: Integer
Wajib: Tidak
- StorageType
-
Jenis penyimpanan untuk dikaitkan dengan cluster DB.
Untuk informasi tentang jenis penyimpanan untuk klaster Amazon DocumentDB, lihat Konfigurasi penyimpanan klaster di Panduan Pengembang Amazon DocumentDB.
Nilai yang valid untuk jenis penyimpanan -
standard | iopt1Nilai default adalah
standardTipe: String
Wajib: Tidak
- Tags.Tag.N
-
Tag yang akan ditetapkan ke klaster yang dipulihkan.
Tipe: Array objek Tag
Wajib: Tidak
- VpcSecurityGroupIds. VpcSecurityGroupId.N
-
Daftar grup keamanan virtual private cloud (VPC) tempat klaster baru akan berada.
Tipe: Array string
Wajib: Tidak
Elemen Respons
Elemen berikut dikembalikan oleh layanan.
- DBCluster
-
Informasi mendetail tentang klaster.
Tipe: Objek DBCluster
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- DBClusterAlreadyExistsFault
-
Anda sudah memiliki klaster dengan pengidentifikasi yang diberikan.
Kode Status HTTP: 400
- DBClusterQuotaExceededFault
-
Klaster tidak dapat dibuat karena Anda telah mencapai kuota maksimum klaster yang diizinkan.
Kode Status HTTP: 403
- DBClusterSnapshotNotFoundFault
-
DBClusterSnapshotIdentifiertidak mengacu ke sebuah snapshot klaster yang ada.Kode Status HTTP: 404
- DBSnapshotNotFound
-
DBSnapshotIdentifiertidak mengacu ke sebuah snapshot yang ada.Kode Status HTTP: 404
- DBSubnetGroupNotFoundFault
-
DBSubnetGroupNametidak mengacu ke grup subnet yang ada.Kode Status HTTP: 404
- DBSubnetGroupNotFoundFault
-
DBSubnetGroupNametidak mengacu ke grup subnet yang ada.Kode Status HTTP: 404
- InsufficientDBClusterCapacityFault
-
Klaster tidak memiliki kapasitas yang cukup untuk operasi saat ini.
Kode Status HTTP: 403
- InsufficientStorageClusterCapacity
-
Tidak ada cukup penyimpanan yang tersedia untuk tindakan saat ini. Anda mungkin dapat mengatasi kesalahan ini dengan memperbarui grup subnet Anda untuk menggunakan Availability Zone berbeda yang memiliki lebih banyak penyimpanan yang tersedia.
Kode Status HTTP: 400
- InvalidDBClusterSnapshotStateFault
-
Nilai yang diberikan bukan status snapshot klaster yang valid.
Kode Status HTTP: 400
- InvalidDBSnapshotState
-
Status snapshot tidak mengizinkan penghapusan.
Kode Status HTTP: 400
- InvalidRestoreFault
-
Anda tidak dapat memulihkan dari backup virtual private cloud (VPC) ke instans DB non-VPC.
Kode Status HTTP: 400
- InvalidSubnet
-
Subnet yang diminta tidak valid, atau beberapa subnet yang diminta tidak semuanya berada dalam virtual private cloud (VPC) yang umum.
Kode Status HTTP: 400
- InvalidVPCNetworkStateFault
-
Grup subnet tidak mencakup semua Availability Zone setelah dibuat karena perubahan yang dibuat.
Kode Status HTTP: 400
- KMSKeyNotAccessibleFault
-
Terjadi kesalahan saat mengakses AWS KMS kunci.
Kode Status HTTP: 400
- StorageQuotaExceeded
-
Permintaan akan menyebabkan Anda melebihi jumlah penyimpanan yang diizinkan yang tersedia di semua instans.
Kode Status HTTP: 400
- StorageQuotaExceeded
-
Permintaan akan menyebabkan Anda melebihi jumlah penyimpanan yang diizinkan yang tersedia di semua instans.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
