Interroger une tâche de migration - - Centre de documentation Alibaba Cloud

Appelez l'opération DescribeMigrateTaskById pour interroger une tâche spécifique utilisée pour migrer les données de sauvegarde d'une instance ApsaraDB RDS for SQL Server vers un compartiment Object Storage Service (OSS).

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 des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeMigrateTaskById	Opération à effectuer. Définissez la valeur sur DescribeMigrateTaskById.
DBInstanceId	String	Oui	rm-bp11e1tzgxxxx4ox	ID de l'instance.
MigrateTaskId	String	Oui	235943	ID de la tâche de migration. Appelez l'opération DescribeMigrateTasks pour récupérer l'ID de la tâche de migration.
ResourceGroupId	String	Non	rg-acfmy*	ID du groupe de ressources.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Status	String	Success	Statut de la tâche de migration. Valeurs possibles : 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.
EndTime	String	2021-05-30T15:15:05Z	Heure de fin de la tâche de migration. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et est affichée en UTC.
DBInstanceName	String	rm-uf6wjk5xxxxxxxxxx	ID de l'instance.
RequestId	String	6ED3635A-01F9-47BD-B9C8-CB3FD70A336E	ID de la requête.
Description	String	Success to DBCC checkdb asynchronously	Description de la tâche de migration.
CreateTime	String	2020-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 et est affichée en UTC.
DBName	String	mytestdb	Nom de la base de données.
BackupMode	String	FULL	Type de la tâche de migration. Valeurs possibles : FULL : La tâche migre des fichiers de sauvegarde complets permettant de restaurer l'intégralité des données de l'instance. UPDF : La tâche migre des fichiers de sauvegarde incrémentiels ou des journaux permettant de restaurer les données incrémentielles de l'instance.
MigrateTaskId	String	235943	ID de la tâche de migration.
IsDBReplaced	String	False	Indique si les données importées écrasent les données existantes. Valeurs possibles : False : Les données importées n'écrasent pas les données existantes. True : Les données importées écrasent les données existantes.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=DescribeMigrateTaskById
&DBInstanceId=rm-bp11e1tzgxxxx4ox
&MigrateTaskId=235943
&<Common request parameters>

Exemple de réponse en cas de succès

XML format

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

<DescribeMigrateTaskByIdResponse>
  <Status>Success</Status>
  <Description>Success to DBCC checkdb asynchronously</Description>
  <RequestId>B994DF29-44A1-43FD-A693-917930DFEBCE</RequestId>
  <EndTime>2021-03-04T13:50:23Z</EndTime>
  <MigrateTaskId>235943</MigrateTaskId>
  <CreateTime>2021-03-04T13:47:17Z</CreateTime>
  <BackupMode>FULL</BackupMode>
  <DBName>mytestdb</DBName>
  <DBInstanceName>rm-bp11e1tzgxxxxx4ox</DBInstanceName>
</DescribeMigrateTaskByIdResponse>

JSON format

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

{
  "Status" : "Success",
  "Description" : "Success",
  "RequestId" : "6ED3635A-01F9-47BD-B9C8-CB3FD70A336E",
  "EndTime" : "2021-03-04T13:50:23Z",
  "MigrateTaskId" : "235943",
  "CreateTime" : "2021-03-04T13:47:17Z",
  "BackupMode" : "FULL",
  "DBName" : "mytestdb",
  "DBInstanceName" : "rm-bp11e1tzgxxxxx4ox"
}

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 début doit être antérieure à l'heure de fin. Par exemple, l'heure de début est 2011-05-30 T12:11:20Z et l'heure de fin est 2011-06-08 T12:09:20Z.
400	InvalidMigrateTask	The specified MigrateTaskId 237360 does not exist. Please check again.	L'ID de tâche 237360 spécifié est introuvable.
403	InvalidInstanceState	The DB instance state does not support this operation.	Le statut de l'instance ne prend pas en charge cette opération.

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