Basculer entre les endpoints internes et publics - - Centre de documentation Alibaba Cloud

Pour économiser les ressources d'endpoint, utilisez cette opération afin de basculer une instance entre ses endpoints internes et publics. Après la modification de l'endpoint de connexion à l'instance, mettez à jour les informations d'endpoint dans le code de votre application et redémarrez celle-ci.

Avant d'appeler cette opération, vérifiez que les conditions suivantes sont remplies :

L'instance est connectée via son endpoint interne ou public.
L'instance est dans l'état Running.
Le nombre de basculements de l'instance entre ses endpoints internes et publics au cours des dernières 24 heures est inférieur à 20.
L'instance réside dans le réseau classique.

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	SwitchDBInstanceNetType	Opération à effectuer. Définissez la valeur sur SwitchDBInstanceNetType.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxx	Jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez générer cette valeur à l'aide du client, mais vous devez vous assurer qu'elle est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et sa longueur ne doit pas dépasser 64 caractères.
DBInstanceId	String	Yes	rm-bp1**************	ID de l'instance.
ConnectionStringPrefix	String	Yes	new**********	Préfixe de l'endpoint personnalisé. Le préfixe doit comporter entre 8 et 64 caractères et peut contenir des lettres et des chiffres. Il doit commencer par une lettre minuscule. Un endpoint valide suit le format suivant : Préfixe.Moteur de base de données.rds.aliyuncs.com. Exemple : test1234.mysql.rds.aliyuncs.com.
Port	String	No	3306	Port associé à l'endpoint. Valeurs valides : 3001 à 3999.
ConnectionStringType	String	No	Normal	Type d'endpoint. Valeurs valides : Normal ReadWriteSplitting Par défaut, le système renvoie les deux types d'endpoints.

Paramètres de réponse

Parameter	Type	Example	Description
NewConnectionString	String	new.mysql.rds.aliyuncs.com	Endpoint utilisé pour se connecter à l'instance après le basculement des endpoints.
RequestId	String	65BDA532-28AF-4122-AA39-B382721EEE64	ID de la requête.
OldConnectionString	String	rm-bp1****.mysql.rds.aliyuncs.com	Endpoint utilisé pour se connecter à l'instance avant le basculement des endpoints.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=SwitchDBInstanceNetType
&DBInstanceId=rm-uf6wjk5xxxxxxx
&ConnectionStringPrefix=rm-xxxxxx
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<SwitchDBInstanceNetTypeResponse>
    <RequestId>94D5FC3C-1314-5883-9127-61D2105515AF</RequestId>
    <OldConnectionString>rm-bp1qp11x5**************.rds.aliyuncs.com</OldConnectionString>
    <NewConnectionString>new**********.rds.aliyuncs.com</NewConnectionString>
</SwitchDBInstanceNetTypeResponse>

JSON format

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

{
  "RequestId" : "94D5FC3C-1314-5883-9127-61D2105515AF",
  "OldConnectionString" : "rm-bp1qp11x5**************.rds.aliyuncs.com",
  "NewConnectionString" : "new**********.rds.aliyuncs.com"
}

Codes d'erreur

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