Tous les produits
Search
Centre de documentation

:Activer ou désactiver les basculements automatiques primaire/secondaire

Dernière mise à jour :Aug 19, 2026

Appelez l'opération ModifyHASwitchConfig pour activer ou désactiver le basculement automatique primaire/secondaire d'une instance ApsaraDB RDS.

Une fois le basculement terminé, l'instance RDS primaire d'origine devient l'instance secondaire. Pour plus d'informations, consultez la rubrique Basculement des charges de travail entre les instances ApsaraDB RDS for MySQL primaires et secondaires.

Avant d'appeler cette opération, vérifiez que l'instance n'utilise pas l'édition RDS Basic.

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

ParameterTypeRequiredExampleDescription
ActionStringYesModifyHASwitchConfig

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

DBInstanceIdStringYesrm-uf6wjk5xxxxxxxxxx

ID de l'instance.

RegionIdStringYescn-hangzhou

ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.

HAConfigStringNoManual

Statut du basculement automatique primaire/secondaire. Valeurs possibles :

  • Auto : Le basculement automatique est activé. En cas de panne, le système bascule automatiquement les charges de travail de l'instance vers son instance secondaire.
  • Manual : Le basculement automatique est désactivé. En cas de panne, vous devez basculer manuellement les charges de travail de l'instance vers son instance secondaire.

Valeur par défaut : Auto.

Remarque Si vous définissez ce paramètre sur Manual, spécifiez le paramètre ManualHATime.
ManualHATimeStringNo2019-08-29T15:00:00Z

Heure à partir de laquelle le basculement automatique primaire/secondaire est activé. Vous pouvez définir ce paramètre jusqu'à sept jours plus tard (23:59:59 maximum). L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et doit être exprimée en UTC.

Remarque Ce paramètre prend effet uniquement si le paramètre HAConfig est défini sur Manual.

Paramètres de réponse

Parameter Type Example Description
RequestId String B6AE1448-D846-4831-B1C7-CFF3E99D5470

ID de la requête.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=ModifyHASwitchConfig
&RegionId=cn-hangzhou
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&HAConfig=Manual
&ManualHATime=2019-08-28T15:00:00
&<Common request parameters>

Exemple de réponse réussie

Format XML

<ModifyHASwitchConfigResponse>
   <RequestId>B6AE1448-D846-4831-B1C7-CFF3E99D5470</RequestId>
</ModifyHASwitchConfigResponse>

Format JSON

{
    "RequestId": "B6AE1448-D846-4831-B1C7-CFF3E99D5470"
}

Codes d'erreur

HTTP status code Error code Error message Description
400 HaConfig.Format The value of HaConfig must be auto or manual La valeur du paramètre HAConfig n'est pas valide. Définissez HAConfig sur Auto ou Manual.
400 HaConfigIsNull HaConfig is null. La valeur du paramètre HAConfig est Null.

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