Tous les produits
Search
Centre de documentation

:Modifier le type de réseau d'une instance ApsaraDB RDS

Dernière mise à jour :Aug 19, 2026

Appelez l'opération ModifyDBInstanceNetworkType pour faire passer le type de réseau d'une instance ApsaraDB RDS du réseau classique au Virtual Private Cloud (VPC).

Prérequis

Le type de réseau de l'instance doit être le réseau classique.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. 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 ModifyDBInstanceNetworkType

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

DBInstanceId String Yes rm-uf6wjk5xxxxxxx

ID de l'instance.

RetainClassic String No True

Indique s'il faut conserver le point de terminaison du réseau classique. Valeurs possibles :

  • True : conserve le point de terminaison du réseau classique.
  • False : ne conserve pas le point de terminaison du réseau classique.

Valeur par défaut : False.

ClassicExpiredDays String No 7

Nombre de jours de conservation du point de terminaison du réseau classique. Valeurs possibles : 1 à 120. Valeur par défaut : 7.

Remarque Si vous définissez RetainClassic sur True, vous devez également spécifier ce paramètre.
InstanceNetworkType String Yes VPC

Type de réseau après modification. La valeur est fixée à VPC.

ReadWriteSplittingClassicExpiredDays Integer No 7

Nombre de jours de conservation du point de terminaison de répartition lecture/écriture de type réseau classique. Valeurs possibles : 1 à 120. Valeur par défaut : 7.

Remarque Ce paramètre prend effet uniquement si un point de terminaison de répartition lecture/écriture de type réseau classique existe et que RetainClassic est défini sur True.
VPCId String No vpc-uf6f7l4fg90xxxxxx

ID du VPC.

VSwitchId String No vsw-uf6adz52c2pxxxxx

ID du vSwitch. Ce paramètre est requis si le paramètre VPCId est spécifié.

PrivateIpAddress String No 172.10.40.25

Adresse IP interne de l'instance. Elle doit appartenir au bloc CIDR pris en charge par le vSwitch spécifié. ApsaraDB RDS attribue automatiquement une adresse IP interne à l'instance en fonction des valeurs des paramètres VPCId et VSwitchId.

ReadWriteSplittingPrivateIpAddress String No 192.168.0.22

Adresse IP interne correspondant au point de terminaison de répartition lecture/écriture de l'instance. Elle doit appartenir au bloc CIDR pris en charge par le vSwitch spécifié. ApsaraDB RDS attribue automatiquement une adresse IP interne à l'instance en fonction des valeurs des paramètres VPCId et VSwitchId.

Remarque Ce paramètre est valide si un point de terminaison de répartition lecture/écriture de type réseau classique existe.

Paramètres de réponse

Parameter

Type

Example

Description

RequestId

String

1AD222E9-E606-4A42-BF6D-8A4442913CEF

ID de la requête.

TaskId

String

1025486523574

ID de la tâche.

ConnectionString

String

rm-bp1***.mysql.rds.aliyuncs.com

Point de terminaison utilisé pour se connecter à l'instance.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceNetworkType
&DBInstanceId=rm-bp1*****************.mysql.rds.aliyuncs.com
&InstanceNetworkType=VPC
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<ModifyDBInstanceNetworkTypeResponse>
    <RequestId>9F0F1B7B-ED7A-5767-ADA5-46F31121E1D4</RequestId>
    <ConnectionString>rm-bp1*****************.mysql.rds.aliyuncs.com</ConnectionString>
</ModifyDBInstanceNetworkTypeResponse>

JSON format

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

{
  "RequestId" : "9F0F1B7B-ED7A-5767-ADA5-46F31121E1D4",
  "ConnectionString" : "rm-bp1*****************.mysql.rds.aliyuncs.com"
}

Codes d'erreur

HTTP status code

Error code

Error message

Description

400

NetTypeExists

Specified network type already exists.

Le type de réseau spécifié est identique au type de réseau d'origine de l'instance.

400

VswitchIpExhausted

Vswitch IP exhausted.

Les adresses IP du vSwitch sont épuisées.

400

OperationDenied.Switch

The specified instance must not be switched to VPC.

L'instance ne prend pas en charge cette opération.

400

OperationDenied.DBInstanceNetType

Operation is denied by the network type of current database instance.

Le type de réseau de l'instance principale ne prend pas en charge cette opération.

400

OperationDenied.DBInstanceStatus

Operation is denied by the current database instance status.

L'opération n'est pas prise en charge dans l'état actuel de l'instance.

403

OperationDenied.DBInstanceConnType

The current DB instance connection type does not support this operation.

Le type de connexion réseau actuel ne prend pas en charge cette opération.

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