Tous les produits
Search
Centre de documentation

:Interroger les tâches de migration des données de sauvegarde

Dernière mise à jour :Aug 19, 2026

Appelez l'opération DescribeMigrateTasks pour interroger les tâches créées afin de migrer les données de sauvegarde d'une instance ApsaraDB RDS for SQL Server.

Cette opération permet d'interroger les tâches de migration créées pour l'instance au cours de la dernière semaine.

Remarque
  • Cette opération est prise en charge uniquement pour les tâches de migration créées afin de migrer des fichiers de sauvegarde complète.

  • Cette opération n'est pas prise en charge pour les instances exécutant SQL Server 2017 (édition cluster).

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code pour différents SDK.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

DescribeMigrateTasks

Opération à effectuer. Définissez la valeur sur DescribeMigrateTasks.

DBInstanceId

String

Oui

rm-uf6wjk5xxxxxxx

ID de l'instance.

StartTime

String

Oui

2017-10-20T01:00Z

Début de la plage de temps à interroger. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-dd T HH:mm Z. L'heure doit être exprimée en UTC.

EndTime

String

Oui

2017-10-25T01:00Z

Fin de la plage de temps à interroger. L'heure de fin doit être postérieure à l'heure de début. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-dd T HH:mm Z. L'heure doit être exprimée en UTC.

PageSize

Integer

Non

30

Nombre d'entrées à renvoyer par page. Valeurs valides : de 30 à 100. Valeur par défaut : 30.

PageNumber

Integer

Non

1

Numéro de la page à renvoyer. Valeurs valides : tout entier positif non nul.

Valeur par défaut : 1.

ResourceGroupId

String

Non

rg-acfmy*

ID du groupe de ressources.

Paramètres de réponse

Paramètre Type Exemple Description
DBInstanceId String rm-uf6wjk5xxxxxxx

ID de l'instance.

PageNumber Integer 1

Numéro de la page renvoyée.

RequestId String 4E356DDF-6B83-45DB-99D5-4B1E8A0D286B

ID de la requête.

PageRecordCount Integer 10

Nombre d'entrées renvoyées sur chaque page.

TotalRecordCount Integer 30

Nombre total d'entrées renvoyées.

Items Array of MigrateTask

Détails de la tâche de migration.

MigrateTask
EndTime String 2017-05-30T13:11:04Z

Heure de fin de la tâche de migration. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.

Status String Success

État de la tâche de migration. Valeurs valides :

  • NoStart : La tâche n'a pas démarré.
  • Running : La tâche est en cours.
  • Success : La tâche a réussi.
  • Failed : La tâche a échoué.
  • Waiting : La tâche attend l'importation d'un fichier de sauvegarde incrémentielle.
Description String Api description

Description de la tâche de migration.

CreateTime String 2017-05-30T12:11:04Z

Heure de création de la tâche de migration. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.

DBName String testDB

Nom de la base de données.

BackupMode String FULL

Type de la tâche de migration. Valeurs valides :

  • FULL : La tâche de migration migre des fichiers de sauvegarde complète qui peuvent être utilisés pour restaurer l'intégralité des données de l'instance.
  • UPDF : La tâche de migration migre des fichiers de sauvegarde incrémentielle ou de journal qui peuvent être utilisés pour restaurer les données incrémentielles de l'instance.
MigrateTaskId String 564522545

ID de la tâche de migration.

IsDBReplaced String True

Indique si les données importées écrasent les données existantes.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

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

Codes d'erreur

Code d'état HTTP

Code d'erreur

Message d'erreur

Description

400

InvalidStartTimeAndEndTime.Malformed

The end time must be greater than the start time

L'heure de fin doit être postérieure à l'heure de début.

403

InvalidInstanceState

The DB instance state does not support this operation.

L'état de l'instance ne prend pas en charge cette opération.

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