Tous les produits
Search
Centre de documentation

:Basculez les charges de travail vers l'instance de destination

Dernière mise à jour :Aug 19, 2026

Appelez l'opération ActivateMigrationTargetInstance pour basculer les charges de travail vers une instance ApsaraDB RDS for PostgreSQL.

Prérequis

Avant d'appeler l'opération ActivateMigrationTargetInstance, assurez-vous d'avoir créé une tâche de migration cloud en appelant l'opération CreateCloudMigrationTask. Vérifiez également que la valeur renvoyée pour le paramètre MigrateStage par l'opération DescribeCloudMigrationResult est increment.

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

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

ActivateMigrationTargetInstance

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

DBInstanceName

String

Oui

pgm-bp102g323jd4****

ID de l'instance ApsaraDB RDS for PostgreSQL. Appelez l'opération DescribeDBInstances pour récupérer l'ID de l'instance.

SwitchTime

String

Non

2022-02-25T06:57:41Z

Paramètre réservé. Ce paramètre est ignoré.

SwitchTimeMode

String

Non

0

Moment du basculement.

Définissez la valeur sur 0 pour un basculement immédiat.

ForceSwitch

String

Non

1

Indique si le basculement doit être forcé. Définissez la valeur sur 1 pour forcer le basculement.

Paramètres de réponse

Paramètre

Type

Exemple

Description

DBInstanceName

String

pgm-bp102g323jd4****

Nom de l'instance ApsaraDB RDS for PostgreSQL.

RequestId

String

76364A52-E0AB-5CC8-9818-CF1DC482C092

ID de la requête.

TaskId

Long

440913675

ID de la tâche.

SourceIpAddress

String

172.16.XX.XX

Adresse IP privée ou publique utilisée pour se connecter à l'instance PostgreSQL autogérée.

SourcePort

Long

5432

Numéro de port utilisé pour se connecter à l'instance PostgreSQL autogérée.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=ActivateMigrationTargetInstance
&DBInstanceName=pgm-bp102g323jd4****
&SwitchTime=2022-02-25T06:57:41Z
&SwitchTimeMode=0
&ForceSwitch=1
&<Common request parameters>

Exemples de réponses réussies

Format XML

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

<ActivateMigrationTargetInstanceResponse>
    <DBInstanceName>pgm-bp102g323jd4****</DBInstanceName>
    <RequestId>76364A52-E0AB-5CC8-9818-CF1DC482C092</RequestId>
    <TaskId>440913675</TaskId>
    <SourceIpAddress>172.16.XX.XX</SourceIpAddress>
    <SourcePort>5432</SourcePort>
</ActivateMigrationTargetInstanceResponse>

Format JSON

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

{
  "DBInstanceName" : "pgm-bp102g323jd4****",
  "RequestId" : "76364A52-E0AB-5CC8-9818-CF1DC482C092",
  "TaskId" : 440913675,
  "SourceIpAddress" : "172.16.XX.XX",
  "SourcePort" : 5432
}

Codes d'erreur

Code d'état HTTP

Code d'erreur

Message d'erreur

Description

400

IncorrectDBInstanceState

The current instance state does not support this operation.

L'opération n'est pas prise en charge dans l'état actuel de l'instance.

403

IncorrectDBInstance

The current DB instance does not support this operation.

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

403

IncorrectDBInstanceType

The database instance type does not support the operation.

Le moteur de base de données de l'instance ne prend pas en charge cette opération.

404

InvalidDBInstanceName.NotFound

The database instance does not exist.

Le nom d'instance spécifié est introuvable. Vérifiez le nom et réessayez.

404

IncorrectDBInstanceLockMode

Current DB instance lock mode does not support this operation.

L'instance est verrouillée.

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