Créer une tâche de migration - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. L'outil génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateMigrateTask	Opération à effectuer. Définissez la valeur sur CreateMigrateTask.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	ID de l'instance.
DBName	String	Yes	testDB	Nom de la base de données à sauvegarder.
BackupMode	String	Yes	FULL	Type de tâche de migration. Valeurs possibles : FULL : migration des fichiers de sauvegarde complets. UPDF : migration des fichiers de sauvegarde incrémentiels ou des journaux de transactions.
IsOnlineDB	String	Yes	True	Indique si les données de la base de données restaurée sont accessibles aux utilisateurs. Valeurs possibles : True False Remarque Définissez la valeur sur True pour les instances exécutant SQL Server 2008 R2.
CheckDBMode	String	No	AsyncExecuteDBCheck	Méthode de vérification de la cohérence de la base de données. Valeurs possibles : SyncExecuteDBCheck : vérification synchrone de la base de données AsyncExecuteDBCheck : vérification asynchrone de la base de données Valeur par défaut : AsyncExecuteDBCheck (compatible avec SQL Server 2008 R2). Remarque Ce paramètre est pris en compte uniquement si IsOnlineDB est défini sur True.
OssObjectPositions	String	No	oss-ap-southeast-1.aliyuncs.com:rdsmssqlsingapore:autotest_2008R2_TestMigration_FULL.bak	Emplacement du fichier de sauvegarde dans le compartiment OSS. La valeur comprend les éléments suivants, séparés par des deux-points (:) : Endpoint OSS : oss-ap-southeast-1.aliyuncs.com. Nom du compartiment OSS : rdsmssqlsingapore. Clé du fichier de sauvegarde dans le compartiment OSS : autotest_2008R2_TestMigration_FULL.bak. Remarque Ce paramètre est facultatif pour les instances exécutant SQL Server 2008 R2. Ce paramètre est obligatoire pour les instances exécutant un moteur de base de données plus récent que SQL Server 2008 R2.
OSSUrls	String	No	check_cdn_oss.sh www.xxxxxx.mobi	URL partagée du fichier de sauvegarde dans le compartiment OSS. L'URL doit être encodée. Si vous spécifiez plusieurs URL, séparez-les par des barres verticales (\|), puis encodez l'ensemble. Remarque Ce paramètre est obligatoire pour les instances exécutant SQL Server 2008 R2.
MigrateTaskId	String	No	None	ID de la tâche de migration. Valeurs possibles : Si BackupMode est défini sur FULL, laissez ce paramètre vide. Le mode de sauvegarde complète est compatible avec les instances exécutant SQL Server 2008 R2. Si BackupMode est défini sur UPDF, indiquez l'ID de la tâche de migration complète requise. Remarque Si IsOnlineDB est défini sur True, définissez BackupMode sur FULL. Si IsOnlineDB est défini sur False, définissez BackupMode sur UPDF.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	866F5EB8-4650-4061-87F0-379F6F968BCE	ID de la requête.
DBName	String	test02	Nom de la base de données.
BackupMode	String	FULL	Type de tâche de migration. Valeurs possibles : FULL : migration des fichiers de sauvegarde complets. UPDF : migration des fichiers de sauvegarde incrémentiels ou des journaux de transactions.
DBInstanceId	String	rm-uf6wjk5xxxxx	ID de l'instance.
MigrateTaskId	String	564563256	ID de la tâche de migration.
TaskId	String	5451225	ID de la tâche.

Exemples

Exemple de requête

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>

Exemple de réponse réussie

Format XML

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>

Format JSON

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

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidFile	The operation does not support this kind of file	Cette opération n'est pas prise en charge pour le type de fichier actuel.
400	InvalidInstanceType	The DB instance type does not support this operation.	Le type d'instance actuel ne prend pas en charge cette opération.
400	InvalidInstanceLockMode	The DB instance lock mode does not support this operation.	Cette opération n'est pas prise en charge pour une instance verrouillée.
400	InvalidDBName	The instance does not have the specified DB name.	La base de données de destination spécifiée n'existe pas. Vérifiez le nom et l'état de la base de données de destination ou spécifiez une autre base de données.
400	InvalidDBType	The DB type does not support this operation.	L'état de la base de données ne permet pas d'effectuer cette opération.
400	InvalidDBState	The DB state does not support this operation.	L'état de la base de données ne permet pas d'effectuer cette opération.
400	ExceedUploadTime	Exceeding the daily upload times of this DB.	Le nombre de téléchargements a dépassé la limite quotidienne de la base de données.
400	InvalidOSSURL	The Specified OSS URL is not valid	L'URL OSS spécifiée n'est pas valide.
400	ExceedDiskSize	The file size exceeding the disk size	La taille du fichier dépasse la capacité du disque. Vérifiez la taille du fichier et réessayez.
400	InvalideStatus	Parent migrate task status is invalid.	L'état de la tâche de migration parente est incorrect.
400	InvalidOssObjectStorageClassType	The specified OSS bucket storage type is invalid.	La classe de stockage du compartiment OSS spécifié n'est pas valide.
403	InvalidInstanceState	The DB instance state does not support this operation.	L'état de l'instance ne permet pas d'effectuer cette opération.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.