Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mencadangkan dan memulihkan di Amazon DocumentDB
Amazon DocumentDB (dengan kompatibilitas MongoDB) terus mencadangkan data Anda ke Amazon Simple Storage Service (Amazon S3) selama 1–35 hari sehingga Anda dapat dengan cepat memulihkan ke titik mana pun dalam periode retensi pencadangan. Amazon DocumentDB juga mengambil snapshot otomatis data Anda sebagai bagian dari proses backup terus menerus ini.
**catatan**
Ini adalah bucket Amazon S3 yang dikelola layanan dan Anda tidak akan memiliki akses ke file backup. Jika Anda ingin mengontrol backup Anda sendiri, ikuti petunjuk pada [Membuang, Memulihkan, Mengimpor, dan Mengekspor Data](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore-dump_restore_import_export_data.html).
Anda juga dapat mempertahankan data backup di luar periode retensi pencadangan dengan membuat snapshot manual data klaster Anda. Proses backup tidak memengaruhi performa klaster Anda.
Bagian ini membahas kasus penggunaan untuk kemampuan backup di Amazon DocumentDB dan menunjukkan cara untuk mengelola backup untuk klaster Amazon DocumentDB Anda.
**Topics**
+ [Cadangkan dan pulihkan: konsep](backup_restore-nouns_verbs.md)
+ [Memahami penggunaan penyimpanan cadangan](backup_restore-understanding_backup_storage_usage.md)
+ [Membuang, memulihkan, mengimpor, dan mengekspor data](backup_restore-dump_restore_import_export_data.md)
+ [Pertimbangan snapshot cluster](backup_restore-cluster_snapshot_considerations.md)
+ [Membandingkan snapshot otomatis dan manual](backup_restore-compare_automatic_manual_snapshots.md)
+ [Membuat snapshot cluster manual](backup_restore-create_manual_cluster_snapshot.md)
+ [Menyalin snapshot cluster](backup_restore-copy_cluster_snapshot.md)
+ [Berbagi snapshot klaster](backup_restore-share_cluster_snapshots.md)
+ [Memulihkan dari snapshot cluster](backup_restore-restore_from_snapshot.md)
+ [Memulihkan ke titik waktu](backup_restore-point_in_time_recovery.md)
+ [Menghapus snapshot cluster](backup_restore-delete_cluster_snapshot.md)
# Cadangkan dan pulihkan: konsep
| Kata benda | Deskripsi | APIs (Kata kerja) |
| --- | --- | --- |
| Periode retensi cadangan | Jangka waktu antara 1 dan 35 hari di mana Anda dapat melakukan point-in-time pemulihan. | `create-db-cluster` `modify-db-cluster` `restore-db-cluster-to-point-in-time` |
| Volume penyimpanan Amazon DocumentDB | Volume penyimpanan yang sangat tersedia dan sangat tahan lama yang mereplikasi data enam cara di tiga Availability Zone. Sebuah klaster Amazon DocumentDB sangat tahan lama terlepas dari jumlah instans dalam klaster. | `create-db-cluster` `delete-db-cluster` |
| Periode pencadangan | Periode waktu dalam hari di mana snapshot otomatis diambil. | `create-db-cluster` `describe-db-cluster` `modify-db-cluster` |
| Snapshot otomatis | Snapshot harian yang merupakan backup penuh klaster dan dibuat secara otomatis oleh proses backup berkelanjutan di Amazon DocumentDB. | `restore-db-cluster-from-snapshot` `describe-db-cluster-snapshot-attributes` `describe-db-cluster-snapshots` |
| Snapshot manual | Snapshot yang Anda buat secara manual untuk mempertahankan backup penuh klaster di luar periode backup. | `create-db-cluster-snapshot` `copy-db-cluster-snapshot` `delete-db-cluster-snapshot` `describe-db-cluster-snapshot-attributes` `describe-db-cluster-snapshots` `modify-db-cluster-snapshot-attribute` |
# Memahami penggunaan penyimpanan cadangan
Penyimpanan backup Amazon DocumentDB terdiri dari backup berkelanjutan dalam periode retensi pencadangan dan snapshot manual di luar periode retensi. Untuk mengontrol penggunaan penyimpanan backup, Anda dapat mengurangi interval retensi backup, menghapus snapshot manual lama saat tidak lagi diperlukan, atau keduanya. Untuk informasi umum tentang backup Amazon DocumentDB, lihat [Mencadangkan dan memulihkan di Amazon DocumentDB](backup_restore.md). Untuk informasi harga tentang penyimpanan backup Amazon DocumentDB, lihat [Harga Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/).
Untuk mengontrol biaya Anda, Anda dapat memantau jumlah penyimpanan yang digunakan oleh pencadangan berkelanjutan dan snapshot manual yang terus berlanjut melampaui periode penyimpanan. Kemudian Anda dapat mengurangi interval retensi cadangan dan menghapus snapshot manual ketika tidak diperlukan lagi.
Anda dapat menggunakan CloudWatch metrik Amazon`TotalBackupStorageBilled`,`SnapshotStorageUsed`, dan `BackupRetentionPeriodStorageUsed` untuk meninjau dan memantau jumlah penyimpanan yang digunakan oleh backup Amazon DocumentDB Anda, sebagai berikut:
+ `BackupRetentionPeriodStorageUsed` menunjukkan jumlah penyimpanan backup yang digunakan, untuk menyimpan backup berkelanjutan pada saat ini. Nilai metrik ini bergantung pada ukuran volume klaster dan jumlah perubahan yang Anda buat selama periode retensi. Namun, untuk tujuan penagihan, metrik tidak melebihi ukuran volume klaster kumulatif selama periode retensi. Misalnya, jika ukuran klaster Anda adalah 100 GiB dan periode retensi Anda adalah dua hari, nilai maksimum untuk `BackRetentionPeriodStorageUsed` adalah 200 GiB (100 GiB \$1 100 GiB).
+ `SnapshotStorageUsed` mewakili jumlah penyimpanan backup yang digunakan, untuk menyimpan snapshot manual di luar periode retensi pencadangan. Snapshot manual yang diambil dalam periode retensi tidak dihitung terhadap penyimpanan backup Anda. Demikian pula, snapshot otomatis tidak dihitung terhadap penyimpanan backup Anda. Ukuran masing-masing snapshot adalah ukuran volume klaster pada saat Anda mengambil snapshot. Nilai `SnapshotStorageUsed` bergantung pada jumlah snapshot yang disimpan dan ukuran setiap snapshot. Misalnya, Anda memiliki satu snapshot di luar periode retensi dan ukuran volume klaster adalah 100 GiB saat snapshot itu diambil. Jumlah `SnapshotStorageUsed` adalah 100 GiB.
+ `TotalBackupStorageBilled` mewakili jumlah dari `BackupRetentionPeriodStorageUsed` dan `SnapshotStorageUsed`, dikurangi jumlah penyimpanan backup gratis yang setara dengan ukuran volume klaster selama satu hari. Misalnya, jika ukuran klaster Anda adalah 100 GiB, Anda memiliki satu hari retensi, dan Anda memiliki satu snapshot di luar periode retensi, `TotalBackupStorageBilled`-nya adalah 100 GiB (100 GiB \$1 100 GiB - 100 GiB).
+ Metrik ini dihitung secara independen untuk setiap klaster Amazon DocumentDB.
[Anda dapat memantau klaster Amazon DocumentDB dan membuat laporan CloudWatch menggunakan metrik melalui konsol. CloudWatch ](https://console.aws.amazon.com/cloudwatch) Untuk informasi selengkapnya tentang cara menggunakan CloudWatch metrik, lihat[Memantau Amazon DocumentDB](monitoring_docdb.md).
# Membuang, memulihkan, mengimpor, dan mengekspor data
Anda dapat menggunakan utilitas `mongodump`, `mongorestore`, `mongoexport`, dan `mongoimport` untuk memindahkan data masuk dan keluar dari klaster Amazon DocumentDB Anda. Bagian ini membahas tujuan masing-masing alat dan konfigurasi ini untuk membantu Anda mencapai performa yang lebih baik.
**Topics**
+ [`mongodump`](#backup_restore-dump_restore_import_export_data-mongodump)
+ [`mongorestore`](#backup_restore-dump_restore_import_export_data-mongorestore)
+ [`mongoexport`](#backup_restore-dump_restore_import_export_data-mongoexport)
+ [`mongoimport`](#backup_restore-dump_restore_import_export_data-mongoimport)
+ [Tutorial](#backup_restore-dump_restore_import_export_data-tutorial)
## `mongodump`
Utilitas `mongodump` membuat backup biner (BSON) dari basis data MongoDB. Alat `mongodump` adalah metode yang disukai untuk membuang data dari deployment MongoDB sumber Anda ketika ingin memulihkannya ke dalam klaster Amazon DocumentDB Anda karena efisiensi ukuran yang dicapai dengan menyimpan data dalam format biner.
Bergantung pada sumber daya yang tersedia pada instance atau mesin yang Anda gunakan untuk menjalankan perintah, Anda dapat mempercepat `mongodump` dengan meningkatkan jumlah koleksi paralel yang dibuang dari default 1 menggunakan opsi. `--numParallelCollections` Aturan praktis yang baik adalah memulai dengan satu pekerja per vCPU pada instans utama klaster Amazon DocumentDB Anda.
**catatan**
Kami merekomendasikan MongoDB Database Tools hingga dan termasuk versi 100.6.1 untuk Amazon DocumentDB. [Anda dapat mengakses unduhan Alat Database MongoDB di sini.](https://www.mongodb.com/download-center/database-tools/releases/archive)
### Contoh penggunaan
Berikut ini adalah contoh penggunaan utilitas `mongodump` dalam klaster Amazon DocumentDB, `sample-cluster`.
```
mongodump --ssl \
--host="sample-cluster.node.us-east-1.docdb.amazonaws.com:27017" \
--collection=sample-collection \
--db=sample-database \
--out=sample-output-file \
--numParallelCollections 4 \
--username=sample-user \
--password=abc0123 \
--sslCAFile global-bundle.pem
```
## `mongorestore`
Utilitas `mongorestore` memungkinkan Anda untuk memulihkan backup biner (BSON) dari basis data yang telah dibuat dengan utilitas `mongodump`. Anda dapat meningkatkan performa pemulihan dengan meningkatkan jumlah pekerja untuk setiap koleksi selama pemulihan dengan opsi `--numInsertionWorkersPerCollection` (default-nya adalah 1). Aturan praktis yang baik adalah memulai dengan satu pekerja per vCPU pada instans utama klaster Amazon DocumentDB Anda.
### Contoh penggunaan
Berikut ini adalah contoh penggunaan utilitas `mongorestore` dalam klaster Amazon DocumentDB, `sample-cluster`.
```
mongorestore --ssl \
--host="sample-cluster.node.us-east-1.docdb.amazonaws.com:27017" \
--username=sample-user \
--password=abc0123 \
--sslCAFile global-bundle.pem
```
## `mongoexport`
Alat `mongoexport` mengekspor data di Amazon DocumentDB ke format file JSON, CSV, atau TSV. Alat `mongoexport` adalah metode yang disukai untuk mengekspor data yang harus dapat dibaca oleh manusia atau mesin.
**catatan**
`mongoexport` tidak secara langsung mendukung ekspor paralel. Namun, dimungkinkan untuk meningkatkan performa dengan mengeksekusi beberapa tugas `mongoexport` secara bersamaan untuk koleksi yang berbeda.
### Contoh penggunaan
Berikut ini adalah contoh penggunaan alat `mongoexport` dalam klaster Amazon DocumentDB, `sample-cluster`.
```
mongoexport --ssl \
--host="sample-cluster.node.us-east-1.docdb.amazonaws.com:27017" \
--collection=sample-collection \
--db=sample-database \
--out=sample-output-file \
--username=sample-user \
--password=abc0123 \
--sslCAFile global-bundle.pem
```
## `mongoimport`
Alat `mongoimport` mengimpor isi file JSON, CSV, atau TSV ke dalam klaster Amazon DocumentDB. Anda dapat menggunakan parameter `-–numInsertionWorkers` untuk memparalelkan dan mempercepat impor (default-nya adalah 1).
### Contoh penggunaan
Berikut ini adalah contoh penggunaan alat `mongoimport` dalam klaster Amazon DocumentDB, `sample-cluster`.
```
mongoimport --ssl \
--host="sample-cluster.node.us-east-1.docdb.amazonaws.com:27017" \
--collection=sample-collection \
--db=sample-database \
--file= \
--numInsertionWorkers 4 \
--username=sample-user \
--password=abc0123 \
--sslCAFile global-bundle.pem
```
## Tutorial
Tutorial berikut ini menjelaskan cara menggunakan utilitas `mongodump`, `mongorestore`, `mongoexport`, dan `mongoimport` untuk memindahkan data masuk dan keluar dari klaster Amazon DocumentDB.
1. **Prasyarat** — Sebelum Anda mulai, pastikan bahwa klaster Amazon DocumentDB Anda telah disediakan dan bahwa Anda memiliki akses ke Instans Amazon EC2 di VPC yang sama dengan klaster Anda. Untuk informasi selengkapnya, lihat [Connect menggunakan Amazon EC2](connect-ec2.md).
Untuk dapat menggunakan alat utilitas mongo, Anda harus menginstal mongodb-org-tools paket di instans EC2 Anda, sebagai berikut.
```
sudo yum install mongodb-org-tools-4.0.18
```
Karena Amazon DocumentDB menggunakan enkripsi Keamanan Lapisan Pengangkutan (TLS) secara default, Anda juga harus mengunduh file otoritas sertifikat (CA) Amazon RDS untuk menggunakan shell mongo guna menghubungkan, sebagai berikut.
```
wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem
```
1. **Unduh data sampel** — Untuk tutorial ini, Anda akan mengunduh beberapa data sampel yang berisi informasi tentang restoran.
```
wget https://raw.githubusercontent.com/ozlerhakan/mongodb-json-files/master/datasets/restaurant.json
```
1. **Impor data sampel ke Amazon DocumentDB** — Karena data dalam format JSON logis, Anda akan menggunakan utilitas `mongoimport` untuk mengimpor data ke dalam klaster Amazon DocumentDB Anda.
```
mongoimport --ssl \
--host="tutorialCluster.amazonaws.com:27017" \
--collection=restaurants \
--db=business \
--file=restaurant.json \
--numInsertionWorkers 4 \
--username= \
--password= \
--sslCAFile global-bundle.pem
```
1. **Dump data dengan `mongodump` ** — Sekarang setelah Anda memiliki data di klaster Amazon DocumentDB, Anda dapat melakukan dump biner dari data tersebut menggunakan utilitas `mongodump`.
```
mongodump --ssl \
--host="tutorialCluster.us-east-1.docdb.amazonaws.com:27017"\
--collection=restaurants \
--db=business \
--out=restaurantDump.bson \
--numParallelCollections 4 \
--username= \
--password= \
--sslCAFile global-bundle.pem
```
1. **Jatuhkan koleksi `restaurants`** — Sebelum Anda memulihkan koleksi `restaurants` di basis data `business`, Anda harus terlebih dahulu menjatuhkan koleksi yang sudah ada dalam basis data tersebut, sebagai berikut.
```
use business
```
```
db.restaurants.drop()
```
1. **Pulihkan data dengan `mongorestore`** — Dengan dump biner data dari Langkah 3, Anda sekarang dapat menggunakan utilitas `mongorestore` untuk memulihkan data Anda ke klaster Amazon DocumentDB Anda.
```
mongorestore --ssl \
--host="tutorialCluster.us-east-1.docdb.amazonaws.com:27017" \
--numParallelCollections 4 \
--username= \
--password= \
--sslCAFile global-bundle.pem restaurantDump.bson
```
1. **Ekspor data menggunakan `mongoexport`** — Untuk menyelesaikan tutorial, ekspor data dari klaster Anda dalam format file JSON, tidak berbeda dari file yang Anda impor di Langkah 1.
```
mongoexport --ssl \
--host="tutorialCluster.node.us-east-1.docdb.amazonaws.com:27017" \
--collection=restaurants \
--db=business \
--out=restaurant2.json \
--username= \
--password= \
--sslCAFile global-bundle.pem
```
1. **Validasi** — Anda dapat memvalidasi bahwa output dari Langkah 5 menghasilkan hasil yang sama seperti Langkah 1 dengan perintah berikut.
```
wc -l restaurant.json
```
Output dari perintah ini:
```
2548 restaurant.json
```
```
wc -l restaurant2.json
```
Output dari perintah ini:
```
2548 restaurant2.json
```
# Pertimbangan snapshot cluster
Amazon DocumentDB membuat snapshot otomatis harian dari klaster Anda selama jendela backup klaster Anda. Amazon DocumentDB menyimpan snapshot otomatis dari klaster Anda sesuai periode retensi pencadangan yang Anda tentukan. Jika perlu, Anda dapat memulihkan klaster Anda ke setiap titik waktu selama periode retensi pencadangan. Snapshot otomatis tidak terjadi saat operasi penyalinan dijalankan di Wilayah yang sama untuk klaster yang sama.
**Topics**
+ [Penyimpanan cadangan](#backup_restore-backup_storage)
+ [Periode pencadangan](#backup_restore-backup_window)
+ [Periode retensi cadangan](#backup_restore-backup_retention_period)
+ [Salin enkripsi snapshot cluster](#backup_restore-encryption)
Selain untuk snapshot klaster otomatis, Anda juga dapat membuat snapshot klaster secara manual. Anda dapat menyalin snapshot otomatis dan manual. Untuk informasi selengkapnya, lihat [Membuat snapshot cluster manual](backup_restore-create_manual_cluster_snapshot.md) dan [Menyalin snapshot cluster Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md).
**catatan**
Klaster Anda harus dalam status *tersedia* agar snapshot otomatis diambil.
Anda tidak dapat membagikan snapshot klaster otomatis Amazon DocumentDB. Sebagai solusinya, Anda dapat membuat snapshot manual dengan menyalin snapshot otomatis, lalu membagikan salinan tersebut. Untuk informasi selengkapnya tentang menyalin snapshot, lihat [Menyalin snapshot cluster Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md). Untuk informasi selengkapnya tentang memulihkan klaster dari snapshot, lihat [Memulihkan dari snapshot cluster](backup_restore-restore_from_snapshot.md).
## Penyimpanan cadangan
Penyimpanan cadangan Amazon DocumentDB Anda untuk Wilayah AWS masing-masing terdiri dari penyimpanan cadangan yang diperlukan untuk periode retensi cadangan Anda, yang mencakup snapshot cluster otomatis dan manual di Wilayah tersebut. Periode retensi cadangan default adalah 1 hari. Untuk informasi selengkapnya tentang harga penyimpanan backup, lihat [Harga Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/).
Ketika Anda menghapus sebuah klaster, semua snapshot otomatisnya dihapus dan tidak dapat dipulihkan. Namun, snapshot manual tidak dihapus ketika Anda menghapus klaster. Jika Anda memilih agar Amazon DocumentDB membuat snapshot akhir (snapshot manual) sebelum klaster Anda dihapus, Anda dapat menggunakan snapshot akhir untuk memulihkan klaster Anda.
Untuk informasi selengkapnya tentang snapshot dan penyimpanan, lihat [Memahami penggunaan penyimpanan cadangan](backup_restore-understanding_backup_storage_usage.md).
## Periode pencadangan
Snapshot otomatis terjadi setiap hari selama jendela backup yang dipilih. Jika snapshot memerlukan waktu lebih dari yang dialokasikan ke jendela backup, proses backup berlanjut hingga selesai, meskipun jendela backup telah berakhir. Jendela backup tidak dapat menindih jendela pemeliharaan mingguan untuk klaster.
Jika Anda tidak menentukan jendela backup yang diinginkan saat Anda membuat klaster, Amazon DocumentDB menetapkan jendela backup 30 menit default. Jendela ini dipilih secara acak dari blok waktu 8 jam yang terkait dengan Wilayah klaster Anda. Anda dapat mengubah jendela backup pilihan Anda dengan memodifikasi klaster. Untuk informasi selengkapnya, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md).
| Nama Wilayah | Region | Blok Waktu UTC |
| --- | --- | --- |
| AS Timur (Ohio) | us-east-2 | 03:00-11:00 |
| US East (Northern Virginia) | us-east-1 | 03:00-11:00 |
| AS Barat (Oregon) | us-west-2 | 06:00-14:00 |
| Africa (Cape Town) | af-south-1 | 03:00 — 11:00 |
| Asia Pasifik (Hong Kong) | ap-east-1 | 06:00-14:00 |
| Asia Pasifik (Hyderabad) | ap-south-2 | 06:30 — 14:30 |
| Asia Pasifik (Malaysia) | ap-southeast-5 | 13:00-21:00 |
| Asia Pasifik (Mumbai) | ap-south-1 | 06:00-14:00 |
| Asia Pacific (Osaka) | ap-northeast-3 | 12:00-20:00 |
| Asia Pasifik (Seoul) | ap-northeast-2 | 13:00-21:00 |
| Asia Pasifik (Singapura) | ap-southeast-1 | 14:00-22:00 |
| Asia Pasifik (Sydney) | ap-southeast-2 | 12:00-20:00 |
| Asia Pasifik (Jakarta) | ap-southeast-3 | 08:00-16:00 |
| Asia Pacific (Melbourne) | ap-southeast-4 | 11:00-19:00 |
| Asia Pasifik (Thailand) | ap-tenggara 7 | 15:00-23:00 |
| Asia Pasifik (Tokyo) | ap-northeast-1 | 13:00-21:00 |
| Kanada (Pusat) | ca-central-1 | 03:00-11:00 |
| Tiongkok (Beijing) | cn-north-1 | 06:00-14:00 |
| Tiongkok (Ningxia) | cn-northwest-1 | 06:00-14:00 |
| Eropa (Frankfurt) | eu-central-1 | 21:00-05:00 |
| Europe (Zurich) | eu-central-2 | 02:00-10:00 |
| Eropa (Irlandia) | eu-west-1 | 22:00-06:00 |
| Eropa (London) | eu-west-2 | 22:00-06:00 |
| Europe (Milan) | eu-south-1 | 02:00-10:00 |
| Eropa (Paris) | eu-west-3 | 23:59-07:29 |
| Eropa (Spanyol) | eu-south-2 | 02:00 — 10:00 |
| Eropa (Stockholm) | eu-north-1 | 04:00 — 12:00 |
| Meksiko (Tengah) | mx-pusat-1 | 03:00-11:00 |
| Timur Tengah (UAE) | me-central-1 | 05:00 — 13:00 |
| Amerika Selatan (Sao Paulo) | sa-east-1 | 00:00-08:00 |
| Israel (Tel Aviv) | il-central-1 | 04:00-12:00 |
| AWS GovCloud (AS-Timur) | us-gov-east-1 | 17:00-01:00 |
| AWS GovCloud (AS-Barat) | us-gov-west-1 | 06:00-14:00 |
## Periode retensi cadangan
Periode retensi cadangan adalah jumlah hari backup otomatis dipertahankan sebelum dihapus secara otomatis. Amazon DocumentDB mendukung periode retensi cadangan selama 1-35 hari.
Anda dapat mengatur periode retensi cadangan saat Anda membuat klaster. Jika Anda tidak secara eksplisit mengatur periode retensi cadangan, periode retensi cadangan default selama 1 hari ditetapkan ke klaster Anda. Setelah Anda membuat klaster, Anda dapat memodifikasi periode retensi cadangan dengan memodifikasi cluster menggunakan salah satu Konsol Manajemen AWS atau. AWS CLI Untuk informasi selengkapnya, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md).
## Salin enkripsi snapshot cluster
Enkripsi cluster dan snapshot didasarkan pada kunci enkripsi KMS. ID kunci KMS adalah Amazon Resource Name (ARN), pengidentifikasi kunci KMS, atau alias kunci KMS untuk kunci enkripsi KMS.
Pedoman dan batasan berikut berlaku:
+ Enkripsi disimpulkan dari cluster saat membuat snapshot. Jika cluster dienkripsi, snapshot cluster itu dienkripsi dengan kunci KMS yang sama. Jika cluster tidak dienkripsi, snapshot tidak dienkripsi.
+ Jika Anda menyalin snapshot kluster terenkripsi dari akun Amazon Web Services, Anda dapat menentukan nilai `KmsKeyId` untuk mengenkripsi salinan dengan kunci enkripsi KMS baru. Jika Anda tidak menentukan nilai untuk`KmsKeyId`, maka salinan snapshot cluster dienkripsi dengan kunci KMS yang sama dengan snapshot cluster sumber.
+ Jika Anda menyalin snapshot kluster terenkripsi yang dibagikan dari akun Amazon Web Services lainnya, Anda harus menentukan nilainya. `KmsKeyId`
+ Untuk menyalin snapshot kluster terenkripsi ke Wilayah Amazon Web Services lainnya, atur `KmsKeyId` ke ID kunci KMS yang ingin Anda gunakan untuk mengenkripsi salinan snapshot klaster di Wilayah tujuan. Kunci enkripsi KMS khusus untuk Wilayah Amazon Web Services tempat mereka dibuat, dan Anda tidak dapat menggunakan kunci enkripsi dari satu Wilayah Amazon Web Services di Wilayah Amazon Web Services lainnya.
+ Jika Anda menyalin snapshot klaster yang tidak terenkripsi dan menentukan nilai untuk parameter `KmsKeyId`, kesalahan akan dikembalikan.
# Membandingkan snapshot otomatis dan manual
Berikut ini adalah fitur utama dari snapshot otomatis dan manual Amazon DocumentDB (dengan kompatibilitas MongoDB).
**Snapshot otomatis Amazon DocumentDB memiliki fitur utama berikut:**
+ **Penamaan snapshot otomatis** — Nama snapshot otomatis mengikuti pola `rds:-yyyy-mm-dd-hh-mm`, dengan `yyyy-mm-dd-hh-mm` mewakili tanggal dan waktu snapshot dibuat.
+ **Dibuat secara otomatis sesuai jadwal** — Ketika Anda membuat atau memodifikasi klaster, Anda dapat mengatur *Periode retensi cadangan* ke nilai bilangan bulat dari 1 sampai 35 hari. Secara default, klaster baru memiliki periode retensi cadangan selama 1 hari. Periode retensi cadangan menentukan jumlah hari snapshot otomatis disimpan sebelum dihapus secara otomatis. Anda tidak dapat menonaktifkan backup otomatis di klaster Amazon DocumentDB.
Selain mengatur periode retensi cadangan, Anda juga mengatur *jendela backup*, waktu hari dimana snapshot otomatis dibuat.
+ **Menghapus snapshot otomatis** — Snapshot otomatis dihapus ketika Anda menghapus klaster snapshot otomatis. Anda tidak dapat menghapus snapshot otomatis secara manual.
+ **Tambahan** — Selama periode retensi cadangan, pembaruan basis data dicatat sehingga ada catatan inkremental dari perubahan.
+ **Memulihkan dari snapshot otomatis** — Anda dapat memulihkan dari snapshot otomatis menggunakan Konsol Manajemen AWS atau AWS CLI. *Saat Anda memulihkan dari snapshot menggunakan AWS CLI, Anda harus menambahkan instance secara terpisah setelah cluster tersedia.*
+ **Membagikan** — Anda tidak dapat membagikan snapshot klaster otomatis Amazon DocumentDB. Sebagai solusinya, Anda dapat membuat snapshot manual dengan menyalin snapshot otomatis, lalu membagikan salinan tersebut. Untuk informasi selengkapnya tentang menyalin snapshot, lihat [Menyalin snapshot cluster Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md). Untuk informasi selengkapnya tentang memulihkan klaster dari snapshot, lihat [Memulihkan dari snapshot cluster](backup_restore-restore_from_snapshot.md).
+ **Anda dapat memulihkan dari titik mana pun dalam periode retensi cadangan** — Karena pembaruan basis data dicatat secara bertahap, Anda dapat memulihkan klaster Anda ke setiap titik waktu dalam periode retensi cadangan.
*Saat Anda memulihkan dari snapshot otomatis atau dari point-in-time pemulihan menggunakan AWS CLI, Anda harus menambahkan instance secara terpisah setelah cluster tersedia.*
**Snapshot manual Amazon DocumentDB memiliki fitur utama berikut:**
+ **Dibuat sesuai permintaan** - Snapshot manual Amazon DocumentDB dibuat sesuai permintaan menggunakan Amazon DocumentDB Management Console atau. AWS CLI
+ **Menghapus snapshot manual** — Sebuah snapshot manual dihapus hanya ketika Anda secara eksplisit menghapusnya menggunakan konsol Amazon DocumentDB atau AWS CLI. Snapshot manual tidak dihapus saat Anda menghapus klasternya.
+ **Backup lengkap** — Ketika snapshot manual diambil, backup lengkap dari data klaster Anda dibuat dan disimpan.
+ **Penamaan snapshot manual** — Anda menentukan nama snapshot manual. Amazon DocumentDB tidak menambahkan cap `datetime` ke nama, sehingga Anda harus menambahkan informasi itu jika Anda ingin itu disertakan dalam nama.
+ **Memulihkan dari snapshot manual** — Anda dapat memulihkan dari snapshot manual menggunakan konsol atau AWS CLI. *Saat Anda memulihkan dari snapshot menggunakan AWS CLI, Anda harus menambahkan instance secara terpisah setelah cluster tersedia.*
+ **Service Quotas** — Anda dibatasi maksimal 100 snapshot manual per. Wilayah AWS
+ **Membagikan** — Anda dapat berbagi snapshot klaster manual, yang dapat disalin oleh Akun AWS yang diotorisasi. Anda dapat berbagi snapshot manual yang terenkripsi atau tidak terenkripsi. Untuk informasi selengkapnya tentang menyalin snapshot, lihat [Menyalin snapshot cluster Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md).
+ **Anda memulihkan ke saat snapshot manual diambil** — Saat Anda memulihkan dari snapshot manual, Anda memulihkan ke saat snapshot manual diambil.
*Saat Anda memulihkan dari snapshot menggunakan AWS CLI, Anda harus menambahkan instance secara terpisah setelah cluster tersedia.*
# Membuat snapshot cluster manual
Anda dapat membuat snapshot manual menggunakan Konsol Manajemen AWS atau AWS CLI. Jumlah waktu yang dibutuhkan untuk membuat snapshot berbeda-beda sesuai dengan ukuran dari basis data Anda. Saat Anda membuat snapshot, Anda harus melakukan hal berikut:
1. Mengidentifikasi klaster mana yang akan dicadangkan.
1. Berikan nama snapshot Anda. Hal ini memungkinkan Anda untuk memulihkan dari itu nanti.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk membuat snapshot manual menggunakan Konsol Manajemen AWS, Anda dapat mengikuti salah satu metode di bawah ini.
1. **Metode 1:**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Snapshot**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Pada halaman **Snapshot**, pilih **Buat**.
1. Pada halaman **Membuat snapshot klaster**:
1. **Pengidentifikasi klaster** — Dari daftar tarik-turun klaster, pilih klaster yang ingin Anda buat snapshotnya.
1. **Pengidentifikasi snapshot** — Masukkan nama untuk snapshot Anda.
Batasan penamaan snapshot:
+ Panjangnya adalah [1–255] huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
+ Harus unik untuk semua klaster (di Amazon RDS, Amazon Neptune, dan Amazon DocumentDB) per akun AWS , per Wilayah.
1. Pilih **Buat**.
1. **Metode 2:**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Klaster**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Pada halaman **Klaster**, pilih tombol di sebelah kiri pada klaster yang ingin Anda snapshot.
1. Dari menu **Tindakan**, pilih **Ambil snapshot**.
1. Pada halaman **Membuat snapshot klaster**:
1. **Pengidentifikasi snapshot** — Masukkan nama untuk snapshot Anda.
Batasan penamaan snapshot:
+ Panjangnya adalah [1–63] huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
+ Harus unik untuk semua klaster (di Amazon RDS, Amazon Neptune, dan Amazon DocumentDB) per akun AWS , per Wilayah.
1. Pilih **Buat**.
------
#### [ Using the AWS CLI ]
Untuk membuat snapshot cluster menggunakan AWS CLI, gunakan `create-db-cluster-snapshot` operasi dengan parameter berikut.
**Parameter**
+ **--db-cluster-identifier** — Diperlukan. Nama klaster yang ingin Anda ambil snapshotnya. Klaster ini harus ada dan *tersedia*.
+ **--db-cluster-snapshot-identifier** — Diperlukan. Nama snapshot manual yang Anda buat.
Contoh berikut membuat snapshot bernama `sample-cluster-snapshot` untuk klaster bernama `sample-cluster`.
Untuk Linux, macOS, atau Unix:
```
aws docdb create-db-cluster-snapshot \
--db-cluster-identifier sample-cluster \
--db-cluster-snapshot-identifier sample-cluster-snapshot
```
Untuk Windows:
```
aws docdb create-db-cluster-snapshot ^
--db-cluster-identifier sample-cluster ^
--db-cluster-snapshot-identifier sample-cluster-snapshot
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBClusterSnapshot": {
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1c"
],
"DBClusterSnapshotIdentifier": "sample-cluster-snapshot",
"DBClusterIdentifier": "sample-cluster",
"SnapshotCreateTime": "2020-04-24T04:59:08.475Z",
"Engine": "docdb",
"Status": "creating",
"Port": 0,
"VpcId": "vpc-abc0123",
"ClusterCreateTime": "2020-01-10T22:13:38.261Z",
"MasterUsername": "master-user",
"EngineVersion": "4.0.0",
"SnapshotType": "manual",
"PercentProgress": 0,
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DBClusterSnapshotArn": "arn:aws:rds:us-east-1::cluster-snapshot:sample-cluster-snapshot"
}
}
```
------
# Menyalin snapshot cluster Amazon DocumentDB
Di Amazon DocumentDB, Anda dapat menyalin snapshot dalam Wilayah AWS hal yang sama atau berbeda. Wilayah AWS Anda juga dapat menyalin snapshot bersama ke akun Anda dalam hal yang sama Wilayah AWS atau berbeda Wilayah AWS. Untuk informasi selengkapnya tentang berbagi snapshot, lihat [Berbagi snapshot cluster Amazon DocumentDB](backup_restore-share_cluster_snapshots.md).
**catatan**
Amazon DocumentDB menagih Anda berdasarkan jumlah backup dan data snapshot yang Anda simpan dan periode waktu Anda menyimpannya. Untuk informasi selengkapnya tentang penyimpanan yang terkait dengan backup dan snapshot Amazon DocumentDB, lihat [Memahami penggunaan penyimpanan cadangan](backup_restore-understanding_backup_storage_usage.md). Untuk informasi harga tentang penyimpanan Amazon DocumentDB, lihat [Harga Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/).
**Topics**
+ [Menyalin snapshot bersama](#backup_restore-copy_shared_cluster_snapshot)
+ [Menyalin snapshot di seluruh Wilayah AWS](#backup_restore-copy_snapshot_across_regions)
+ [Batasan](#backup_restore-copy_cluster_snapshot-limitations)
+ [Menangani enkripsi](#backup_restore-copy_cluster_snapshot-handle_encryption)
+ [Pertimbangan grup parameter](#backup_restore-copy_cluster_snapshot-parameter_group_considerations)
+ [Menyalin snapshot cluster](#backup_restore-copy_a_cluster_snapshot)
## Menyalin snapshot bersama
Anda dapat menyalin snapshot yang dibagikan kepada Anda oleh AWS akun lain. Jika Anda menyalin snapshot terenkripsi yang telah dibagikan dari AWS akun lain, Anda harus memiliki akses ke kunci AWS KMS enkripsi yang digunakan untuk mengenkripsi snapshot. Untuk informasi selengkapnya, lihat [Menangani enkripsi](#backup_restore-copy_cluster_snapshot-handle_encryption).
## Menyalin snapshot di seluruh Wilayah AWS
Saat Anda menyalin snapshot ke snapshot Wilayah AWS yang berbeda dari snapshot sumber Wilayah AWS, setiap salinan adalah snapshot lengkap. Salinan snapshot lengkap berisi semua data dan data meta yang diperlukan untuk memulihkan cluster Amazon DocumentDB.
## Batasan
Berikut adalah beberapa batasan saat Anda menyalin snapshot:
+ Jika Anda menghapus snapshot sumber sebelum snapshot target tersedia, salinan snapshot mungkin gagal. Verifikasi bahwa snapshot target memiliki status `AVAILABLE` sebelum Anda menghapus snapshot sumber.
+ Anda dapat memiliki maksimum lima permintaan penyalinan snapshot yang sedang berlangsung ke satu Wilayah tujuan per akun.
+ Bergantung pada yang Wilayah AWS terlibat dan jumlah data yang akan disalin, salinan snapshot lintas wilayah dapat memakan waktu berjam-jam untuk diselesaikan. Dalam beberapa kasus, mungkin ada sejumlah besar permintaan salinan snapshot lintas wilayah dari Wilayah AWS sumber tertentu. Dalam kasus ini, Amazon DocumentDB mungkin menempatkan permintaan salinan lintas wilayah baru dari Wilayah AWS sumber tersebut ke dalam antrian hingga beberapa salinan yang sedang berlangsung selesai. Tidak ada informasi kemajuan yang ditampilkan tentang penyalinan permintaan saat berada di antrean. Informasi progres akan ditampilkan saat penyalinan dimulai.
## Menangani enkripsi
Anda dapat menyalin snapshot yang telah dienkripsi menggunakan kunci enkripsi AWS KMS . Jika Anda menyalin snapshot terenkripsi, salinan snapshot tersebut juga harus dienkripsi. Jika Anda menyalin snapshot terenkripsi dalam yang sama Wilayah AWS, Anda dapat mengenkripsi salinan dengan kunci AWS KMS enkripsi yang sama dengan snapshot asli, atau Anda dapat menentukan kunci enkripsi yang berbeda. AWS KMS Jika Anda menyalin snapshot terenkripsi di seluruh Wilayah, Anda tidak dapat menggunakan kunci AWS KMS enkripsi yang sama untuk salinan seperti yang digunakan untuk snapshot sumber, karena AWS KMS kunci khusus Wilayah. Sebagai gantinya, Anda harus menentukan AWS KMS kunci yang valid di tujuan Wilayah AWS n.
Snapshot sumber tetap terenkripsi selama proses penyalinan. Untuk informasi selengkapnya, lihat [Perlindungan data di Amazon DocumentDB](security.data-protection.md).
**catatan**
Untuk snapshot klaster Amazon DocumentDB, Anda tidak dapat mengenkripsi snapshot klaster yang tidak dienkripsi saat Anda menyalin snapshot.
## Pertimbangan grup parameter
Saat Anda menyalin snapshot lintas Wilayah, salinan tersebut tidak menyertakan grup parameter yang digunakan oleh klaster Amazon DocumentDB asli. Saat Anda memulihkan snapshot untuk membuat cluster baru, cluster itu mendapatkan grup parameter default untuk Wilayah AWS itu dibuat. Untuk memberikan klaster baru parameter yang sama seperti aslinya, Anda harus melakukan hal berikut:
1. Di tujuan Wilayah AWS, [buat grup parameter cluster Amazon DocumentDB dengan pengaturan yang sama dengan cluster](https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_groups-create.html) asli. Jika sudah ada di yang baru Wilayah AWS, Anda dapat menggunakan yang itu.
1. Setelah memulihkan snapshot di tujuan Wilayah AWS, ubah cluster Amazon DocumentDB baru dan tambahkan grup parameter baru atau yang sudah ada dari langkah sebelumnya. Untuk informasi selengkapnya, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md).
## Menyalin snapshot cluster
Anda dapat menyalin cluster Amazon DocumentDB menggunakan atau Konsol Manajemen AWS , sebagai berikut AWS CLI.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk membuat salinan snapshot cluster menggunakan Konsol Manajemen AWS, selesaikan langkah-langkah berikut. Prosedur ini berfungsi untuk menyalin snapshot cluster terenkripsi atau tidak terenkripsi, di wilayah yang sama atau di seluruh Wilayah. Wilayah AWS
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Snapshot**, lalu pilih tombol di sebelah kiri snapshot yang ingin Anda salin.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Dari menu **Tindakan**, pilih **Salin**.
1. Di halaman **Buat Salinan snapshot klaster** yang dihasilkan, selesaikan bagian **Pengaturan**.
1. **Wilayah Tujuan** — Opsional. Untuk menyalin snapshot cluster ke yang lain Wilayah AWS, pilih itu Wilayah AWS untuk **Wilayah Tujuan**.
1. **Pengidentifikasi snapshot baru** — Masukkan nama untuk snapshot baru.
Batasan penamaan snapshot target:
+ Tidak dapat berupa nama snapshot yang sudah ada.
+ Panjangnya adalah [1—63] huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
+ Harus unik untuk semua cluster di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS
1. **Salin tag** — Untuk menyalin tag apa pun yang Anda miliki di snapshot sumber ke salinan snapshot Anda, pilih **Salin tag**.
1. Lengkapi ncryption-at-rest bagian **E**.
1. **Enkripsi saat istirahat** — Jika snapshot Anda tidak dienkripsi, opsi ini tidak tersedia untuk Anda karena Anda tidak dapat membuat salinan terenkripsi dari snapshot yang tidak terenkripsi. Jika snapshot Anda dienkripsi, Anda dapat mengubah yang AWS KMS key digunakan selama enkripsi saat istirahat.
Untuk informasi selengkapnya tentang mengenkripsi salinan snapshot, lihat. [Salin enkripsi snapshot cluster](backup_restore-cluster_snapshot_considerations.md#backup_restore-encryption)
Untuk informasi selengkapnya tentang enkripsi diam, lihat [Mengenkripsi data Amazon DocumentDB saat istirahat](encryption-at-rest.md).
1. **AWS KMS Kunci** - Dari daftar drop-down, pilih salah satu dari berikut ini:
+ **(default) aws/rds** - Nomor akun dan ID AWS KMS kunci tercantum mengikuti opsi ini.
+ **< some-key-name >** — Jika Anda membuat kunci, itu terdaftar dan tersedia untuk Anda pilih.
+ **Masukkan ARN kunci** — Dalam kotak **ARN**, masukkan Amazon Resource Name (ARN) untuk kunci AWS KMS Anda. Format ARN adalah `arn:aws:kms:::key/ `.
1. Untuk membuat salinan snapshot yang dipilih, pilih **Salin snapshot**. Sebagai alternatif, Anda dapat memilih **Batalkan** untuk tidak membuat salinan snapshot.
------
#### [ Using the AWS CLI ]
Untuk membuat salinan snapshot klaster yang tidak terenkripsi menggunakan AWS CLI, gunakan operasi `copy-db-cluster-snapshot` dengan parameter berikut. Jika Anda menyalin snapshot ke yang lain Wilayah AWS, jalankan perintah di mana snapshot akan disalin. Wilayah AWS
+ **--source-db-cluster-snapshot-identifier** — Diperlukan. Pengidentifikasi snapshot klaster untuk membuat salinan. Snapshot klaster harus ada dan dalam status tersedia. Jika Anda menyalin snapshot ke yang lain Wilayah AWS atau jika Anda menyalin snapshot cluster bersama, pengenal ini harus dalam format ARN dari snapshot cluster sumber. Parameter ini tidak peka huruf besar kecil.
+ **--target-db-cluster-snapshot-identifier** — Diperlukan. Pengidentifikasi snapshot klaster baru yang akan dibuat dari snapshot klaster sumber. Parameter ini tidak peka huruf besar kecil.
Batasan penamaan snapshot target:
+ Tidak dapat berupa nama snapshot yang sudah ada.
+ Panjangnya adalah [1—63] huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
+ Harus unik untuk semua cluster di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS
+ **--source-region**— Jika Anda menyalin snapshot ke yang lain Wilayah AWS, tentukan dari Wilayah AWS mana snapshot cluster terenkripsi akan disalin.
Jika Anda menyalin snapshot ke Wilayah AWS lain dan Anda tidak menentukan `--source-region`, Anda harus menentukan opsi `pre-signed-url` sebagai gantinya. `pre-signed-url`Nilai harus berupa URL yang berisi permintaan tanda tangan Versi 4 Tanda Tangan untuk `CopyDBClusterSnapshot` tindakan yang akan dipanggil di sumber Wilayah AWS tempat snapshot cluster disalin. Untuk mempelajari selengkapnya`pre-signed-url`, lihat [Menyalin DBCluster Snapshot](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CopyDBClusterSnapshot.html).
+ **--kms-key-id** — Pengidentifikasi kunci KMS agar kunci dapat digunakan untuk mengenkripsi salinan snapshot klaster.
Jika Anda menyalin snapshot cluster terenkripsi ke yang lain Wilayah AWS, parameter ini diperlukan. Anda harus menentukan kunci KMS untuk tujuan Wilayah AWS.
Jika Anda menyalin snapshot cluster terenkripsi dalam hal yang sama Wilayah AWS, parameter AWS KMS kuncinya adalah opsional. Salinan snapshot cluster dienkripsi dengan AWS KMS kunci yang sama dengan snapshot cluster sumber. Jika Anda ingin menentukan kunci AWS KMS enkripsi baru yang akan digunakan untuk mengenkripsi salinan, Anda dapat melakukannya menggunakan parameter ini.
+ **--copy-tags**- Opsional. Tag dan nilai yang akan disalin.
Untuk membatalkan operasi penyalinan setelah ia berlangsung, Anda dapat menghapus snapshot target yang diidentifikasi oleh `--target-db-cluster-snapshot-identifier` atau `TargetDBClusterSnapshotIdentifier` saat snapshot klaster tersebut berada dalam status **menyalin**.
**Example**
**Contoh 1: Salin snapshot yang tidak terenkripsi ke Wilayah yang sama**
AWS CLI Contoh berikut membuat salinan `sample-cluster-snapshot` bernama `sample-cluster-snapshot-copy` Wilayah AWS sama dengan snapshot sumber. Saat salinan dibuat, semua tag di snapshot asli disalin ke salinan snapshot.
Untuk Linux, macOS, atau Unix:
```
aws docdb copy-db-cluster-snapshot \
--source-db-cluster-snapshot-identifier sample-cluster-snapshot \
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \
--copy-tags
```
Untuk Windows:
```
aws docdb copy-db-cluster-snapshot ^
--source-db-cluster-snapshot-identifier sample-cluster-snapshot ^
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^
--copy-tags
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBClusterSnapshot": {
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1c"
],
"DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
"DBClusterIdentifier": "sample-cluster",
"SnapshotCreateTime": "2020-03-27T08:40:24.805Z",
"Engine": "docdb",
"Status": "copying",
"Port": 0,
"VpcId": "vpc-abcd0123",
"ClusterCreateTime": "2020-01-10T22:13:38.261Z",
"MasterUsername": "master-user",
"EngineVersion": "4.0.0",
"SnapshotType": "manual",
"PercentProgress": 0,
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:111122223333:key/sample-key-id",
"DBClusterSnapshotArn": "arn:aws:rds:us-east-1:111122223333:cluster-snapshot:sample-cluster-snapshot-copy",
"SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:111122223333:cluster-snapshot:sample-cluster-snapshot"
}
}
```
**Example**
**Contoh 2: Salin snapshot yang tidak terenkripsi Wilayah AWS**
AWS CLI Contoh berikut membuat salinan`sample-cluster-snapshot`, yang memiliki ARN`arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot`. Salinan ini diberi nama `sample-cluster-snapshot-copy` dan berada Wilayah AWS di tempat perintah dijalankan.
Untuk Linux, macOS, atau Unix:
```
aws docdb copy-db-cluster-snapshot \
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot \
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy
```
Untuk Windows:
```
aws docdb copy-db-cluster-snapshot ^
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot ^
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBClusterSnapshot": {
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1c"
],
"DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
"DBClusterIdentifier": "sample-cluster",
"SnapshotCreateTime": "2020-04-29T16:45:51.239Z",
"Engine": "docdb",
"AllocatedStorage": 0,
"Status": "copying",
"Port": 0,
"VpcId": "vpc-abc0123",
"ClusterCreateTime": "2020-04-28T16:43:00.294Z",
"MasterUsername": "master-user",
"EngineVersion": "4.0.0",
"LicenseModel": "docdb",
"SnapshotType": "manual",
"PercentProgress": 0,
"StorageEncrypted": false,
"DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
"SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot",
}
}
```
**Example**
**Contoh 3: Salin snapshot terenkripsi Wilayah AWS**
AWS CLI Contoh berikut membuat salinan `sample-cluster-snapshot` dari Wilayah us-west-2 ke Wilayah us-east-1. Perintah ini dipanggil di Wilayah us-east-1.
Untuk Linux, macOS, atau Unix:
```
aws docdb copy-db-cluster-snapshot \
--source-db-cluster-snapshot-identifier arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot \
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \
--source-region us-west-2 \
--kms-key-id sample-us-east-1-key
```
Untuk Windows:
```
aws docdb copy-db-cluster-snapshot ^
--source-db-cluster-snapshot-identifier arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot ^
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^
--source-region us-west-2 ^
--kms-key-id sample-us-east-1-key
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBClusterSnapshot": {
"AvailabilityZones": [],
"DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
"DBClusterIdentifier": "sample-cluster",
"SnapshotCreateTime": "2020-04-29T16:45:53.159Z",
"Engine": "docdb",
"AllocatedStorage": 0,
"Status": "copying",
"Port": 0,
"ClusterCreateTime": "2020-04-28T16:43:07.129Z",
"MasterUsername": "chimera",
"EngineVersion": "4.0.0",
"LicenseModel": "docdb",
"SnapshotType": "manual",
"PercentProgress": 0,
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/0846496a-d48e-41c4-9353-86d8301d7e35",
"DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
"SourceDBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot",
}
}
```
**Example**
**Contoh 4: Salin snapshot bersama yang tidak terenkripsi Wilayah AWS**
AWS CLI Contoh berikut, akun -`123456789012`, membuat salinan snapshot cluster tidak terenkripsi yang `sample-cluster-snapshot` dibagikan oleh akun - dari Wilayah us-east-1 `999999999999` ke Wilayah us-west-2. Perintah ini disebut di Wilayah us-west-2. Untuk informasi selengkapnya tentang berbagi snapshot, lihat [Berbagi snapshot](backup_restore-share_cluster_snapshots.md#backup_restore-share_snapshots).
Untuk Linux, macOS, atau Unix:
```
aws docdb copy-db-cluster-snapshot \
--region us-west-2 \
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot \
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy
```
Untuk Windows:
```
aws docdb copy-db-cluster-snapshot ^
--region us-west-2 ^
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot ^
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBClusterSnapshots": [
{
"AvailabilityZones": [],
"DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
"DBClusterIdentifier": "sample-cluster",
"SnapshotCreateTime": "2025-08-22T11:27:00.497000+00:00",
"Engine": "docdb",
"Status": "copying",
"Port": 0,
"ClusterCreateTime": "2024-07-02T16:44:50.246000+00:00",
"MasterUsername": "master-user",
"EngineVersion": "5.0.0",
"SnapshotType": "manual",
"PercentProgress": 0,
"StorageEncrypted": false,
"DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
"SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot"
}
]
}
```
**Example**
**Contoh 5: Salin snapshot bersama terenkripsi Wilayah AWS**
AWS CLI Contoh berikut, akun - `123456789012` membuat salinan snapshot cluster terenkripsi yang `sample-cluster-snapshot` dibagikan oleh akun - dari Wilayah us-east-1 `999999999999` ke Wilayah us-west-2. Snapshot target dienkripsi dengan kunci KMS yang dikelola pelanggan -. `arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28` Perintah ini disebut di Wilayah us-west-2. Untuk informasi selengkapnya tentang berbagi snapshot, lihat [Berbagi snapshot](backup_restore-share_cluster_snapshots.md#backup_restore-share_snapshots).
Untuk Linux, macOS, atau Unix:
```
aws docdb copy-db-cluster-snapshot \
--region us-west-2 \
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot \
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \
--kms-key-id arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28
```
Untuk Windows:
```
aws docdb copy-db-cluster-snapshot ^
--region us-west-2 ^
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot ^
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^
--kms-key-id arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBClusterSnapshots": [
{
"AvailabilityZones": [],
"DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
"DBClusterIdentifier": "sample-cluster",
"SnapshotCreateTime": "2025-08-22T11:27:00.497000+00:00",
"Engine": "docdb",
"Status": "copying",
"Port": 0,
"ClusterCreateTime": "2024-07-02T16:44:50.246000+00:00",
"MasterUsername": "master-user",
"EngineVersion": "5.0.0",
"SnapshotType": "manual",
"PercentProgress": 0,
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28",
"DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
"SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot"
}
]
}
```
**catatan**
Untuk informasi selengkapnya tentang mengenkripsi salinan snapshot, lihat. [Salin enkripsi snapshot cluster](backup_restore-cluster_snapshot_considerations.md#backup_restore-encryption)
Untuk informasi selengkapnya tentang enkripsi diam, lihat [Mengenkripsi data Amazon DocumentDB saat istirahat](encryption-at-rest.md).
------
# Berbagi snapshot cluster Amazon DocumentDB
Menggunakan Amazon DocumentDB, Anda dapat membagikan snapshot cluster manual dengan cara berikut:
+ Berbagi snapshot cluster manual, baik terenkripsi atau tidak terenkripsi, memungkinkan akun resmi AWS untuk menyalin snapshot.
+ Berbagi snapshot cluster manual, baik terenkripsi atau tidak terenkripsi, memungkinkan AWS akun resmi untuk secara langsung memulihkan cluster dari snapshot alih-alih mengambil salinannya dan memulihkannya.
**catatan**
Untuk membagikan snapshot klaster otomatis, buat snapshot cluster manual dengan menyalin snapshot otomatis, lalu bagikan salinan itu. Proses ini juga berlaku untuk sumber daya yang AWS dihasilkan oleh Backup.
Anda dapat berbagi snapshot manual dengan hingga 20 lainnya Akun AWS. Anda juga dapat berbagi snapshot manual yang tidak terenkripsi sebagai publik sehingga snapshot tersebut tersedia untuk semua akun . Saat membagikan snapshot sebagai publik, pastikan bahwa tidak ada informasi privat yang dimasukkan ke dalam snapshot publik Anda.
Saat berbagi snapshot manual dengan yang lain Akun AWS, dan Anda memulihkan cluster dari snapshot bersama menggunakan AWS CLI atau Amazon DocumentDB API, Anda harus menentukan Nama Sumber Daya Amazon (ARN) dari snapshot bersama sebagai pengenal snapshot.
## Berbagi snapshot terenkripsi
Pembatasan berikut berlaku untuk berbagi snapshot terenkripsi:
+ Anda tidak dapat berbagi snapshot terenkripsi sebagai publik.
+ Anda tidak dapat membagikan snapshot yang telah dienkripsi menggunakan kunci AWS KMS enkripsi default akun yang membagikan snapshot.
Ikuti langkah-langkah ini untuk berbagi snapshot terenkripsi.
1. Bagikan kunci enkripsi AWS Key Management Service (AWS KMS) yang digunakan untuk mengenkripsi snapshot dengan akun apa pun yang Anda inginkan untuk dapat mengakses snapshot.
Anda dapat berbagi kunci AWS KMS enkripsi dengan AWS akun lain dengan menambahkan akun lain ke kebijakan AWS KMS kunci. Untuk detail tentang memperbarui kebijakan utama, lihat [Menggunakan Kebijakan Utama di AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) di *Panduan AWS Key Management Service Pengembang*. Untuk contoh pembuatan kebijakan kunci, lihat [Membuat kebijakan IAM untuk memungkinkan penyalinan snapshot yang dienkripsi](#backup_restore-share_encrypted_snapshots-create_key_policy) nanti dalam topik ini.
1. Gunakan AWS CLI, [seperti yang ditunjukkan di bawah ini](#backup_restore-share_snapshots), untuk membagikan snapshot terenkripsi dengan akun lain.
### Mengizinkan akses ke kunci AWS KMS enkripsi
Akun AWS Agar orang lain dapat menyalin snapshot terenkripsi yang dibagikan dari akun Anda, akun yang Anda bagikan snapshot Anda harus memiliki akses ke AWS KMS kunci yang mengenkripsi snapshot. Untuk mengizinkan akun lain mengakses AWS KMS kunci, perbarui kebijakan kunci untuk AWS KMS kunci dengan ARN akun yang Anda bagikan sebagai prinsipal dalam kebijakan utama AWS KMS . Kemudian izinkan tindakan `kms:CreateGrant`.
Setelah Anda memberikan akses akun ke kunci AWS KMS enkripsi Anda, untuk menyalin snapshot terenkripsi Anda, akun tersebut harus membuat pengguna AWS Identity and Access Management (IAM) jika belum memilikinya. Selain itu, akun itu juga harus melampirkan kebijakan IAM ke pengguna IAM yang memungkinkan pengguna untuk menyalin snapshot terenkripsi menggunakan kunci Anda. AWS KMS Akun harus pengguna IAM dan tidak dapat menjadi Akun AWS identitas root karena pembatasan AWS KMS keamanan.
Dalam contoh kebijakan kunci berikut, pengguna 123451234512 adalah pemilik kunci enkripsi. AWS KMS Pengguna 123456789012 adalah akun yang kuncinya sedang dibagikan dengannya. Kebijakan kunci yang diperbarui ini memberikan akses akun ke AWS KMS kunci. Ini dilakukan dengan memasukkan ARN untuk Akun AWS identitas root untuk pengguna 123456789012 sebagai prinsipal untuk kebijakan, dan dengan mengizinkan tindakan. `kms:CreateGrant`
------
#### [ JSON ]
****
```
{
"Id": "key-policy-1",
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Allow use of the key",
"Effect": "Allow",
"Principal": {"AWS": [
"arn:aws:iam::123451234512:user/KeyUser",
"arn:aws:iam::123456789012:root"
]},
"Action": [
"kms:CreateGrant",
"kms:Encrypt",
"kms:Decrypt",
"kms:ReEncrypt*",
"kms:GenerateDataKey*",
"kms:DescribeKey"
],
"Resource": "*"},
{
"Sid": "Allow attachment of persistent resources",
"Effect": "Allow",
"Principal": {"AWS": [
"arn:aws:iam::123451234512:user/KeyUser",
"arn:aws:iam::123456789012:root"
]},
"Action": [
"kms:CreateGrant",
"kms:ListGrants",
"kms:RevokeGrant"
],
"Resource": "*",
"Condition": {"Bool": {"kms:GrantIsForAWSResource": true}}
}
]
}
```
------
### Membuat kebijakan IAM untuk memungkinkan penyalinan snapshot yang dienkripsi
Ketika eksternal Akun AWS memiliki akses ke AWS KMS kunci Anda, pemilik akun tersebut dapat membuat kebijakan untuk mengizinkan pengguna IAM yang dibuat untuk akun tersebut menyalin snapshot terenkripsi yang dienkripsi dengan kunci tersebut. AWS KMS
Contoh berikut menunjukkan kebijakan yang dapat dilampirkan ke pengguna IAM untuk Akun AWS 123456789012. Kebijakan ini memungkinkan pengguna IAM untuk menyalin snapshot bersama dari akun 123451234512 yang telah dienkripsi dengan kunci di Wilayah us-west-2. AWS KMS `c989c1dd-a3f2-4a5d-8d96-e793d082ab26`
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowUseOfTheKey",
"Effect": "Allow",
"Action": [
"kms:Encrypt",
"kms:Decrypt",
"kms:ReEncrypt*",
"kms:GenerateDataKey*",
"kms:DescribeKey",
"kms:CreateGrant",
"kms:RetireGrant"
],
"Resource": ["arn:aws:kms:us-west-2:123451234512:key/c989c1dd-a3f2-4a5d-8d96-e793d082ab26"]
},
{
"Sid": "AllowAttachmentOfPersistentResources",
"Effect": "Allow",
"Action": [
"kms:CreateGrant",
"kms:ListGrants",
"kms:RevokeGrant"
],
"Resource": ["arn:aws:kms:us-west-2:123451234512:key/c989c1dd-a3f2-4a5d-8d96-e793d082ab26"],
"Condition": {
"Bool": {
"kms:GrantIsForAWSResource": true
}
}
}
]
}
```
------
Untuk detail tentang memperbarui kebijakan kunci, lihat [ Menggunakan Kebijakan Kunci di AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) dalam *Panduan Developer AWS Key Management Service *.
## Berbagi snapshot
Anda dapat membagikan snapshot kluster manual Amazon DocumentDB (atau salinan snapshot otomatis) menggunakan atau: Konsol Manajemen AWS AWS CLI
------
#### [ Using the Konsol Manajemen AWS ]
Untuk membagikan snapshot menggunakan Konsol Manajemen AWS, selesaikan langkah-langkah berikut:
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Snapshot**.
1. Pilih snapshot manual yang ingin Anda bagikan.
1. Di menu tarik-turun **Tindakan**, pilih Bagikan.
1. Pilih salah satu opsi berikut untuk **visibilitas snapshot DB**:
+ Jika sumbernya tidak terenkripsi, pilih **Publik** untuk mengizinkan semua AWS akun memulihkan klaster dari snapshot manual Anda. Atau pilih **Private** untuk mengizinkan hanya AWS akun yang Anda tentukan untuk memulihkan cluster dari snapshot manual Anda.
**Awas**
Jika Anda mengatur **visibilitas snapshot DB** ke **Publik**, semua AWS akun dapat memulihkan cluster dari snapshot manual Anda dan memiliki akses ke data Anda. Jangan membagikan snapshot cluster manual yang berisi informasi pribadi sebagai **Publik**.
+ Jika sumbernya dienkripsi, **Visibilitas snapshot DB** ditetapkan sebagai **Privat** karena snapshot terenkripsi tidak dapat dibagikan sebagai publik.
**catatan**
Snapshot yang telah dienkripsi dengan default tidak AWS KMS key dapat dibagikan.
1. **Untuk **ID AWS Akun**, masukkan pengenal AWS akun untuk akun yang ingin Anda izinkan untuk memulihkan klaster dari snapshot manual Anda, lalu pilih Tambah.** Ulangi untuk menyertakan pengenal AWS akun tambahan, hingga 20 AWS akun.
Jika Anda membuat kesalahan saat menambahkan pengenal AWS akun ke daftar akun yang diizinkan, Anda dapat menghapusnya dari daftar dengan memilih **Hapus** di sebelah kanan pengenal AWS akun yang salah.
![\[Diagram: bagikan preferensi snapshot\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/share-snapshot.png)
1. Setelah Anda menambahkan pengenal untuk semua AWS akun yang ingin Anda izinkan untuk memulihkan snapshot manual, pilih **Simpan untuk menyimpan** perubahan Anda.
------
#### [ Using the AWS CLI ]
Untuk berbagi snapshot menggunakan AWS CLI, gunakan operasi Amazon DocumentDB`modify-db-snapshot-attribute`. Gunakan `--values-to-add` parameter untuk menambahkan daftar IDs untuk Akun AWS yang berwenang untuk mengembalikan snapshot manual.
Contoh berikut memungkinkan dua Akun AWS pengidentifikasi, 123451234512 dan 123456789012, untuk mengembalikan snapshot bernama. `manual-snapshot1` Itu juga menghapus nilai atribut `all` untuk menandai snapshot sebagai privat.
Untuk Linux, macOS, atau Unix:
```
aws docdb modify-db-cluster-snapshot-attribute \
--db-cluster-snapshot-identifier sample-cluster-snapshot \
--attribute-name restore \
--values-to-add '["123451234512","123456789012"]'
```
Untuk Windows:
```
aws docdb modify-db-cluster-snapshot-attribute ^
--db-cluster-snapshot-identifier sample-cluster-snapshot ^
--attribute-name restore ^
--values-to-add '["123451234512","123456789012"]'
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBClusterSnapshotAttributesResult": {
"DBClusterSnapshotIdentifier": "sample-cluster-snapshot",
"DBClusterSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"123451234512",
"123456789012"
]
}
]
}
}
```
Untuk menghapus Akun AWS pengenal dari daftar, gunakan `--values-to-remove` parameter. Contoh berikut mencegah Akun AWS ID 123456789012 memulihkan snapshot.
Untuk Linux, macOS, atau Unix:
```
aws docdb modify-db-cluster-snapshot-attribute \
--db-cluster-snapshot-identifier sample-cluster-snapshot \
--attribute-name restore \
--values-to-remove '["123456789012"]'
```
Untuk Windows:
```
aws docdb modify-db-cluster-snapshot-attribute ^
--db-cluster-snapshot-identifier sample-cluster-snapshot ^
--attribute-name restore ^
--values-to-remove '["123456789012"]'
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBClusterSnapshotAttributesResult": {
"DBClusterSnapshotIdentifier": "sample-cluster-snapshot",
"DBClusterSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"123451234512"
]
}
]
}
}
```
------
# Memulihkan dari snapshot cluster
Amazon DocumentDB (dengan kompatibilitas MongoDB) membuat snapshot klaster dari volume penyimpanan Anda. Anda dapat membuat klaster baru dengan memulihkankannya dari snapshot klaster. Saat Anda memulihkan klaster, berikan nama snapshot klaster untuk memulihkannya dan nama untuk klaster baru yang dibuat oleh pemulihan. Anda tidak dapat memulihkan dari snapshot ke klaster yang ada karena klaster baru dibuat saat Anda memulihkan.
Ketika Anda memulihkan sebuah klaster dari snapshot klaster:
+ Tindakan ini memulihkan hanya klaster, dan bukan instans untuk klaster tersebut. Anda harus memanggil tindakan `create-db-instance` guna membuat instans untuk klaster yang dipulihkan, menentukan pengidentifikasi klaster yang dipulihkan di `--db-cluster-identifier`. Anda dapat membuat instans hanya setelah klaster *tersedia*.
+ Anda tidak dapat memulihkan snapshot terenkripsi ke klaster yang tidak terenkripsi. Namun, Anda dapat memulihkan snapshot yang tidak terenkripsi ke cluster terenkripsi dengan menentukan kuncinya. AWS KMS
+ Untuk memulihkan cluster dari snapshot terenkripsi, Anda harus memiliki akses ke kunci. AWS KMS
**catatan**
Anda tidak dapat memulihkan klaster 3.6 ke klaster 4.0 tetapi Anda dapat bermigrasi dari satu versi klaster ke versi lainnya. Untuk informasi selengkapnya, kunjungi [Migrasi ke Amazon DocumentDB](docdb-migration.md).
------
#### [ Using the Konsol Manajemen AWS ]
Prosedur berikut menunjukkan cara untuk memulihkan klaster Amazon DocumentDB dari snapshot klaster menggunakan Konsol Manajemen Amazon DocumentDB.
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Snapshot**, lalu pilih tombol di sebelah kiri snapshot yang ingin Anda gunakan untuk memulihkan klaster.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Pada menu **Tindakan**, pilih **Pemulihan**.
1. Pada halaman **Pulihkan snapshot**, selesaikan bagian **Konfigurasi**.
1. **Pengidentifikasi klaster** — Nama untuk klaster baru. Anda dapat menerima nama yang disediakan Amazon DocumentDB atau mengetikkan nama yang Anda inginkan. DBsupplied Nama Dokumen Amazon dalam format `docdb-` ditambah stempel waktu UTC; misalnya,. `docdb-yyyy-mm-dd-hh-mm-ss`
1. **Kelas instans** — Kelas instans untuk klaster baru. Anda dapat menerima kelas instans default atau memilih kelas instans dari daftar tarik-turun.
1. **Jumlah instans** — Jumlah instans yang ingin Anda buat dengan klaster ini. Anda dapat menerima default dari 3 instance (1 replika primer read/write dan 2 read-only) atau memilih jumlah instance dari daftar drop-down.
1. Untuk **konfigurasi penyimpanan Cluster**, pilih opsi penyimpanan.
**catatan**
Konfigurasi penyimpanan **Amazon DocumentDB** I/O-Optimized hanya tersedia di versi mesin Amazon DocumentDB 5.0 dan 8.0.
1. Jika Anda puas dengan konfigurasi klaster, pilih **Pulihkan klaster** dan tunggu sementara klaster Anda dipulihkan.
1. Jika Anda lebih suka untuk mengubah beberapa konfigurasi, seperti menentukan Amazon VPC atau grup keamanan non-default, pilih **Tampilkan pengaturan lanjutan** dari kiri bawah halaman, dan kemudian lanjutkan dengan langkah-langkah berikut.
1. Selesaikan bagian **Pengaturan jaringan**.
+ **Virtual Private Cloud (VPC)** — Terima VPC saat ini, atau pilih VPC dari daftar tarik-turun.
+ **Grup Subnet** — Terima grup subnet `default`, atau pilih salah satu dari daftar tarik-turun.
+ **Grup Keamanan VPC** — Terima grup keamanan `default (VPC)`, atau pilih salah satu dari daftar.
1. Lengkapi bagian **Opsi klaster**.
+ **Port basis data** — Terima port default, `27017`, atau gunakan panah atas atau bawah untuk mengatur port yang ingin Anda gunakan untuk koneksi aplikasi.
1. Lengkapi bagian **Enkripsi**.
+ **Enkripsi saat istirahat** — Jika snapshot Anda dienkripsi, opsi ini tidak tersedia untuk Anda. Jika itu tidak dienkripsi, Anda dapat memilih salah satu hal berikut:
+ Untuk mengenkripsi semua data klaster Anda, pilih **Aktifkan encryption-at-rest**. Jika Anda memilih opsi ini, Anda harus menunjuk kunci KMS.
+ Untuk tidak mengenkripsi data klaster Anda, pilih **Nonaktifkan encryption-at-rest**. Jika Anda memilih opsi ini, Anda telah selesai dengan bagian enkripsi.
+ **AWS KMS Kunci** - Pilih salah satu dari berikut ini dari daftar drop-down:
+ **(default) aws/rds** - Nomor akun dan ID AWS KMS kunci tercantum mengikuti opsi ini.
+ **Kunci yang dikelola pelanggan** — Opsi ini hanya tersedia jika Anda membuat kunci enkripsi IAM di konsol AWS Identity and Access Management (IAM). Anda dapat memilih kunci untuk mengenkripsi klaster Anda.
+ **Masukkan kunci ARN** — Di kotak **ARN**, masukkan Nama Sumber Daya Amazon (ARN) untuk kunci Anda. AWS KMS Format ARN adalah `arn:aws:kms:::key/`.
1. Lengkapi bagian **Ekspor log**.
+ **Pilih jenis log untuk dipublikasikan CloudWatch** - Pilih salah satu dari berikut ini:
+ **Diaktifkan** - Memungkinkan cluster Anda untuk mengekspor logging DDL ke Amazon CloudWatch Logs.
+ **Dinonaktifkan** - Mencegah klaster Anda mengekspor log DDL ke Amazon CloudWatch Logs. **Dinonaktifkan** adalah default.
+ **IAM role** — Dari daftar, pilih *Peran Tertaut Layanan RDS*.
1. Lengkapi bagian **Tag**.
+ **Tambahkan Tag** — Di kotak *Kunci*, masukkan nama untuk tag untuk klaster Anda. Di kotak *Nilai*, secara opsional masukkan nilai tag. Tag digunakan dengan kebijakan AWS Identity and Access Management (IAM) untuk mengelola akses ke sumber daya Amazon DocumentDB dan untuk mengontrol tindakan apa yang dapat diterapkan pada sumber daya.
1. Lengkapi bagian **Perlindungan penghapusan**.
+ **Aktifkan perlindungan penghapusan** — Melindungi klaster agar tidak terhapus secara tidak sengaja. Saat opsi ini diaktifkan, Anda tidak dapat menghapus klaster.
1. Pilih **Pulihkan klaster**.
------
#### [ Using the AWS CLI ]
Untuk mengembalikan cluster dari snapshot menggunakan AWS CLI, gunakan `restore-db-cluster-from-snapshot` operasi dengan parameter berikut. Untuk informasi selengkapnya, lihat [RestoreDBClusterFromSnapshot](API_RestoreDBClusterFromSnapshot.md).
+ **--db-cluster-identifier** — Diperlukan. Nama klaster yang dibuat oleh operasi. Sebuah klaster dengan nama ini tidak boleh ada sebelum operasi ini.
Aturan penamaan klaster:
+ Panjangnya adalah [1—63] huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
+ Harus unik untuk semua cluster di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS
+ **--snapshot-identifier** — Diperlukan. Nama snapshot yang digunakan untuk memulihkan. Snapshot dengan nama ini harus ada dan dalam status *tersedia*.
+ **--engine** — Diperlukan. Harus berupa `docdb`.
+ **--storage-type standard \$1 iopt1**- Opsional. Default: `standard`.
+ **--kms-key-id**- Opsional. ARN pengenal AWS KMS kunci yang akan digunakan saat memulihkan snapshot terenkripsi atau mengenkripsi cluster saat memulihkan dari snapshot yang tidak terenkripsi. Menyediakan ID AWS KMS kunci menghasilkan cluster yang dipulihkan dienkripsi dengan AWS KMS kunci, terlepas dari apakah snapshot dienkripsi atau tidak.
Format `--kms-key-id` adalah `arn:aws:kms:::key/`. Jika Anda tidak menentukan nilai untuk parameter `--kms-key-id`, maka hal berikut akan terjadi:
+ Jika snapshot `--snapshot-identifier` dienkripsi, maka cluster yang dipulihkan dienkripsi menggunakan AWS KMS kunci yang sama yang digunakan untuk mengenkripsi snapshot.
+ Jika snapshot di `--snapshot-identifier` tidak dienkripsi, maka klaster yang dipulihkan tidak dienkripsi.
Untuk Linux, macOS, atau Unix:
```
aws docdb restore-db-cluster-from-snapshot \
--db-cluster-identifier sample-cluster-restore \
--snapshot-identifier sample-cluster-snapshot \
--engine docdb \
--kms-key-id arn:aws:kms:us-east-1:123456789012:key/SAMPLE-KMS-KEY-ID
```
Untuk Windows:
```
aws docdb restore-db-cluster-from-snapshot ^
--db-cluster-identifier sample-cluster-restore ^
--snapshot-identifier sample-cluster-snapshot ^
--engine docdb ^
--kms-key-id arn:aws:kms:us-east-1:123456789012:key/SAMPLE-KMS-KEY-ID
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBCluster": {
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-restore",
"DBClusterParameterGroup": "default.docdb4.0",
"DBSubnetGroup": "default",
"Status": "creating",
"Endpoint": "sample-cluster-restore.cluster-node.us-east-1.docdb.amazonaws.com",
"ReaderEndpoint": "sample-cluster-restore.cluster-node.us-east-1.docdb.amazonaws.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "4.0.0",
"Port": 27017,
"MasterUsername": "",
"PreferredBackupWindow": "02:00-02:30",
"PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
"DBClusterMembers": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcdefgh",
"Status": "active"
}
],
"HostedZoneId": "ABCDEFGHIJKLM",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/",
"DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster-restore",
"AssociatedRoles": [],
"ClusterCreateTime": "2020-04-01T01:43:40.871Z",
"DeletionProtection": true
}
}
```
Setelah status klaster *tersedia*, buat setidaknya satu instans untuk klaster.
Untuk Linux, macOS, atau Unix:
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster-restore \
--db-instance-identifier sample-cluster-restore-instance \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.large \
--engine docdb
```
Untuk Windows:
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster-restore ^
--db-instance-identifier sample-cluster-restore-instance ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.large ^
--engine docdb
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-cluster-restore-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcdefgh",
"Status": "active"
}
],
"AvailabilityZone": "us-west-2b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcdefgh",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
...
}
]
},
"PreferredMaintenanceWindow": "fri:09:43-fri:10:13",
"PendingModifiedValues": {},
"EngineVersion": "4.0.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster-restore",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-cluster-restore-instance"
}
}
```
------
# Memulihkan ke titik waktu
Anda dapat memulihkan klaster ke titik waktu mana pun yang berada dalam periode retensi cadangan klaster menggunakan Konsol Manajemen AWS or AWS Command Line Interface (AWS CLI).
**catatan**
Anda tidak dapat melakukan point-in-time pemulihan klaster 3.6 ke kluster 4.0 tetapi Anda dapat bermigrasi dari satu versi cluster ke versi klaster lainnya. Untuk informasi selengkapnya, kunjungi [Migrasi ke Amazon DocumentDB](docdb-migration.md).
Ingatlah hal-hal berikut saat memulihkan klaster ke titik waktu tertentu.
+ Klaster baru dibuat dengan konfigurasi yang sama seperti klaster sumber, kecuali klaster baru dibuat dengan grup parameter default. Untuk mengatur grup parameter klaster baru ke grup parameter klaster sumber, modifikasi klaster setelah *tersedia*. Untuk informasi selengkapnya tentang memodifikasi klaster, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md).
------
#### [ Using the Konsol Manajemen AWS ]
Anda dapat memulihkan klaster ke point-in-time dalam periode retensi cadangannya dengan menyelesaikan yang berikut ini menggunakan Konsol Manajemen AWS.
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Pada panel navigasi, silakan pilih **Klaster**. Dalam daftar klaster, pilih tombol di sebelah kiri pada klaster yang ingin Anda pulihkan.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Pada menu **Tindakan**, pilih **Pulihkan ke titik waktu**.
1. Lengkapi bagian **Waktu pemulihan**, yang menentukan tanggal dan waktu untuk memulihkan ke.
1. **Tanggal pemulihan** — Pilih atau masukkan tanggal yang berada antara **Waktu pemulihan paling awal** dan **Waktu pemulihan terbaru**.
1. **Waktu pemulihan**— Pilih atau masukkan jam, menit, dan detik yang berada antara **Waktu pemulihan paling awal** dan **Waktu pemulihan terbaru**.
1. Lengkapi bagian **Konfigurasi**.
1. **Pengidentifikasi klaster** — Terima pengidentifikasi default, atau masukkan pengidentifikasi yang Anda inginkan.
Aturan penamaan klaster:
+ Panjangnya adalah [1—63] huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
+ Harus unik untuk semua cluster di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS
1. **Kelas instans** — Dari daftar tarik-turun, pilih kelas instans yang Anda inginkan untuk instans klaster.
1. **Jumlah instans** — Dari daftar tarik-turun, pilih jumlah instans yang Anda ingin buat ketika klaster dipulihkan.
1. Untuk **konfigurasi penyimpanan Cluster**, pilih opsi penyimpanan.
**catatan**
Konfigurasi penyimpanan **Amazon DocumentDB** I/O-Optimized hanya tersedia di versi mesin Amazon DocumentDB 5.0 dan 8.0.
1. Tidak wajib. Untuk mengonfigurasi pengaturan jaringan, opsi klaster, dan mengaktifkan ekspor log, pilih **Tampilkan pengaturan lanjutan**, dan kemudian lengkapi bagian berikut. Jika tidak, lanjutkan dengan langkah berikutnya.
+ **Pengaturan jaringan**
1. **Virtual Private Cloud (VPC)** — Dari daftar tarik-turun, pilih VPC yang ingin Anda gunakan untuk klaster ini.
1. **Grup Subnet** — Dari daftar tarik-turun, pilih grup subnet untuk klaster ini.
1. **Grup keamanan VPC** — Dari daftar tarik-turun, pilih grup keamanan VPC untuk klaster ini.
+ **Opsi cluster**
1. **Port** — Terima port default (27017), atau gunakan panah atas dan bawah untuk mengatur port untuk berkomunikasi dengan klaster ini.
+ **Ekspor log**
1. **Log audit** - Pilih opsi ini untuk mengaktifkan mengekspor log audit ke Amazon CloudWatch Logs. Jika Anda memilih opsi ini, Anda harus mengaktifkan `audit_logs` di grup parameter kustom klaster. Untuk informasi selengkapnya, lihat [Mengaudit acara Amazon DocumentDB](event-auditing.md).
1. **Log profiler** - Pilih opsi ini untuk mengaktifkan mengekspor log profiler operasi ke Amazon Logs. CloudWatch Jika Anda memilih opsi ini, Anda juga harus mengubah parameter berikut dalam grup parameter kustom klaster:
+ `profiler` — Atur ke `enabled`.
+ `profiler_threshold_ms` — Atur ke nilai `[0-INT_MAX]` untuk mengatur ambang batas untuk operasi pembuatan profil.
+ `profiler_sampling_rate` — Atur ke nilai `[0.0-1.0]` untuk mengatur persentase operasi lambat ke profil.
Untuk informasi selengkapnya, lihat [Membuat profil operasi Amazon DocumentDB](profiling.md).
1. Log **profiler - Ekspor log** profiler ke Amazon CloudWatch
1. **IAM role** — Dari daftar tarik-turun, pilih *Peran Tertaut Layanan RDS*.
+ **Tanda**
1. **Tambahkan Tag** — Di kotak *Kunci*, masukkan nama untuk tag untuk klaster Anda. Di kotak *Nilai*, secara opsional masukkan nilai tag. Tag digunakan dengan kebijakan AWS Identity and Access Management (IAM) untuk mengelola akses ke sumber daya Amazon DocumentDB dan untuk mengontrol tindakan apa yang dapat diterapkan ke sumber daya.
+ **Perlindungan penghapusan**
1. **Aktifkan perlindungan penghapusan** — Melindungi klaster agar tidak terhapus secara tidak sengaja. Saat opsi ini diaktifkan, Anda tidak dapat menghapus klaster.
1. Untuk memulihkan klaster, pilih **Buat klaster**. Atau, Anda dapat memilih **Batalkan** untuk membatalkan operasi.
------
#### [ Using the AWS CLI ]
Untuk memulihkan klaster ke titik waktu menggunakan periode retensi cadangan snapshot, gunakan operasi `restore-db-cluster-to-point-in-time` dengan parameter berikut.
+ **--db-cluster-identifier** — Diperlukan. Nama klaster baru yang akan dibuat. Klaster ini tidak boleh ada sebelum operasi. Nilai parameter harus memenuhi aturan berikut.
Aturan penamaan klaster:
+ Panjangnya adalah [1—63] huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
+ Harus unik untuk semua cluster di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS
+ **--restore-to-time** — Tanggal dan waktu UTC untuk memulihkan klaster. Misalnya, `2018-06-07T23:45:00Z`.
Aturan Waktu:
+ Harus sebelum waktu pemulihan terbaru untuk klaster.
+ Harus ditentukan jika parameter `--use-latest-restorable-time` tidak disediakan.
+ Tidak dapat ditentukan jika parameter `--use-latest-restorable-time` adalah `true`.
+ Tidak dapat ditentukan jika nilai parameter `--restore-type` adalah `copy-on-write`.
+ **--source-db-cluster-identifier** — Nama klaster sumber yang akan dipulihkan. Klaster ini harus ada dan tersedia.
+ **--use-latest-restorable-time** atau **--no-use-latest-restorable-time** — Apakah untuk memulihkan ke waktu backup terbaru yang dapat dipulihkan. Tidak dapat ditentukan jika parameter `--restore-to-time` disediakan.
+ **--storage-type standard \$1 iopt1**- Opsional. Default: `standard`.
AWS CLI Operasi `restore-db-cluster-to-point-in-time` hanya mengembalikan cluster, bukan instance untuk cluster itu. Anda harus memanggil operasi `create-db-instance` guna membuat instans untuk klaster yang dipulihkan, menentukan pengidentifikasi klaster yang dipulihkan di `--db-cluster-identifier`. Anda dapat membuat instans hanya setelah operasi `restore-db-cluster-to-point-in-time` telah selesai dan klaster yang dipulihkan *tersedia*.
**Example**
Contoh berikut membuat `sample-cluster-restored` dari snapshot `sample-cluster-snapshot` ke waktu pemulihan terbaru.
Untuk Linux, macOS, atau Unix:
```
aws docdb restore-db-cluster-to-point-in-time \
--db-cluster-identifier sample-cluster-restored \
--source-db-cluster-identifier sample-cluster-snapshot \
--use-latest-restorable-time
```
Untuk Windows:
```
aws docdb restore-db-cluster-to-point-in-time ^
--db-cluster-identifier sample-cluster-restored ^
--source-db-cluster-identifier sample-cluster-snapshot ^
--use-latest-restorable-time
```
**Example**
Contoh berikut membuat `sample-cluster-restored` dari snapshot `sample-cluster-snapshot` hingga 03:15 pada 11 Desember 2018 (UTC), yang berada dalam periode retensi cadangan `sample-cluster`.
Untuk Linux, macOS, atau Unix:
```
aws docdb restore-db-cluster-to-point-in-time \
--db-cluster-identifier sample-cluster-restore \
--source-db-cluster-identifier sample-cluster \
--restore-to-time 2020-05-12T03:15:00Z
```
Untuk Windows:
```
aws docdb restore-db-cluster-to-point-in-time ^
--db-cluster-identifier sample-cluster-restore ^
--source-db-cluster-identifier sample-cluster ^
--restore-to-time 2020-05-12T03:15:00Z
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBCluster": {
"AvailabilityZones": [
"us-east-1c",
"us-west-2b",
"us-west-2a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-restored",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "creating",
"Endpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
"ReaderEndpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "4.0.0",
"Port": 27017,
"MasterUsername": "master-user",
"PreferredBackupWindow": "02:00-02:30",
"PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
"DBClusterMembers": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abc0123",
"Status": "active"
}
],
"HostedZoneId": "ABCDEFGHIJKLM",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster-restored",
"AssociatedRoles": [],
"ClusterCreateTime": "2020-04-24T20:14:36.713Z",
"DeletionProtection": false
}
}
```
------
# Menghapus snapshot cluster
Snapshot manual adalah cadangan lengkap yang dihapus hanya ketika Anda menghapusnya secara manual menggunakan Konsol Manajemen AWS atau AWS CLI. Anda tidak dapat secara manual menghapus snapshot otomatis karena snapshot otomatis dihapus hanya ketika periode retensi snapshot berakhir atau Anda menghapus klaster snapshot.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk menghapus snapshot cluster manual menggunakan Konsol Manajemen AWS, selesaikan langkah-langkah berikut.
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Snapshot**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Dalam daftar snapshot, pilih tombol di sisi kiri snapshot yang ingin Anda hapus. Jenis snapshot harus **manual**.
1. Anda dapat memverifikasi bahwa jenis snapshot adalah **manual** dengan memeriksa apakah itu terdaftar sebagai `manual` atau `automatic` pada kolom **Jenis**.
1. Dari menu **Tindakan**, pilih **Hapus**. Jika opsi **Hapus** tidak tersedia, Anda mungkin memilih snapshot otomatis.
1. Pada layar konfirmasi penghapusan, untuk menghapus snapshot, pilih **Hapus**. Untuk tetap menyimpan snapshot, pilih **Batalkan**.
------
#### [ Using the AWS CLI ]
Sebuah snapshot klaster manual Amazon DocumentDB adalah backup lengkap yang dapat Anda hapus secara manual menggunakan AWS CLI. Anda tidak dapat menghapus snapshot otomatis secara manual.
Untuk menghapus snapshot cluster manual menggunakan AWS CLI, gunakan `delete-db-cluster-snapshot` operasi dengan parameter berikut.
**Parameter**
+ **--db-cluster-snapshot-identifier** — Diperlukan. Nama snapshot manual yang akan dihapus.
Contoh berikut menghapus snapshot klaster `sample-cluster-snapshot`.
Untuk Linux, macOS, atau Unix:
```
aws docdb delete-db-cluster-snapshot \
--db-cluster-snapshot-identifier sample-cluster-snapshot
```
Untuk Windows:
```
aws docdb delete-db-cluster-snapshot ^
--db-cluster-snapshot-identifier sample-cluster-snapshot
```
Output dari operasi ini mencantumkan detail snapshot klaster yang Anda hapus.
------