Kueri tugas migrasi data backup - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi DescribeMigrateTasks untuk mengkueri tugas yang dibuat guna memigrasikan data backup dari instans ApsaraDB RDS for SQL Server.

Operasi ini memungkinkan Anda mengkueri tugas migrasi yang dibuat untuk instans tersebut dalam rentang waktu satu minggu terakhir.

Catatan

Operasi ini hanya didukung untuk tugas migrasi yang dibuat untuk memigrasikan file cadangan penuh (full backup).
Operasi ini tidak didukung untuk instans yang menjalankan SQL Server 2017 (cluster edition).

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeMigrateTasks	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeMigrateTasks.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	ID instans.
StartTime	String	Yes	2017-10-20T01:00Z	Awal rentang waktu untuk dikueri. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mmZ. Waktu harus dalam UTC.
EndTime	String	Yes	2017-10-25T01:00Z	Akhir rentang waktu untuk dikueri. Waktu akhir harus lebih baru daripada waktu mulai. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mmZ. Waktu harus dalam UTC.
PageSize	Integer	No	30	Jumlah entri yang ditampilkan per halaman. Nilai valid: 30 hingga 100. Nilai default: 30.
PageNumber	Integer	No	1	Nomor halaman yang ditampilkan. Nilai valid: bilangan bulat positif bukan nol apa pun. Nilai default: 1.
ResourceGroupId	String	No	rg-acfmy*****	ID kelompok sumber daya.

Parameter respons

Parameter	Type	Example	Description
DBInstanceId	String	rm-uf6wjk5xxxxxxx	ID instans.
PageNumber	Integer	1	Nomor halaman yang dikembalikan.
RequestId	String	4E356DDF-6B83-45DB-99D5-4B1E8A0D286B	ID permintaan.
PageRecordCount	Integer	10	Jumlah entri yang dikembalikan per halaman.
TotalRecordCount	Integer	30	Total jumlah entri yang dikembalikan.
Items	Array of MigrateTask		Detail tugas migrasi.
MigrateTask
EndTime	String	2017-05-30T13:11:04Z	Waktu saat tugas migrasi selesai. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
Status	String	Success	Status tugas migrasi. Nilai valid: NoStart: Tugas belum dimulai. Running: Tugas sedang berjalan. Success: Tugas berhasil. Failed: Tugas gagal. Waiting: Tugas sedang menunggu file cadangan inkremental untuk diimpor.
Description	String	Api description	Deskripsi tugas migrasi.
CreateTime	String	2017-05-30T12:11:04Z	Waktu saat tugas migrasi dibuat. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
DBName	String	testDB	Nama database.
BackupMode	String	FULL	Jenis tugas migrasi. Nilai valid: FULL: Tugas migrasi memigrasikan file cadangan penuh yang dapat digunakan untuk memulihkan seluruh data instans. UPDF: Tugas migrasi memigrasikan file cadangan inkremental atau log yang dapat digunakan untuk memulihkan data inkremental instans.
MigrateTaskId	String	564522545	ID tugas migrasi.
IsDBReplaced	String	True	Menunjukkan apakah data yang diimpor menimpa data yang sudah ada.

Contoh

Contoh permintaan

http(s)://rds.aliyuncs.com/?Action=DescribeMigrateTasks
&DBInstanceId=rm-uf6wjk5xxxxxxx
&StartTime=2017-10-20T01:00Z
&EndTime=2017-10-25T01:00Z
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<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 format

HTTP/1.1 200 OK
Content-Type:application/json

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

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidStartTimeAndEndTime.Malformed	The end time must be greater than the start time	Pesan kesalahan yang dikembalikan karena waktu akhir harus lebih baru daripada waktu mulai.
403	InvalidInstanceState	The DB instance state does not support this operation.	Pesan kesalahan yang dikembalikan karena status instans tidak mendukung operasi ini.

Untuk daftar lengkap kode kesalahan, kunjungi API Error Center.