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](CommonParameters.md).
** 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 surat.
+ Tidak dapat diakhiri dengan tanda hubung atau mengandung dua tanda hubung berturut-turut.
Contoh: `my-snapshot-id`
Tipe: 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 `DBSubnetGroup` yang ada.
Contoh: `mySubnetgroup`
Tipe: String
Wajib: Tidak
** DeletionProtection **
Menentukan apakah klaster ini dapat dihapus. Jika `DeletionProtection` diaktifkan, klaster tidak dapat dihapus kecuali jika diubah dan `DeletionProtection` dinonaktifkan. `DeletionProtection` melindungi 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 `SnapshotIdentifier` dienkripsi, maka cluster yang dipulihkan dienkripsi menggunakan AWS KMS kunci yang digunakan untuk mengenkripsi snapshot atau snapshot cluster.
+ Jika snapshot atau snapshot klaster di `SnapshotIdentifier` tidak dienkripsi, maka klaster DB yang dipulihkan tidak dienkripsi.
Tipe: String
Wajib: Tidak
** NetworkType **
Jenis jaringan cluster.
Jenis jaringan ditentukan oleh yang `DBSubnetGroup` ditentukan untuk cluster. A hanya `DBSubnetGroup` dapat mendukung IPv4 protokol atau IPv4 dan IPv6 protokol ()`DUAL`.
Untuk informasi selengkapnya, lihat [cluster DocumentDB di VPC di Panduan Pengembang Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/vpc-clusters.html).
Nilai Valid: `IPV4` \$1 `DUAL`
Tipe: String
Wajib: Tidak
** Port **
Nomor port tempat klaster baru menerima koneksi.
Kendala: Harus berupa nilai dari `1150` hingga `65535`.
Default: Port yang sama dengan klaster asli.
Tipe: Integer
Wajib: Tidak
** ServerlessV2ScalingConfiguration **
Berisi konfigurasi penskalaan cluster Amazon DocumentDB Tanpa Server.
Tipe: Objek [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md)
Wajib: Tidak
** StorageType **
Jenis penyimpanan untuk mengasosiasikan 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 | iopt1`
Nilai default adalah `standard `
Tipe: String
Wajib: Tidak
**Tags.Tag.N**
Tag yang akan ditetapkan ke klaster yang dipulihkan.
Tipe: Array objek [Tag](API_Tag.md)
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](API_DBCluster.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** 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 **
`DBClusterSnapshotIdentifier` tidak mengacu ke sebuah snapshot klaster yang ada.
Kode Status HTTP: 404
** DBSnapshotNotFound **
`DBSnapshotIdentifier` tidak mengacu ke sebuah snapshot yang ada.
Kode Status HTTP: 404
** DBSubnetGroupNotFoundFault **
`DBSubnetGroupName` tidak mengacu ke grup subnet yang ada.
Kode Status HTTP: 404
** DBSubnetGroupNotFoundFault **
`DBSubnetGroupName` tidak 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
** NetworkTypeNotSupported **
Jenis jaringan tidak didukung oleh salah satu `DBSubnetGroup` atau versi mesin DB.
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 bahasa khusus AWS SDKs, lihat berikut ini:
+ [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/RestoreDBClusterFromSnapshot)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/RestoreDBClusterFromSnapshot)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/RestoreDBClusterFromSnapshot)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/RestoreDBClusterFromSnapshot)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/RestoreDBClusterFromSnapshot)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/RestoreDBClusterFromSnapshot)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/RestoreDBClusterFromSnapshot)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/RestoreDBClusterFromSnapshot)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/RestoreDBClusterFromSnapshot)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/RestoreDBClusterFromSnapshot)