調用CreateBackup介面為執行個體建立一個備份組。

調用該介面時，執行個體必須滿足以下條件，否則將操作失敗：

  • 執行個體狀態為運行中；
  • 沒有正在執行中的備份任務；
  • 單個執行個體一天內可建立的備份組數量不超過20個。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String 是 CreateBackup

系統規定參數，取值：CreateBackup。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

執行個體ID。
BackupMethod String 否 Physical

備份類型，取值：

  • Logical：邏輯備份；
  • Physical：物理備份；
  • Snapshot：快照備份。

預設值：Physical。

说明
  • 執行個體必須存在資料庫才能進行邏輯備份。
  • MariaDB進行快照備份時請填寫Physical。
BackupStrategy String 否 db

備份策略，取值：

  • db：單庫備份；
  • instance：執行個體備份。
说明 MySQL進行邏輯備份或SQL Server進行全量物理備份時可傳入該參數。
DBName String 否 rds_mysql

資料庫列表，多個資料庫之間用英文逗號（,）隔開。

说明 MySQL進行單庫邏輯備份或SQL Server進行單庫全量物理備份時可傳入該參數。
BackupType String 否 Auto

備份方式，取值：

  • Auto：自動選擇全量備份或增量備份；
  • FullBackup：全量備份。

預設值：Auto。

说明 僅SQL Server需要填寫此參數，其他引擎不用填寫。

返回資料

名稱 類型 樣本值 描述
BackupJobId String 5073731

備份任務ID。
RequestId String 2C125605-266F-41CA-8AC5-3A643D4F42C5

請求ID。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action=CreateBackup
DBInstanceId=rm-uf6wjk5xxxxxxx
&<公用請求參數>

正常返回樣本

XML 格式 

<CreateBackupResponse>
	  <RequestId>2C125605-266F-41CA-8AC5-3A643D4F42C5</RequestId>
	  <BackupJobId>5073731</BackupJobId></CreateBackupResponse>

JSON 格式 

{
	"RequestId":"2C125605-266F-41CA-8AC5-3A643D4F42C5",
	"BackupJobId":"5073731"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。