すべてのプロダクト
Search
ドキュメントセンター

:ApsaraDB RDSインスタンスのネットワークタイプの変更

最終更新日:Mar 07, 2025

ModifyDBInstanceNetworkType操作を呼び出して、ApsaraDB RDSインスタンスのネットワークタイプをクラシックネットワークから仮想プライベートクラウド (VPC) に変更できます。

前提条件

インスタンスのネットワークタイプはクラシックネットワークです。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須/任意 例: 説明 
操作 String 必須 ModifyDBInstanceNetworkType

実行する操作です。 値をModifyDBInstanceNetworkTypeに設定します。

DBInstanceId String 必須 rm-uf6wjk5xxxxxxx

インスタンスの ID です。

RetainClassic String 任意 正しい

クラシックネットワークエンドポイントを保持するかどうかを指定します。 有効な値:

  • True: クラシックネットワークエンドポイントを保持します。
  • False: クラシックネットワークエンドポイントを保持しません。

デフォルト値: False

ClassicExpiredDays String 任意 7

クラシックネットワークエンドポイントを保持する日数。 有効な値: 1 ~ 120 デフォルト値: 7

説明 RetainClassicTrueに設定した場合、このパラメーターも指定する必要があります。
InstanceNetworkType String 必須 VPC

変更後のネットワークタイプ。 値はVPCに固定されています。

ReadWriteSplittingClassicExpiredDays Integer いいえ 7

クラシックネットワークタイプの読み書き分離エンドポイントを保持する日数。 有効な値: 1 ~ 120 デフォルト値: 7

説明 このパラメーターは、クラシックネットワークタイプの読み書き分離エンドポイントが存在し、RetainClassicTrueに設定されている場合にのみ有効になります。
VPCId String 任意 vpc-uf6f7l4fg90xxxxxx

VPCのID。

VSwitchId String 任意 vsw-uf6adz52c2pxxxxx

VSwitch の ID です。 このパラメーターは、VPCIdパラメーターが指定されている場合に必要です。

PrivateIpAddress String 任意 172.10.40.25

インスタンスのイントラネット IP アドレス。 内部IPアドレスは、指定されたvSwitchでサポートされているCIDRブロック内にある必要があります。 ApsaraDB RDSは、VPCIdおよびVSwitchIdパラメーターの値に基づいて、インスタンスに内部IPアドレスを自動的に割り当てます。

ReadWriteSplittingPrivateIpAddress String 任意 192.168.0.22

インスタンスの読み書き分離エンドポイントに対応する内部IPアドレス。 内部IPアドレスは、指定されたvSwitchでサポートされているCIDRブロック内にある必要があります。 ApsaraDB RDSは、VPCIdおよびVSwitchIdパラメーターの値に基づいて、インスタンスに内部IPアドレスを自動的に割り当てます。

説明 このパラメーターは、クラシックネットワークタイプの読み書き分離エンドポイントが存在する場合に有効です。

レスポンスパラメーター

項目 データ型 例: 説明 
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

リクエストの ID です。

TaskId String 1025486523574

タスクのID。

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

インスタンスへの接続に使用されるエンドポイント。

リクエストの例

http(s):// rds.aliyuncs.com/?Action=ModifyDBInstanceNetworkType
&DBInstanceId=rm-bp1 ***************** .mysql.rds.aliyuncs.com
&InstanceNetworkType=VPC
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

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 形式

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

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

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明 
400 NetTypeExists 指定されたネットワークタイプは既に存在します。 指定されたネットワークタイプがインスタンスの元のネットワークタイプと同じである場合に返されるエラーメッセージ。
400 VswitchIpExhausted Vswitch IPが使い果たされました。 vSwitchのIPアドレスが枯渇した場合に返されるエラーメッセージ。
400 OperationDenied. スイッチ 指定されたインスタンスをVPCに切り替えないでください。 インスタンスがこの操作をサポートしていない場合に返されるエラーメッセージ。
400 OperationDenied.DBInstanceNetType 現在のデータベースインスタンスのネットワークタイプによって操作が拒否されます。 プライマリインスタンスのネットワークタイプがこの操作をサポートしていない場合に返されるエラーメッセージ。
400 OperationDenied.DBInstanceStatus 現在のデータベースインスタンスのステータスによって操作が拒否されます。 インスタンスが現在の状態の場合、操作がサポートされていない場合に返されるエラーメッセージ。
403 OperationDenied.DBInstanceConnType 現在のDBインスタンス接続タイプは、この操作をサポートしていません。 現在のネットワーク接続タイプがこの操作をサポートしていない場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。