Buat tugas migrasi - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi CreateMigrateTask untuk membuat tugas migrasi guna memulihkan file backup dari bucket Object Storage Service (OSS) ke instans ApsaraDB RDS for SQL Server.

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 operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Ya	CreateMigrateTask	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateMigrateTask.
DBInstanceId	String	Ya	rm-uf6wjk5xxxxxxx	ID instans.
DBName	String	Ya	testDB	Nama database yang ingin Anda backup.
BackupMode	String	Ya	FULL	Jenis tugas migrasi. Nilai yang valid: FULL: Tugas migrasi memindahkan file cadangan penuh. UPDF: Tugas migrasi memindahkan file cadangan inkremental atau log.
IsOnlineDB	String	Ya	True	Menentukan apakah data database yang dipulihkan tersedia untuk diakses pengguna. Nilai yang valid: True False Catatan Tetapkan nilainya ke True untuk instans yang menjalankan SQL Server 2008 R2.
CheckDBMode	String	Tidak	AsyncExecuteDBCheck	Metode pemeriksaan konsistensi database. Nilai yang valid: SyncExecuteDBCheck: pemeriksaan database sinkron AsyncExecuteDBCheck: pemeriksaan database asinkron Nilai default: AsyncExecuteDBCheck (kompatibel dengan SQL Server 2008 R2). Catatan Parameter ini berlaku ketika IsOnlineDB diatur ke True.
OssObjectPositions	String	Tidak	oss-ap-southeast-1.aliyuncs.com:rdsmssqlsingapore:autotest_2008R2_TestMigration_FULL.bak	Lokasi file backup di bucket OSS. Nilainya terdiri atas bagian-bagian berikut yang dipisahkan oleh tanda titik dua (:): Titik akhir OSS: oss-ap-southeast-1.aliyuncs.com. Nama bucket OSS: rdsmssqlsingapore. Kunci file backup di bucket OSS: autotest_2008R2_TestMigration_FULL.bak. Catatan Parameter ini opsional untuk instans yang menjalankan SQL Server 2008 R2. Parameter ini wajib untuk instans yang menjalankan mesin database versi lebih baru daripada SQL Server 2008 R2.
OSSUrls	String	Tidak	check_cdn_oss.sh www.xxxxxx.mobi	URL bersama file backup di bucket OSS. URL harus di-encode. Jika Anda menentukan beberapa URL, pisahkan dengan tanda pipa vertikal (\|), lalu encode. Catatan Parameter ini wajib untuk instans yang menjalankan SQL Server 2008 R2.
MigrateTaskId	String	Tidak	None	ID tugas migrasi. Nilai yang valid: Jika BackupMode diatur ke FULL, nilai parameter ini kosong. Mode cadangan penuh kompatibel dengan instans yang menjalankan SQL Server 2008 R2. Jika BackupMode diatur ke UPDF, nilai parameter ini adalah ID tugas migrasi penuh yang diperlukan. Catatan Jika IsOnlineDB diatur ke True, BackupMode harus diatur ke FULL. Jika IsOnlineDB diatur ke False, BackupMode harus diatur ke UPDF.

Parameter respons

Parameter	Type	Contoh	Deskripsi
RequestId	String	866F5EB8-4650-4061-87F0-379F6F968BCE	ID permintaan.
DBName	String	test02	Nama database.
BackupMode	String	FULL	Jenis tugas migrasi. Nilai yang valid: FULL: Tugas migrasi memindahkan file cadangan penuh. UPDF: Tugas migrasi memindahkan file cadangan inkremental atau log.
DBInstanceId	String	rm-uf6wjk5xxxxx	ID instans.
MigrateTaskId	String	564563256	ID tugas migrasi.
TaskId	String	5451225	ID tugas.

Contoh

Contoh permintaan

http(s)://rds.aliyuncs.com/?Action=CreateMigrateTask
&DBInstanceId=rm-uf6wjk5xxxxxxx
&DBName=testDB
&BackupMode=FULL
&IsOnlineDB=True
&OssObjectPositions=oss-ap-southeast-1.aliyuncs.com:rdsmssqlsingapore:autotest_2008R2_TestMigration_FULL.bak
&<Common request parameters>

Contoh respons sukses

XML format

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

<?xml version="1.0" encoding="UTF-8" ?>
<CreateMigrateTaskResponse>
	<MigrateTaskId>135847</MigrateTaskId>
	<DBInstanceId>rm-bp178grbxxxxxxx</DBInstanceId>
	<RequestId>5F2B3757-BD56-40B3-B5F2-FCDD9FA0E2E2</RequestId>
	<BackupMode>UPDF</BackupMode>
	<TaskId>128301751</TaskId>
	<DBName>test02</DBName>
</CreateMigrateTaskResponse>

JSON format

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

{
  "MigrateTaskId" : "135847",
  "DBInstanceId" : "rm-bp178grbxxxxxxx",
  "RequestId" : "5F2B3757-BD56-40B3-B5F2-FCDD9FA0E2E2",
  "BackupMode" : "UPDF",
  "TaskId" : "128301751",
  "DBName" : "test02"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidFile	The operation does not support this kind of file	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk jenis file saat ini.
400	InvalidInstanceType	The DB instance type does not support this operation.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh tipe instans saat ini.
400	InvalidInstanceLockMode	The DB instance lock mode does not support this operation.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang terkunci.
400	InvalidDBName	The instance does not have the specified DB name.	Pesan kesalahan yang dikembalikan karena database tujuan yang ditentukan tidak ada. Periksa nama dan status database tujuan atau tentukan database lain.
400	InvalidDBType	The DB type does not support this operation.	Pesan kesalahan yang dikembalikan karena status database tidak mendukung operasi ini.
400	InvalidDBState	The DB state does not support this operation.	Pesan kesalahan yang dikembalikan karena status database tidak mendukung operasi ini.
400	ExceedUploadTime	Exceeding the daily upload times of this DB.	Pesan kesalahan yang dikembalikan karena jumlah unduhan melebihi batas harian database.
400	InvalidOSSURL	The Specified OSS URL is not valid	Pesan kesalahan yang dikembalikan karena URL OSS yang ditentukan tidak valid.
400	ExceedDiskSize	The file size exceeding the disk size	Pesan kesalahan yang dikembalikan karena ukuran file melebihi kapasitas disk. Periksa ukuran file dan coba lagi.
400	InvalideStatus	Parent migrate task status is invalid.	Pesan kesalahan yang dikembalikan karena status tugas migrasi induk tidak normal.
400	InvalidOssObjectStorageClassType	The specified OSS bucket storage type is invalid.	Pesan kesalahan yang dikembalikan karena kelas penyimpanan bucket OSS yang ditentukan tidak valid.
403	InvalidInstanceState	The DB instance state does not support this operation.	Pesan kesalahan yang dikembalikan karena status instans tidak mendukung operasi ini.

Untuk daftar kode kesalahan, kunjungi API Error Center.