All Products
Search

This Product

    ApsaraDB RDS:SwitchDBInstanceVpc

    Document Center

    ApsaraDB RDS:SwitchDBInstanceVpc

    Last Updated:Jul 05, 2024

    Changes the virtual private cloud (VPC) and vSwitch for an ApsaraDB RDS instance.

    Operation description

    Supported database engines

    • MySQL
    • PostgreSQL
    • SQL Server

    References

    Note Before you call this operation, read the following documentation and make sure that you fully understand the prerequisites and impacts of this operation.

    Debugging

    OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

    Authorization information

    There is currently no authorization information disclosed in the API.

    Request parameters

    ParameterTypeRequiredDescriptionExample
    DBInstanceIdstringYes

    The instance ID. You can call the DescribeDBInstances operation to query the instance ID.

    		rm-uf6wjk5*****
    VPCIdstringYes

    The VPC ID.

    Note The VPC must reside in the same region as the instance.
    		vpc-uf6f7l4fg90*****
    VSwitchIdstringYes

    The vSwitch ID of the instance.

    Note The vSwitch must belong to the same zone as the instance.
    		vsw-uf6adz52c2p*****
    PrivateIpAddressstringNo

    The private IP address of the instance. The private IP address must be within the CIDR block of the vSwitch that is specified by the VSwitchId parameter.

    Note You can call the DescribeVSwitches operation to query the CIDR block of the vSwitch.
    		10.23.XX.XX

    Response parameters

    ParameterTypeDescriptionExample
    object

    The response parameters.

    RequestIdstring

    The ID of the request.

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

    Examples

    Sample success responses

    JSONformat

    {
  "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF"
}

    Error codes

    HTTP status codeError codeError messageDescription
    400MigrateAlreadyExistsFaultDuplicate migration is forbidden.The same data cannot be migrated twice.
    400InvalidConnVPCIdSpecified conn vpc id is not valid.The specified VPC ID is invalid.
    400InvalidInstanceKind.NotSupportThe instance kind does not support this operation.The instance type does not support this operation.
    400InvalidPrivateIpAddress.MismatchSpecified private IP address is not in the CIDR block of virtual switch.The VPC endpoint is invalid.
    400MigrateAlreadyReadWriteSplitExistsFaultThe rds instance already has a given vpc migrate task.A task of migrating data to the specified VPC already exists.

    For a list of error codes, visit the Service error codes.

    Change history

    Change timeSummary of changesOperation
    2022-06-23API Description Update. The Error code has changedView Change Details
    2022-06-23The Error code has changedView Change Details
    2021-10-28The Error code has changedView Change Details