Function

This API is used to change the floating IP address of a DB instance.

Before calling an API, you need to understand the API in Authentication.
Before calling this API, obtain the required region and endpoint.

Constraints

The floating IP address cannot be changed if the DB instance is in any of the following statuses: creating, rebooting, upgrading, changing instance class, creating users, or deleting users.

URI

URI format
PUT https://{Endpoint}/v3/{project_id}/instances/{instance_id}/ip

Parameter description

**Table 1** Parameter description
Name	Mandatory	Description
project_id	Yes	Specifies the project ID of a tenant in a region. For details about how to obtain the project ID, see Obtaining a Project ID.
instance_id	Yes	Specifies the DB instance ID.

Request

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	The content type. The default value is application/json.
X-Auth-Token	Yes	String	Specifies the user token. The user token is a response to the API used to obtain a user token.

**Table 3** Parameter description
Name	Mandatory	Type	Description
new_ip	Yes	String	Indicates the private IP address.

Example Request

Change the floating IP address of a DB instance.

PUT https://rds.eu-de.otc.t-systems.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/ip

{
     "new_ip": "192.168.0.1"
}

Response

Normal response
Name

Description

workflowId

Indicates the workflow ID.

For details about how to query this parameter, see Obtaining Information About a Task with a Specified ID.

Name	Description
workflowId	Indicates the workflow ID. For details about how to query this parameter, see Obtaining Information About a Task with a Specified ID.

Example normal response

{
    "workflowId":"83abc7bc-2c70-4534-8565-351187b37715"
}

Abnormal response
For details, see Abnormal Request Results.

Status Code

Normal
200
Abnormal
For details, see Status Codes.

Error Code

For details, see Error Codes.

Changing a Floating IP Address