Activer ou désactiver la fonctionnalité de proxy de base de données -

La fonctionnalité de proxy dédié d'ApsaraDB RDS for MySQL offre des capacités telles que la répartition lecture/écriture et l'optimisation des connexions éphémères. Pour plus d'informations, consultez Qu'est-ce qu'un proxy de base de données ?
La fonctionnalité de proxy de base de données d'ApsaraDB RDS for PostgreSQL prend en charge la répartition lecture/écriture. Pour plus d'informations, consultez Qu'est-ce qu'un proxy de base de données ?

Avant d'appeler cette opération, assurez-vous que les conditions suivantes sont remplies :

Si l'instance exécute MySQL, elle doit utiliser l'une des versions MySQL et éditions RDS suivantes :

MySQL 8.0 avec une version mineure du moteur 20191204 ou ultérieure sur RDS Enterprise Edition
MySQL 8.0 avec une version mineure du moteur 20190915 ou ultérieure sur RDS High-availability Edition
MySQL 5.7 avec une version mineure du moteur 20191128 ou ultérieure sur RDS Enterprise Edition
MySQL 5.7 avec une version mineure du moteur 20190925 ou ultérieure sur RDS High-availability Edition
MySQL 5.6 avec une version mineure du moteur 20200229 ou ultérieure sur RDS High-availability Edition

Si l'instance exécute PostgreSQL, elle doit répondre aux exigences suivantes :

L'instance exécute PostgreSQL 10, PostgreSQL 11, PostgreSQL 12, PostgreSQL 13, PostgreSQL 14 ou PostgreSQL 15.
L'instance utilise des disques SSD standard ou des disques ESSD (enhanced SSD).
L'instance exécute RDS High-availability Edition.
L'instance est une instance principale.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre 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	ModifyDBProxy	L'opération que vous souhaitez effectuer. Définissez la valeur sur ModifyDBProxy.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	L'ID de l'instance. Vous pouvez appeler l'opération DescribeDBInstances pour interroger l'ID de l'instance.
ConfigDBProxyService	String	Yes	Startup	Indique s'il faut activer ou désactiver la fonctionnalité de proxy de base de données. Valeurs valides : Startup : active la fonctionnalité de proxy de base de données. Shutdown : désactive la fonctionnalité de proxy de base de données.
DBProxyInstanceNum	String	No	1	Le nombre d'instances de proxy activées. Valeurs valides : 1 à 60. Valeur par défaut : 1. Remarque La capacité du proxy de base de données à traiter les requêtes augmente avec le nombre d'instances de proxy activées. Vous pouvez surveiller la charge de l'instance et spécifier un nombre approprié d'instances de proxy en fonction des données de surveillance de la charge.
RegionId	String	No	cn-hangzhou	L'ID de région de l'instance. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.
InstanceNetworkType	String	No	VPC	Le type de réseau de l'instance. Définissez la valeur sur VPC. Remarque Ce paramètre est requis lorsque vous activez la fonctionnalité de proxy de base de données pour les instances RDS exécutant MySQL avec des disques SSD standard ou ESSD, ainsi que pour les instances RDS exécutant PostgreSQL.
VPCId	String	No	vpc-xxxxxxxxxxxx	L'ID du cloud privé virtuel (VPC) auquel l'instance appartient. Vous pouvez appeler l'opération DescribeDBInstanceAttribute pour interroger l'ID VPC de l'instance. Remarque Ce paramètre est requis lorsque vous activez la fonctionnalité de proxy de base de données pour les instances RDS exécutant MySQL avec des disques SSD standard ou ESSD, ainsi que pour les instances RDS exécutant PostgreSQL.
VSwitchId	String	No	vsw-xxxxxxxxxxxx	L'ID vSwitch de l'instance. Vous pouvez appeler l'opération DescribeDBInstanceAttribute pour interroger l'ID vSwitch de l'instance. Remarque Ce paramètre est requis lorsque vous activez la fonctionnalité de proxy de base de données pour les instances RDS exécutant MySQL avec des disques SSD standard ou ESSD, ainsi que pour les instances RDS exécutant PostgreSQL.
DBProxyEngineType	String	No	normal	Un paramètre interne. Vous n'avez pas besoin de spécifier ce paramètre.
ResourceGroupId	String	No	rg-acfmy*****	L'ID du groupe de ressources.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	FC452BB1-EED8-4278-95C7-0324B3710DF1	L'ID de la requête.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=ModifyDBProxy
&DBInstanceId=rm-uf6wjk5xxxxxxx
&ConfigDBProxyService=Startup
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<ModifyDBProxyResponse>
  <RequestId>FC452BB1-EED8-4278-95C7-0324B3710DF1</RequestId>
</ModifyDBProxyResponse>

JSON format

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

{
  "RequestId" : "FC452BB1-EED8-4278-95C7-0324B3710DF1"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	MaxscaleAlreadyExist	The Maxscale is already existed.	Le message d'erreur renvoyé indique que MaxScale existe déjà.
400	MaxscaleNotSupport	Maxscale not supported	Le message d'erreur renvoyé indique que l'instance ne prend pas en charge la fonctionnalité de proxy dédié. Vous devez vérifier la configuration du proxy dédié que vous avez spécifiée.
400	NetWork.NotFound	NetWork.NotFound	Le message d'erreur renvoyé indique que le réseau n'est pas disponible.
400	InvalidVpcParameter	Either VPC ID or vSwitch ID is incorrect. Please check again.	Le message d'erreur renvoyé indique que l'ID VPC que vous avez spécifié n'est pas valide.
400	MaxscaleInternalError	Database proxy status is CLASS_CHANGING.	Le message d'erreur renvoyé indique que les spécifications du proxy de base de données sont en cours de modification. Réessayez ultérieurement.
400	InvalidDBInstanceName	Specified parameter DBInstanceName is not valid.	Le message d'erreur renvoyé indique que la valeur du paramètre DBInstanceName n'est pas valide. Vérifiez si la valeur est nulle ou une chaîne vide.
404	Maxscale.NotFound	The relative maxscale instance is not found.	Le message d'erreur renvoyé indique que les instances MaxScale associées sont introuvables.
404	InvalidVSwitchId.NotFound	The specified VSwitch is invalid.	Le message d'erreur renvoyé indique que l'ID vSwitch que vous avez spécifié n'est pas valide.

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