Mettre à niveau la version du proxy de base de données - - Centre de documentation Alibaba Cloud

Avant d'appeler l'opération UpgradeDBProxyInstanceKernelVersion, assurez-vous d'avoir appelé l'opération ModifyDBProxy afin d'activer la fonctionnalité de proxy de base de données pour 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. OpenAPI Explorer 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	UpgradeDBProxyInstanceKernelVersion	Opération à effectuer. Définissez la valeur sur UpgradeDBProxyInstanceKernelVersion.
DBInstanceId	String	Yes	rm-uf6wjk5****	ID de l'instance. Appelez l'opération DescribeDBInstances pour obtenir l'ID de l'instance.
UpgradeTime	String	No	MaintainTime	Moment auquel vous souhaitez mettre à niveau la version du proxy de base de données de l'instance. Valeurs valides : MaintainTime : ApsaraDB RDS effectue la mise à niveau pendant la fenêtre de maintenance spécifiée. Il s'agit de la valeur par défaut. Pour plus d'informations, consultez la rubrique Modifier la fenêtre de maintenance. Immediate : ApsaraDB RDS effectue immédiatement la mise à niveau. SpecificTime : ApsaraDB RDS effectue la mise à niveau à un moment précis. Remarque Si l'instance exécute MySQL, vous pouvez définir ce paramètre sur MaintainTime, Immediate ou SpecificTime. Si l'instance exécute PostgreSQL, vous pouvez définir ce paramètre sur MaintainTime ou Immediate.
SwitchTime	String	No	2019-07-10T13:15:12Z	Moment précis auquel vous souhaitez mettre à niveau la version du proxy de base de données de l'instance. Spécifiez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en temps universel coordonné (UTC). Remarque Si vous définissez le paramètre UpgradeTime sur SpecificTime, vous devez spécifier le paramètre SwitchTime.
DBProxyEngineType	String	No	normal	Paramètre interne. Ne spécifiez pas ce paramètre.

Paramètres de réponse

Parameter	Type	Example	Description
DBInstanceName	String	bu9***	ID du proxy de base de données de l'instance.
RequestId	String	44537EC8-DFA2-4745-B579-E733FF2C5B9A	ID de la requête.
TaskId	String	334362871	ID de la tâche.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=UpgradeDBProxyInstanceKernelVersion
&DBInstanceId=rm-uf6wjk5****
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<UpgradeDBProxyInstanceKernelVersionResponse>
    <DBInstanceName>bu9***</DBInstanceName>
    <RequestId>44537EC8-DFA2-4745-B579-E733FF2C5B9A</RequestId>
    <TaskId>334362871</TaskId>
</UpgradeDBProxyInstanceKernelVersionResponse>

Format JSON

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

{
  "DBInstanceName" : "bu9***",
  "RequestId" : "44537EC8-DFA2-4745-B579-E733FF2C5B9A",
  "TaskId" : 334362871
}

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.

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