CheckRecoveryCondition - ApsaraDB for MongoDB

Memeriksa apakah data instans ApsaraDB for MongoDB dapat dipulihkan.

Deskripsi operasi

Operasi ini berlaku untuk instans set replika dan instans kluster sharded.

Catatan

Setelah memanggil operasi ini untuk mengonfirmasi bahwa data instans dapat dipulihkan, Anda dapat memanggil operasi CreateDBInstance guna memulihkan data ke instans baru.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

dds:CheckRecoveryCondition

get

*Instance

acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
SourceDBInstance	string	Yes	ID instans sumber.	dds-bp1378****
DatabaseNames	string	No	Nama database sumber. Nilainya berupa array JSON. Catatan Jika Anda tidak menentukan parameter ini, semua database akan dipulihkan secara default.	["db1","db2"]
RestoreTime	string	No	Titik waktu pemulihan instans. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Catatan Waktu tersebut harus berada dalam rentang tujuh hari terakhir. Waktu harus lebih awal dari waktu saat ini, tetapi lebih akhir daripada waktu pembuatan instans. Anda harus menentukan salah satu parameter RestoreTime atau BackupId.	2022-08-22T08:00:00Z
BackupId	string	No	ID backup. Catatan Anda dapat memanggil operasi DescribeBackups untuk menanyakan ID backup. Anda harus menentukan salah satu parameter RestoreTime atau BackupId. Parameter ini tidak berlaku untuk instansi kluster sharded.	5664****
ResourceGroupId	string	No	ID kelompok sumber daya tempat instans tersebut berada.	sg-bp179****
SourceDBInstance	string	Yes	ID instans sumber.	dds-bp1378****
SrcRegion	string	No	Wilayah tempat instans sumber berada. Catatan Parameter ini wajib ditentukan ketika Anda mengatur parameter RestoreType ke 2. Parameter ini wajib ditentukan ketika Anda mengatur parameter RestoreType ke 3.	cn-beijing
DestRegion	string	No	Wilayah set cadangan yang digunakan untuk cadangan lintas wilayah dan pemulihan. Catatan Parameter ini wajib ditentukan ketika Anda mengatur parameter RestoreType ke 3.	cn-hangzhou
RestoreType	string	No	Tipe pemulihan. Catatan 0: Data instans sumber dipulihkan ke instans baru di wilayah yang sama. 1: Data instans sumber dipulihkan ke titik waktu sebelumnya. 2: Data instans yang telah dihapus dipulihkan ke instans baru dari set cadangan. 3: Data instans yang telah dihapus dipulihkan ke instans baru di wilayah lain dari set cadangan.	0
InstanceType	string	No	Arsitektur instans. Nilai yang valid: replicate sharding Catatan Parameter ini wajib ditentukan ketika Anda mengatur parameter RestoreType ke 2. Parameter ini wajib ditentukan ketika Anda mengatur parameter RestoreType ke 3.	replicate
EngineVersion	string	No	Versi engine database instans. 6.0 5.0 4.4 4.2 4.0 3.4	4.2

Elemen respons

Element	Type	Description	Example
	object	Informasi yang dikembalikan.
RequestId	string	ID permintaan.	D563A3E7-6010-45FE-A0CD-9283414C9657
DBInstanceName	string	ID instans	dds-bp1378****
IsValid	boolean	Menunjukkan apakah data instans dapat dipulihkan. Nilai yang valid: true: Data instans dapat dipulihkan. false: Data instans tidak dapat dipulihkan.	true

Contoh

Respons sukses

JSONformat

{
  "RequestId": "D563A3E7-6010-45FE-A0CD-9283414C9657",
  "DBInstanceName": "dds-bp1378****",
  "IsValid": true
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidMeta.WrongFormat	Meta information is wrong formatter.
400	InvalidRestoreTime.Format	Specified restore time is not valid.	The specified RestoreTime value is invalid.
403	InvalidDBName	The specified database name is not allowed.	The specified database name is invalid.
403	InvalidMeta.TooLarge	Meta information is too large.	The metadata is too large.
403	SingleDBRestore.BackupSetNotSupport	This backup set do not support this operation.	Single-database recovery is not supported for the specified time point or backup file.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.
403	IncorrectEngineVersion	Current engine version does not support operations.
403	InvalidBackupLogStatus	Current backup log enable status does not support this operation.	The operation is not supported when log backup is enabled.
403	IncorrectBackupSetState	Current backup set state does not support operations..
404	InvalidBackupSetID.NotFound	Specifiedbackup set ID does not exist.
404	InvalidBackup.NotFound	Theavailable backup does not exist in recovery time.	No backup set is available during the specified recovery period.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.