CopyDBClusterSnapshot - Amazon DocumentDB
Parameter PermintaanElemen ResponsKesalahanLihat Juga

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

CopyDBClusterSnapshot

Salinan sebuah snapshot dari sebuah klaster.

Untuk menyalin snapshot klaster dari snapshot klaster manual bersama, SourceDBClusterSnapshotIdentifier harus menjadi Amazon Resource Name (ARN) dari snapshot klaster bersama. Anda hanya dapat menyalin snapshot klaster DB bersama, baik dienkripsi atau tidak, di Wilayah AWS yang sama.

Untuk membatalkan operasi penyalinan setelah ia berlangsung, hapus snapshot klaster target yang diidentifikasi oleh TargetDBClusterSnapshotIdentifier saat snapshot klaster tersebut berada dalam status menyalin.

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

SourceDBClusterSnapshotIdentifier

Pengidentifikasi snapshot klaster yang akan disalin. Parameter ini tidak peka huruf besar kecil.

Batasan:

  • Harus menentukan snapshot sistem yang valid dalam status tersedia.

  • Jika snapshot sumber berada di Wilayah AWS yang sama seperti salinan, tentukan pengidentifikasi snapshot yang valid.

  • Jika snapshot sumber berada di Wilayah AWS yang berbeda dari salinan, tentukan ARN snapshot klaster yang valid.

Contoh: my-cluster-snapshot1

Tipe: String

Diperlukan: Ya

TargetDBClusterSnapshotIdentifier

Pengidentifikasi snapshot klaster baru yang akan dibuat dari snapshot klaster sumber. Parameter ini tidak peka huruf besar kecil.

Batas:

  • Harus berisi 1 hingga 63 huruf, angka, atau tanda hubung.

  • Karakter pertamanya harus berupa huruf.

  • Tidak dapat diakhiri dengan tanda hubung atau mengandung dua tanda hubung berturut-turut.

Contoh: my-cluster-snapshot2

Tipe: String

Diperlukan: Ya

CopyTags

Atur ke true untuk menyalin semua tag dari snapshot klaster sumber ke snapshot klaster target, dan sebaliknya false. Defaultnya adalah false.

Tipe: Boolean

Wajib: Tidak

KmsKeyId

ID kunci AWS KMS untuk snapshot klaster terenkripsi. ID kunci AWS KMS adalah Amazon Resource Name (ARN), pengidentifikasi kunci AWS KMS, atau alias kunci AWS KMS untuk kunci enkripsi AWS KMS.

Jika Anda menyalin snapshot klaster terenkripsi dari Akun AWS Anda, Anda dapat menentukan nilai untuk KmsKeyId untuk mengenkripsi salinan dengan kunci enkripsi AWS KMS yang baru. Jika Anda tidak menentukan nilai untuk KmsKeyId, salinan snapshot klaster dienkripsi dengan kunci AWS KMS yang sama dengan snapshot klaster sumber.

Jika Anda menyalin snapshot klaster terenkripsi yang dibagikan dari Akun AWS lain, Anda harus menentukan nilai untuk KmsKeyId.

Untuk menyalin snapshot klaster terenkripsi ke Wilayah AWS lain, atur KmsKeyId ke ID kunci AWS KMS yang ingin Anda gunakan untuk mengenkripsi salinan snapshot klaster di Wilayah tujuan. Kunci enkripsi AWS KMS khusus untuk Wilayah AWS tempat mereka dibuat, dan Anda tidak dapat menggunakan kunci enkripsi dari satu Wilayah AWS di Wilayah AWS lain.

Jika Anda menyalin snapshot klaster yang tidak terenkripsi dan menentukan nilai untuk parameter KmsKeyId, kesalahan akan dikembalikan.

Tipe: String

Wajib: Tidak

PreSignedUrl

URL yang memuat permintaan bertanda tangan sebuah Tanda Tangan Versi 4 untuk tindakan API CopyDBClusterSnapshot di Wilayah AWS yang berisi snapshot klaster sumber untuk disalin. Anda harus menggunakan parameter PreSignedUrl ketika menyalin snapshot klaster dari Wilayah AWS yang lain.

Jika Anda menggunakan alat SDK AWS atau AWS CLI, Anda dapat menentukan SourceRegion (atau --source-region untuk AWS CLI) alih-alih menentukan PreSignedUrl secara manual. Menentukan SourceRegion secara otomatis menghasilkan URL pre-signed yang merupakan permintaan yang valid untuk operasi yang dapat dijalankan di Wilayah AWS sumber.

URL yang ditandatangani sebelumnya harus merupakan permintaan yang valid untuk tindakan API CopyDBClusterSnapshot yang dapat dijalankan di Wilayah AWS sumber yang berisi snapshot klaster yang akan disalin. Permintaan URL yang ditandatangani sebelumnya harus berisi nilai parameter berikut:

  • SourceRegion - ID dari wilayah yang berisi snapshot yang akan disalin.

  • SourceDBClusterSnapshotIdentifier - Pengidentifikasi untuk snapshot klaster terenkripsi yang akan disalin. Pengidentifikasi ini harus dalam format Amazon Resource Name (ARN) untuk Wilayah AWS sumber. Misalnya, jika Anda menyalin snapshot klaster terenkripsi dari Wilayah AWS us-east-1, maka SourceDBClusterSnapshotIdentifier Anda akan terlihat seperti berikut: arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot.

  • TargetDBClusterSnapshotIdentifier - Pengidentifikasi untuk snapshot klaster baru yang akan dibuat. Parameter ini tidak peka huruf besar kecil.

Tipe: String

Wajib: Tidak

Tags.Tag.N

Tag yang akan ditetapkan ke snapshot klaster.

Tipe: Array objek Tag

Diperlukan: Tidak

Elemen Respons

Elemen berikut dikembalikan oleh layanan.

DBClusterSnapshot

Informasi mendetail tentang snapshot klaster.

Tipe: Objek DBClusterSnapshot

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

DBClusterSnapshotAlreadyExistsFault

Anda sudah memiliki snapshot klaster dengan pengidentifikasi yang diberikan.

Kode Status HTTP: 400

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifier tidak mengacu ke sebuah snapshot klaster yang ada.

Kode Status HTTP: 404

InvalidDBClusterSnapshotStateFault

Nilai yang diberikan bukan status snapshot klaster yang valid.

Kode Status HTTP: 400

InvalidDBClusterStateFault

Klaster tidak dalam status valid.

Kode Status HTTP: 400

KMSKeyNotAccessibleFault

Terjadi kesalahan saat mengakses kunci AWS KMS.

Kode Status HTTP: 400

SnapshotQuotaExceeded

Permintaan akan menyebabkan Anda melebihi jumlah snapshot yang diizinkan.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: