Tous les produits
Search
Centre de documentation

:Modifier les paramètres du proxy de base de données

Dernière mise à jour :Aug 19, 2026

Appelez l'opération ModifyDBProxyInstance pour modifier les paramètres du proxy de base de données d'une instance ApsaraDB RDS.

Avant d'appeler l'opération ModifyDBProxyInstance, assurez-vous d'avoir appelé l'opération ModifyDBProxy afin d'activer la fonctionnalité de proxy de base de données sur l'instance.

  • Le proxy dédié d'ApsaraDB RDS for MySQL offre des fonctionnalités telles que la répartition lecture/écriture et l'optimisation des connexions éphémères. Pour plus d'informations, consultez la rubrique Présentation des proxys de base de données

  • Le proxy de base de données d'ApsaraDB RDS for PostgreSQL prend en charge la répartition lecture/écriture. Pour plus d'informations, consultez la rubrique Présentation des proxys de base de données

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

Parameter Type Required Example Description
Action String Yes ModifyDBProxyInstance

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

DBInstanceId String Yes rm-t4n3a****

ID de l'instance. Appelez l'opération DescribeDBInstances pour récupérer l'ID de l'instance.

DBProxyInstanceType String Yes DedicatedProxy

Type de proxy de base de données activé pour l'instance. Définissez la valeur sur DedicatedProxy.

DBProxyInstanceNum String Yes 2

Nombre d'instances de proxy activées. Si ce paramètre est défini sur 0, la fonctionnalité de proxy de base de données est désactivée pour l'instance. Valeurs valides : 1 à 60.

Remarque La capacité du proxy de base de données à traiter les requêtes augmente avec le nombre d'instances de proxy activées. Surveillez la charge de l'instance et définissez un nombre approprié d'instances de proxy en fonction des données de surveillance.
EffectiveTime String No MaintainTime

Moment d'application des nouveaux paramètres du proxy de base de données. Valeurs valides :

  • Immediate : ApsaraDB RDS applique immédiatement les nouveaux paramètres.
  • MaintainTime : ApsaraDB RDS applique les nouveaux paramètres pendant la fenêtre de maintenance spécifiée. Pour plus d'informations, consultez la rubrique Modifier la fenêtre de maintenance.
  • SpecificTime : ApsaraDB RDS applique les nouveaux paramètres à un moment précis.

Valeur par défaut : MaintainTime.

EffectiveSpecificTime String No 2019-07-10T13:15:12Z

Moment précis d'application des nouveaux paramètres du proxy de base de données. Spécifiez l'heure au format ISO 8601 : yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.

Remarque Si vous définissez le paramètre EffectiveTime sur SpecificTime, vous devez spécifier le paramètre EffectiveSpecificTime.
RegionId String No cn-hangzhou

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

DBProxyEngineType String No normal

Paramètre interne. Ne spécifiez pas ce paramètre.

Paramètres de réponse

Parameter

Type

Example

Description

RequestId

String

65C55572-530E-4A53-BE03-1D08CAF0F046

ID de la requête.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=ModifyDBProxyInstance
&DBInstanceId=rm-t4n3a****
&DBProxyInstanceType=DedicatedProxy
&DBProxyInstanceNum=2
&EffectiveTime=Immediate
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<ModifyDBProxyInstanceResponse>
  <RequestId>65C55572-530E-4A53-BE03-1D08CAF0F046</RequestId>
</ModifyDBProxyInstanceResponse>

JSON format

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

{
  "RequestId" : "65C55572-530E-4A53-BE03-1D08CAF0F046"
}

Codes d'erreur

HTTP status code

Error code

Error message

Description

400

InvalidDBInstanceName

Specified parameter DBInstanceName is not valid.

La valeur du paramètre DBInstanceName n'est pas valide. Vérifiez si la valeur est nulle ou une chaîne vide.

403

DBInstanceStatusNotActive

Current DB instance status should be active.

Le statut de l'instance ne permet pas d'effectuer cette opération.

403

InvalidInstanceLevel.Malformed

The specified class code does not support the endpoint number. Please check the shard number and the current endpoint number.

Le type d'instance ne prend pas en charge le nombre de terminaux de proxy spécifié. Vérifiez le nombre d'instances de proxy et le nombre de terminaux de proxy.

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