Interroger les tâches de mise à niveau majeure de la version du moteur -

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 de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeUpgradeMajorVersionTasks	Opération à effectuer. Définissez la valeur sur DescribeUpgradeMajorVersionTasks.
DBInstanceId	String	Yes	pgm-bp1gm3yh0ht1****	ID de l'instance d'origine.
PageSize	Integer	No	30	Nombre d'entrées à renvoyer par page. Valeurs valides : 30 à 100. Valeur par défaut : 30.
PageNumber	Integer	No	1	Numéro de la page à renvoyer. Valeurs valides : tout entier positif non nul. Valeur par défaut : 1.
TargetMajorVersion	String	No	12,0	Version majeure du moteur de la nouvelle instance. Valeurs valides : 10,0 11,0 12,0 13,0 14,0 15,0
TaskId	Integer	No	417450000	Paramètre réservé. Ne spécifiez pas ce paramètre.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B	ID de la requête.
PageNumber	Integer	1	Numéro de la page renvoyée.
PageRecordCount	Integer	30	Nombre d'entrées renvoyées par page.
TotalRecordCount	Integer	1	Nombre total d'entrées renvoyées.
Items	Array of Tasks		Tableau contenant les informations sur la tâche renvoyée.
TargetMajorVersion	String	12,0	Version majeure du moteur de la nouvelle instance. Valeurs valides : 10,0 11,0 12,0 13,0 14,0 15,0
Result	String	Success	État de la tâche. Success : La tâche a réussi. Failed : La tâche a échoué. Running : La tâche est en phase de migration des données vers une nouvelle instance.
EndTime	String	1614237779000	Heure de fin de la tâche. La valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis l'époque, soit le 1er janvier 1970 à 00:00:00 UTC. Unité : millisecondes.
StartTime	String	1614236007000	Heure de début de la tâche. La valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis l'époque, soit le 1er janvier 1970 à 00:00:00 UTC. Unité : millisecondes.
SourceMajorVersion	String	11,0	Version majeure du moteur de l'instance d'origine.
UpgradeMode	String	switch	Indique si ApsaraDB RDS migre les données vers la nouvelle instance et bascule vos charges de travail vers celle-ci. Valeurs valides : clone : ApsaraDB RDS ne migre pas les données vers la nouvelle instance et ne bascule pas vos charges de travail vers celle-ci. switch : ApsaraDB RDS migre les données vers la nouvelle instance et bascule vos charges de travail vers celle-ci.
CollectStatMode	String	After	Moment auquel ApsaraDB RDS collecte les statistiques de la nouvelle instance RDS. Valeurs valides : After : ApsaraDB RDS collecte les statistiques de la nouvelle instance après un basculement. Before : ApsaraDB RDS collecte les statistiques de la nouvelle instance avant un basculement.
SourceInsName	String	pgm-bp1i3kkq7321****	ID de l'instance d'origine.
TaskId	Integer	342900000	ID de la tâche.
TargetInsName	String	pgm-bp1c0v6d8092****	ID de la nouvelle instance.
SwitchTime	String	1614237539000	Heure à laquelle vos charges de travail sont basculées de l'instance d'origine vers la nouvelle instance. La valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis l'époque, soit le 1er janvier 1970 à 00:00:00 UTC. Unité : millisecondes.
Detail	String	2021-10-27 15:03:05 --- do upgrade precheck on slave succcess.\n2021-10-27 15:03:11 --- begin to upgrade major version, source instance will locked in readonly mode.\n2021-10-27 15:03:21 --- upgrade master success.\n2021-10-27 15:06:10 --- exchange source and target instance dns success.\n	Détails de la tâche.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=DescribeUpgradeMajorVersionTasks
&DBInstanceId=pgm-bp1gm3yh0ht1****
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<DescribeUpgradeMajorVersionTasks>
    <TotalRecordCount>1</TotalRecordCount>
    <PageRecordCount>30</PageRecordCount>
    <RequestId>152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B</RequestId>
    <PageNumber>1</PageNumber>
    <Items>
        <SourceInsName>pgm-bp1i3kkq7321****</SourceInsName>
        <SourceMajorVersion>11.0</SourceMajorVersion>
        <TaskId>342900000</TaskId>
        <CollectStatMode/>
        <EndTime>1614237779000</EndTime>
        <TargetMajorVersion>12.0</TargetMajorVersion>
        <TargetInsName>pgm-bp1c0v6d8092****</TargetInsName>
        <StartTime>1614236007000</StartTime>
        <UpgradeMode>switch</UpgradeMode>
        <Detail>2021-10-27 15:03:05 --- do upgrade precheck on slave succcess.\n2021-10-27 15:03:11 --- begin to upgrade major version, source instance will locked in readonly mode.\n2021-10-27 15:03:21 --- upgrade master success.\n2021-10-27 15:06:10 --- exchange source and target instance dns success.\n</Detail>
        <SwitchTime>1614237539000</SwitchTime>
        <Result>Success</Result>
    </Items>
</DescribeUpgradeMajorVersionTasks>

JSON format

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

{
  "TotalRecordCount" : 1,
  "PageRecordCount" : 30,
  "RequestId" : "152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B",
  "PageNumber" : 1,
  "Items" : {
    "SourceInsName" : "pgm-bp1i3kkq7321****",
    "SourceMajorVersion" : 11.0,
    "TaskId" : 342900000,
    "CollectStatMode" : "",
    "EndTime" : 1614237779000,
    "TargetMajorVersion" : 12.0,
    "TargetInsName" : "pgm-bp1c0v6d8092****",
    "StartTime" : 1614236007000,
    "UpgradeMode" : "switch",
    "Detail" : "2021-10-27 15:03:05 --- do upgrade precheck on slave succcess.\\n2021-10-27 15:03:11 --- begin to upgrade major version, source instance will locked in readonly mode.\\n2021-10-27 15:03:21 --- upgrade master success.\\n2021-10-27 15:06:10 --- exchange source and target instance dns success.\\n",
    "SwitchTime" : 1614237539000,
    "Result" : "Success"
  }
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
404	InvalidDBInstanceName.NotFound	The database instance does not exist.	Le message d'erreur renvoyé indique que le nom de l'instance est introuvable. Vérifiez le nom de l'instance et réessayez.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.