在為MongoDB實(shí)例執(zhí)行單庫(kù)恢復(fù)前，您可以調(diào)用本接口查詢(xún)指定的時(shí)間點(diǎn)或備份集內(nèi)包含的數(shù)據(jù)庫(kù)。
接口說(shuō)明
您可以調(diào)用 CreateDBInstance 接口進(jìn)行單庫(kù)恢復(fù)。更多信息，請(qǐng)參見(jiàn) MongoDB 單庫(kù)恢復(fù)。
調(diào)用本接口時(shí)，實(shí)例必須滿足以下條件：
- 實(shí)例的創(chuàng)建時(shí)間晚于 2019 年 3 月 26 日。
- 實(shí)例屬于華北 1、華北 2、華北 3、華北 5、華東 1、華東 2、華南 1 或亞太東南 1（新加坡）地域。
- 實(shí)例類(lèi)型為副本集實(shí)例。
- 實(shí)例版本須為 3.4、4.0、4.2 本地盤(pán)版本。
- 實(shí)例存儲(chǔ)引擎必須為 WiredTiger。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
當(dāng)前API暫無(wú)授權(quán)信息透出。
請(qǐng)求參數(shù)
| 名稱(chēng) | 類(lèi)型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| PageNumber | integer | 否 | 頁(yè)碼，取值為大于 0 且不超過(guò) Integer 數(shù)據(jù)類(lèi)型的最大值，默認(rèn)值為 1。 | 1 |
| PageSize | integer | 否 | 每頁(yè)可展示的記錄數(shù)。取值： 30（默認(rèn)值）、50、100。 | 30 |
| SourceDBInstance | string | 是 | 待恢復(fù)數(shù)據(jù)的源實(shí)例 ID。 | dds-bp2286**** |
| RestoreTime | string | 否 | 實(shí)例所需恢復(fù)的時(shí)間點(diǎn)，格式為 yyyy-MM-ddTHH:mm:ssZ（UTC 時(shí)間）。 說(shuō)明
| 2019-08-22T12:00:00Z |
| BackupId | string | 否 | 備份 ID。 說(shuō)明
| 5664**** |
| ResourceGroupId | string | 否 | 資源組 ID。 | rg-ax68**** |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"TotalCount": 5,
"Databases": {
"Database": [
{
"DBName": "mongodbtest"
}
]
},
"RequestId": "1AF0AD89-ED4F-44AD-B65F-BFC1D5CD9455",
"PageSize": 30,
"PageNumber": 1
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidMeta.WrongFormat | Meta information is wrong formatter. | - |
| 400 | InvalidRestoreTime.Format | Specified restore time is not valid. | 指定的參數(shù)RestoreTime不合法，請(qǐng)您檢查輸入的參數(shù)是否正確。 |
| 403 | InvalidDBName | The specified database name is not allowed. | 指定的數(shù)據(jù)庫(kù)名稱(chēng)無(wú)效 |
| 403 | InvalidMeta.TooLarge | Meta information is too large. | 元信息太大。 |
| 403 | SingleDBRestore.BackupSetNotSupport | This backup set do not support this operation. | 所選擇的時(shí)間點(diǎn)或備份文件尚未支持單庫(kù)恢復(fù)功能。 |
| 403 | IncorrectDBInstanceType | Current DB instance type does not support this operation. | 當(dāng)前實(shí)例類(lèi)型不支持該操作。 |
| 403 | IncorrectEngineVersion | Current engine version does not support operations. | - |
| 403 | InvalidBackupLogStatus | Current backup log enable status does not support this operation. | 當(dāng)前備份日志啟用狀態(tài)不支持此操作。 |
| 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. | 恢復(fù)時(shí)間內(nèi)不存在可用的備份。 |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|
暫無(wú)變更歷史