調用DescribeMigrateTasks介面查詢備份資料上雲工作清單。

該介面可以查詢執行個體在最近一周內的備份資料上雲任務記錄。

说明
  • 備份資料上雲的源備份檔案必須是全量備份（FULL）檔案。
  • 暫不支援SQL Server 2017叢集版執行個體。

調試

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

請求參數

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

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

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

執行個體ID。
StartTime String 是 2017-10-20T01:00Z

查詢開始時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。

EndTime String 是 2017-10-25T01:00Z

查詢結束時間，必須大於開始時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。

PageSize Integer 否 30

每頁記錄數，取值：

  • 30；
  • 50；
  • 100。

預設值：30。

PageNumber Integer 否 1

頁碼，取值：大於0且不超過Integer的最大值。

預設值：1。

AccessKeyId String 否 LTAIfCxxxxxxx

阿里雲頒發給使用者的訪問服務所用的密鑰ID。

返回資料

名稱 類型 樣本值 描述
DBInstanceId String rm-uf6wjk5xxxxxxx

執行個體ID。
Items

備份資料上雲任務資訊列表。
BackupMode String FULL

備份資料上雲任務類型，取值：

  • FULL：表示通過全量備份檔案去執行還原作業。
  • UPDF：表示通過增量檔案或者記錄檔去還原增量部分的資料。
CreateTime String 2017-05-30T12:11:04Z

備份資料上雲任務建立時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

DBName String testDB

資料庫名稱。
Description String Api description

備份資料上雲任務的描述資訊。
EndTime String 2017-05-30T13:11:04Z

備份資料上雲任務結束時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

IsDBReplaced String True

是否是覆蓋性匯入。
MigrateTaskId String 564522545

備份資料上雲任務的ID。
Status String Success

備份資料上雲任務的狀態，取值：

  • NoStart：未開始；
  • Running：運行中；
  • Success：成功；
  • Failed：失敗；
  • Waiting：等待 (等待增量備份檔案匯入)。
PageRecordCount Integer 10

每頁記錄數。
PageNumber Integer 1

擷取第幾頁的資料。
RequestId String 4E356DDF-6B83-45DB-99D5-4B1E8A0D286B

請求ID。
TotalRecordCount Integer 30

滿足條件的總的記錄數。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action=DescribeMigrateTasks
&DBInstanceId=rm-uf6wjk5xxxxxxx
&StartTime=2017-10-20T01:00Z
&EndTime=2017-10-25T01:00Z
&<公用請求參數>

正常返回樣本

XML 格式 

<DescribeMigrateTasksResponse>
	  <RequestId>A5409D02-D661-4BF3-8F3D-0A814D0574E7</RequestId>
	  <PageRecordCount>1</PageRecordCount>
	  <PageNumber>1</PageNumber>
	  <TotalRecordCount>10</TotalRecordCount>
	  <Items>
		    <MigrateTaskId>rm-bp1842vxxxxx</MigrateTaskId>
		    <DBName>test02</DBName>
		    <CreateTime>2017-05-30 T12:11:4Z</CreateTime>
		    <EndTime>2017-05-30 T12:11:4Z</EndTime>
		    <IsDBReplaced>True</IsDBReplaced>
		    <Status>Success</Status>
		    <BackupMode>FULL</BackupMode>
		    <Description>Api description</Description>
	  </Items></DescribeMigrateTasksResponse>

JSON 格式 

{
	"Items":{
		"Status":"Success",
		"MigrateTaskId":"rm-bp1842vxxxxx",
		"Description":"Api description",
		"IsDBReplaced":"True",
		"CreateTime":"2017-05-30 T12:11:4Z",
		"BackupMode":"FULL",
		"EndTime":"2017-05-30 T12:11:4Z",
		"DBName":"test02"
	},
	"TotalRecordCount":10,
	"PageNumber":1,
	"RequestId":"A5409D02-D661-4BF3-8F3D-0A814D0574E7",
	"PageRecordCount":1
}

錯誤碼

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