Tüm Ürünler
Search
Belge Merkezi

:Geçiş görevi oluşturma

Son Güncelleme:Oct 02, 2026

Object Storage Service (OSS) paketindeki yedekleme dosyalarını bir ApsaraDB RDS for SQL Server örneğine geri yüklemek için CreateMigrateTask işlemini çağırarak bir geçiş görevi oluşturabilirsiniz.

Hata ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer içinde çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlemin örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parameter Type Required Example Description
Action String Yes CreateMigrateTask

Gerçekleştirmek istediğiniz işlem. Değeri CreateMigrateTask olarak belirtin.

DBInstanceId String Yes rm-uf6wjk5xxxxxxx

Örnek kimliği.

DBName String Yes testDB

Yedeklemek istediğiniz veritabanının adı.

BackupMode String Yes FULL

Geçiş görevinin türü. Geçerli değerler:

  • FULL: Geçiş görevi, tam yedekleme dosyalarını aktarır.
  • UPDF: Geçiş görevi, artımlı veya günlük yedekleme dosyalarını aktarır.
IsOnlineDB String Yes True

Geri yüklenen veritabanı verilerinin kullanıcı erişimine açılıp açılmayacağını belirtir. Geçerli değerler:

  • True
  • False
Not SQL Server 2008 R2 çalıştıran örnekler için değeri True olarak ayarlayın.
CheckDBMode String No AsyncExecuteDBCheck

Veritabanı için tutarlılık denetimi yöntemi. Geçerli değerler:

  • SyncExecuteDBCheck: eşzamanlı veritabanı denetimi
  • AsyncExecuteDBCheck: zaman uyumsuz veritabanı denetimi

Varsayılan değer: AsyncExecuteDBCheck (SQL Server 2008 R2 ile uyumlu).

Not Bu parametre, IsOnlineDB değeri True olarak ayarlandığında geçerlidir.
OssObjectPositions String No oss-ap-southeast-1.aliyuncs.com:rdsmssqlsingapore:autotest_2008R2_TestMigration_FULL.bak

OSS paketindeki yedekleme dosyasının konumu.

Değer, iki nokta üst üste işaretiyle (:) ayrılan aşağıdaki bölümlerden oluşur:

  • OSS uç noktası: oss-ap-southeast-1.aliyuncs.com.
  • OSS paketinin adı: rdsmssqlsingapore.
  • OSS paketindeki yedekleme dosyasının anahtarı: autotest_2008R2_TestMigration_FULL.bak.
Not
  • Bu parametre, SQL Server 2008 R2 çalıştıran örnekler için isteğe bağlıdır.
  • Bu parametre, SQL Server 2008 R2'den sonraki bir veritabanı altyapısı çalıştıran örnekler için gereklidir.
OSSUrls String No check_cdn_oss.sh www.xxxxxx.mobi

OSS paketindeki yedekleme dosyasının paylaşılan URL'si. URL kodlanmış olmalıdır.

Birden çok URL belirtiyorsanız bunları dikey çubuklarla (|) ayırın ve ardından kodlayın.

Not Bu parametre, SQL Server 2008 R2 çalıştıran örnekler için gereklidir.
MigrateTaskId String No None

Geçiş görevinin kimliği. Geçerli değerler:

  • BackupMode değeri FULL olarak ayarlanırsa bu parametrenin değeri boş olur. Tam yedekleme modu, SQL Server 2008 R2 çalıştıran örneklerle uyumludur.
  • BackupMode değeri UPDF olarak ayarlanırsa bu parametrenin değeri, gerekli tam geçiş görevinin kimliğidir.
Not
  • IsOnlineDB değeri True olarak ayarlanırsa BackupMode değeri FULL olarak ayarlanmalıdır.
  • IsOnlineDB değeri False olarak ayarlanırsa BackupMode değeri UPDF olarak ayarlanmalıdır.

Yanıt parametreleri

Parameter Type Example Description
RequestId String 866F5EB8-4650-4061-87F0-379F6F968BCE

İsteğin kimliği.

DBName String test02

Veritabanının adı.

BackupMode String FULL

Geçiş görevinin türü. Geçerli değerler:

  • FULL: Geçiş görevi, tam yedekleme dosyalarını aktarır.
  • UPDF: Geçiş görevi, artımlı veya günlük yedekleme dosyalarını aktarır.
DBInstanceId String rm-uf6wjk5xxxxx

Örnek kimliği.

MigrateTaskId String 564563256

Geçiş görevinin kimliği.

TaskId String 5451225

Görevin kimliği.

Örnekler

Örnek istekler

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>

Başarılı yanıt örnekleri

XML biçimi

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 biçimi

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"
}

Hata kodları

HTTP status code

Error code

Error message

Description

400

InvalidFile

The operation does not support this kind of file

Bu işlemin mevcut dosya türü için desteklenmediğini belirten hata mesajı döndürüldü.

400

InvalidInstanceType

The DB instance type does not support this operation.

Bu işlemin mevcut örnek türü tarafından desteklenmediğini belirten hata mesajı döndürüldü.

400

InvalidInstanceLockMode

The DB instance lock mode does not support this operation.

Bu işlemin kilitli bir örnek için desteklenmediğini belirten hata mesajı döndürüldü.

400

InvalidDBName

The instance does not have the specified DB name.

Belirtilen hedef veritabanının bulunmadığını belirten hata mesajı döndürüldü. Hedef veritabanının adını ve durumunu kontrol edin veya başka bir veritabanı belirtin.

400

InvalidDBType

The DB type does not support this operation.

Veritabanının durumunun bu işlemi desteklemediğini belirten hata mesajı döndürüldü.

400

InvalidDBState

The DB state does not support this operation.

Veritabanının durumunun bu işlemi desteklemediğini belirten hata mesajı döndürüldü.

400

ExceedUploadTime

Exceeding the daily upload times of this DB.

İndirme sayısının veritabanının günlük üst sınırını aştığını belirten hata mesajı döndürüldü.

400

InvalidOSSURL

The Specified OSS URL is not valid

Belirtilen OSS URL'sinin geçersiz olduğunu belirten hata mesajı döndürüldü.

400

ExceedDiskSize

The file size exceeding the disk size

Dosya boyutunun disk kapasitesini aştığını belirten hata mesajı döndürüldü. Dosya boyutunu kontrol edip tekrar deneyin.

400

InvalideStatus

Parent migrate task status is invalid.

Üst geçiş görevinin durumunun anormal olduğunu belirten hata mesajı döndürüldü.

400

InvalidOssObjectStorageClassType

The specified OSS bucket storage type is invalid.

Belirtilen OSS paketinin depolama sınıfının geçersiz olduğunu belirten hata mesajı döndürüldü.

403

InvalidInstanceState

The DB instance state does not support this operation.

Örneğin durumunun bu işlemi desteklemediğini belirten hata mesajı döndürüldü.

Hata kodlarının listesi için API Error Center adresini ziyaret edin.