Help Center/ Distributed Database Middleware/ API Reference/ APIs (Recommended)/ DDM Instances/ Changing the ELB Load Balancer IP Address of an Instance
Updated on 2026-05-30 GMT+08:00

Changing the ELB Load Balancer IP Address of an Instance

Function

This API is used to change the ELB load balancer IP address of an instance.

Constraints

None

URI

PUT /v3/{project_id}/instances/{instance_id}/elb/ip

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID of a tenant in a region

To obtain this value, see Obtaining a Project ID.

instance_id

Yes

String

DDM instance ID

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token

You can obtain the token by calling the IAM API used to obtain a user token.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

new_ip

Yes

String

New ELB load balancer IP address.

group_id

No

String

Instance group ID. If there is only one instance group, this parameter can be left empty.

Example Request

Changing an ELB load balancer IP address
PUT https://{endpoint}/v3/{project_id}/instances/{instance_id}/elb/ip
{
  "new_ip": "172.16.192.208",
  "group_id": "ee8f0a088ec3408880ef1971a96431ecgr09"
}

Response Parameters

  • Normal response
    Table 4 Response body parameters

    Parameter

    Type

    Description

    job_id

    String

    Job ID

Example Response

  • Normal response example
    {
      "job_id" : "9fe84a77-6a6b-4b03-9a3e-db910a548657"
    }

Status Codes

Error Codes

For details, see Error Codes.