All Products
Search

This Product

    ApsaraDB for MongoDB:CheckRecoveryCondition

    Document Center

    ApsaraDB for MongoDB:CheckRecoveryCondition

    Last Updated:Jun 10, 2026

    Memeriksa apakah data instans Database Apsara for MongoDB dapat dipulihkan.

    Deskripsi operasi

    This operation is applicable to replica set instances and sharded cluster instances.

    Catatan

    After you call this operation to confirm that the data of the instance can be restored, you can call the CreateDBInstance operation to restore data to a new instance.

    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 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    SourceDBInstance

    string

    Yes

    ID instans sumber.

    dds-bp1378****
    DatabaseNames

    string

    No

    Nama database sumber. Nilainya adalah array JSON.

    Catatan

    Jika Anda tidak menentukan parameter ini, semua database dipulihkan secara default.

    ["db1","db2"]
    RestoreTime

    string

    No

    Pengatur waktu untuk memulihkan instans. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    Catatan

    • Waktu dapat berupa pengatur waktu dalam tujuh hari terakhir. Waktu harus lebih awal dari waktu saat ini, tetapi lebih baru dari waktu saat instans dibuat.

    • Anda harus menentukan salah satu dari parameter RestoreTime dan BackupId.

    2022-08-22T08:00:00Z
    BackupId

    string

    No

    ID cadangan.

    Catatan

    • Anda dapat memanggil operasi DescribeBackups untuk mengkueri ID cadangan.

    • Anda harus menentukan salah satu dari parameter RestoreTime dan BackupId.

    • Parameter ini tidak berlaku untuk instans kluster sharded.

    5664****
    ResourceGroupId

    string

    No

    ID kelompok sumber daya tempat instans berada.

    sg-bp179****
    SourceDBInstance

    string

    Yes

    The ID of the source instance.

    dds-bp1378****
    SrcRegion

    string

    No

    Wilayah tempat instans sumber berada.

    Catatan

    • Parameter ini diperlukan ketika Anda mengatur parameter RestoreType ke 2.

    • Parameter ini diperlukan ketika Anda mengatur parameter RestoreType ke 3.

    cn-beijing
    DestRegion

    string

    No

    Wilayah set cadangan yang digunakan untuk pencadangan dan pemulihan lintas wilayah.

    Catatan

    Parameter ini diperlukan ketika Anda mengatur parameter RestoreType ke 3.

    cn-hangzhou
    RestoreType

    string

    No

    Tipe untuk memulihkan.

    Catatan

    • 0: Data instans sumber dipulihkan ke instans baru di wilayah yang sama.

    • 1: Data instans sumber dipulihkan ke pengatur waktu sebelumnya.

    • 2: Data instans yang dihapus dipulihkan ke instans baru dari set cadangan.

    • 3: Data instans yang dihapus dipulihkan ke instans baru di wilayah lain dari set cadangan.

    0
    InstanceType

    string

    No

    Arsitektur instans. Nilai valid:

    • replicate

    • sharding

    Catatan

    • Parameter ini diperlukan ketika Anda mengatur parameter RestoreType ke 2.

    • Parameter ini diperlukan ketika Anda mengatur parameter RestoreType ke 3.

    replicate
    EngineVersion

    string

    No

    Versi mesin database instans.

    • 6.0

    • 5.0

    • 4.4

    • 4.2

    • 4.0

    • 3.4.

    4.2

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The information that is returned.

    RequestId

    string

    The request ID.

    D563A3E7-6010-45FE-A0CD-9283414C9657
    DBInstanceName

    string

    The instance ID

    dds-bp1378****
    IsValid

    boolean

    Indicates whether the data of the instance can be restored. Valid values:

    • true: The data of the instance can be restored.

    • false: The data of the instance cannot be restored.

    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.