ModifyDBInstanceNetworkType操作を呼び出して、ApsaraDB RDSインスタンスのネットワークタイプをクラシックネットワークから仮想プライベートクラウド (VPC) に変更できます。
前提条件
インスタンスのネットワークタイプはクラシックネットワークです。
デバッグ
リクエストパラメーター
| 項目 | データ型 | 必須/任意 | 例: | 説明 |
| 操作 | String | 必須 | ModifyDBInstanceNetworkType | 実行する操作です。 値をModifyDBInstanceNetworkTypeに設定します。 |
| DBInstanceId | String | 必須 | rm-uf6wjk5xxxxxxx | インスタンスの ID です。 |
| RetainClassic | String | 任意 | 正しい | クラシックネットワークエンドポイントを保持するかどうかを指定します。 有効な値:
デフォルト値: False。 |
| ClassicExpiredDays | String | 任意 | 7 | クラシックネットワークエンドポイントを保持する日数。 有効な値: 1 ~ 120 デフォルト値: 7 説明 RetainClassicをTrueに設定した場合、このパラメーターも指定する必要があります。 |
| InstanceNetworkType | String | 必須 | VPC | 変更後のネットワークタイプ。 値はVPCに固定されています。 |
| ReadWriteSplittingClassicExpiredDays | Integer | いいえ | 7 | クラシックネットワークタイプの読み書き分離エンドポイントを保持する日数。 有効な値: 1 ~ 120 デフォルト値: 7 説明 このパラメーターは、クラシックネットワークタイプの読み書き分離エンドポイントが存在し、RetainClassicがTrueに設定されている場合にのみ有効になります。 |
| 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 エラーセンター」をご参照ください。