

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memulihkan snapshot
<a name="managedomains-snapshot-restore"></a>

Sebelum mengembalikan snapshot, pastikan domain tujuan tidak menggunakan [Multi-AZ dengan](managedomains-multiaz.md#managedomains-za-standby) Standby. Mengaktifkan siaga menyebabkan operasi pemulihan gagal.

**Awas**  
Jika Anda menggunakan alias indeks, Anda harus menghentikan permintaan tulis ke alias atau mengalihkan alias ke indeks lain sebelum menghapus indeksnya. Menghentikan permintaan penulisan membantu menghindari skenario berikut:  
Anda menghapus indeks, yang juga menghapus aliasnya.
Permintaan penulisan yang salah ke alias yang sekarang dihapus membuat indeks baru dengan nama yang sama dengan alias.
Anda tidak dapat lagi menggunakan alias karena konflik penamaan dengan indeks baru. Jika Anda telah mengalihkan alias ke indeks lain, tentukan `"include_aliases": false` saat Anda memulihkan dari snapshot.

Untuk mengembalikan snapshot

1. Identifikasi snapshot yang ingin Anda pulihkan. Pastikan bahwa semua pengaturan untuk indeks ini, seperti paket penganalisis khusus atau pengaturan persyaratan alokasi, kompatibel dengan domain. Untuk melihat semua repositori snapshot, jalankan perintah berikut:

   ```
   curl -XGET 'domain-endpoint/_snapshot?pretty'
   ```

   Setelah Anda mengidentifikasi repositori, jalankan perintah berikut untuk melihat semua snapshot:

   ```
   curl -XGET 'domain-endpoint/_snapshot/repository-name/_all?pretty'
   ```
**catatan**  
Sebagian besar snapshot otomatis disimpan dalam repositori `cs-automated`. Jika domain Anda mengenkripsi data saat tidak aktif, maka data tersebut akan disimpan di repositori `cs-automated-enc`. Jika Anda tidak melihat repositori snapshot manual yang Anda cari, pastikan Anda [mendaftarkannya](managedomains-snapshot-registerdirectory.md) ke domain.

1. (Opsional) Hapus atau ganti nama satu atau beberapa indeks di domain OpenSearch Layanan jika Anda memiliki konflik penamaan antara indeks di cluster dan indeks dalam snapshot. Anda tidak dapat mengembalikan snapshot indeks Anda ke OpenSearch cluster yang sudah berisi indeks dengan nama yang sama.

   Anda memiliki opsi berikut jika Anda memiliki konflik penamaan indeks:
   + Hapus indeks pada domain OpenSearch Layanan yang ada dan kemudian pulihkan snapshot.
   + Ganti nama indeks saat Anda memulihkannya dari snapshot dan indeks ulang nanti. Untuk mempelajari cara mengganti nama indeks, lihat [contoh permintaan ini](https://opensearch.org/docs/latest/api-reference/snapshots/restore-snapshot/#example-request) dalam dokumentasi. OpenSearch 
   + Kembalikan snapshot ke domain OpenSearch Layanan yang berbeda (hanya mungkin dengan snapshot manual).

   Perintah berikut menghapus semua indeks yang ada di domain:

   ```
   curl -XDELETE 'domain-endpoint/_all'
   ```

   Namun, jika Anda tidak berencana untuk memulihkan semua indeks, Anda cukup menghapus satu:

   ```
   curl -XDELETE 'domain-endpoint/index-name'
   ```

1. Untuk memulihkan snapshot, jalankan perintah berikut:

   ```
   curl -XPOST 'domain-endpoint/_snapshot/repository-name/snapshot-name/_restore'
   ```

   Karena izin khusus pada OpenSearch Dasbor dan indeks kontrol akses berbutir halus, upaya untuk memulihkan semua indeks mungkin gagal, terutama jika Anda mencoba memulihkan dari snapshot otomatis. Contoh berikut memulihkan hanya satu indeks, `my-index`, dari `2020-snapshot` di repositori snapshot `cs-automated`:

   ```
   curl -XPOST 'domain-endpoint/_snapshot/cs-automated/2020-snapshot/_restore' \
   -d '{"indices": "my-index"}' \
   -H 'Content-Type: application/json'
   ```

   Sebagai alternatif, Anda mungkin ingin memulihkan semua indeks *kecuali Dasbor dan indeks kontrol* akses berbutir halus:

   ```
   curl -XPOST 'domain-endpoint/_snapshot/cs-automated/2020-snapshot/_restore' \
   -d '{"indices": "-.kibana*,-.opendistro*"}' \
   -H 'Content-Type: application/json'
   ```
**catatan**  
Tergantung pada OpenSearch versi Anda, indeks sistem tambahan mungkin juga perlu dikecualikan, seperti `-.opensearch-observability*` dan`-.plugins-ml-config*`. Operasi pemulihan mungkin gagal jika indeks ini sudah ada di domain target. Untuk mengecualikannya, tambahkan ke daftar `indices` pengecualian. Sebagai contoh: `"indices": "-.kibana*,-.opendistro*,-.opensearch-observability*,-.plugins-ml-config*"`.

   Anda dapat memulihkan snapshot tanpa menghapus datanya dengan menggunakan parameter `rename_pattern` dan`rename_replacement`. Untuk informasi selengkapnya tentang parameter ini, lihat [bidang permintaan](https://opensearch.org/docs/latest/api-reference/snapshots/restore-snapshot/#request-fields) Restore Snapshot API dan [contoh permintaan](https://opensearch.org/docs/latest/api-reference/snapshots/restore-snapshot/#example-request) dalam OpenSearch dokumentasi.

**catatan**  
Jika tidak semua pecahan utama tersedia untuk indeks yang terlibat, snapshot mungkin memiliki file. `state` `PARTIAL` Nilai ini menunjukkan bahwa data dari setidaknya satu serpihan tidak berhasil disimpan. Anda masih dapat memulihkan dari sebagian snapshot, tetapi Anda mungkin perlu menggunakan snapshot lama untuk memulihkan indeks yang hilang.