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
Paramètres de requête
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | ModifyHASwitchConfig | Opération à effectuer. Définissez la valeur sur ModifyHASwitchConfig. |
| DBInstanceId | String | Yes | rm-uf6wjk5xxxxxxxxxx | ID de l'instance. |
| RegionId | String | Yes | cn-hangzhou | ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente. |
| HAConfig | String | No | Manual | Statut du basculement automatique primaire/secondaire. Valeurs possibles :
Valeur par défaut : Auto. Remarque Si vous définissez ce paramètre sur Manual, spécifiez le paramètre ManualHATime. |
| ManualHATime | String | No | 2019-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.