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 Wilayah AWS sama dengan salinan, tentukan pengenal snapshot yang valid.

  • Jika snapshot sumber berbeda Wilayah AWS dari salinan, tentukan ARN snapshot cluster 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 pertama 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 AWS KMS kunci untuk snapshot cluster terenkripsi. ID AWS KMS kunci adalah Nama Sumber Daya Amazon (ARN), pengenal AWS KMS kunci, atau alias kunci untuk AWS KMS kunci enkripsi. AWS KMS

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

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

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

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

Tipe: String

Wajib: Tidak

PreSignedUrl

URL yang berisi permintaan ditandatangani Signature Version 4 untuk tindakan CopyDBClusterSnapshot API Wilayah AWS yang berisi snapshot cluster sumber untuk disalin. Anda harus menggunakan parameter PreSignedUrl ketika menyalin snapshot klaster dari Wilayah AWS yang lain.

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

URL yang telah ditetapkan sebelumnya harus berupa permintaan valid untuk tindakan CopyDBClusterSnapshot API yang dapat dijalankan di sumber Wilayah AWS yang berisi snapshot cluster 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

Wajib: 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 AWS KMS kunci.

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: