doc-exports/docs/ddm/api-ref/en-us_topic_0000002181623850.html

Changing the Load Balancer IP Address of an Instance (a V3 API)

Function

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

Constraints

None

URI

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

Table 1 Path parameters

Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID of a tenant in a region For how to obtain a project ID, 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. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.
Content-Type	Yes	String	MIME type of the request body. Value range: application/json application/json;charset=utf-8

Table 3 Request body parameters

Parameter	Mandatory	Type	Description
new_ip	Yes	String	New ELB load balancer IP address. It is one of the available and unassigned IP addresses in the CIDR block.
group_id	No	String	Instance group ID. If there is only one instance group, this parameter can be left empty. It can be obtained from Obtaining the Instance Group Information (a V3 API).

Example Request

Changing an ELB load balancer IP address

PUT https://ddm.eu-de.otc.t-systems.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/1f5c9fd6cd984056ba89c8c87cc03278in09/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

• Normal response example

  {
    "job_id" : "9fe84a77-6a6b-4b03-9a3e-db910a548657"
  }

• Abnormal response

  For details, see Abnormal Request Results.

Status Codes

• Normal

  202

• Abnormal

  For details, see Status Codes.

Error Codes

For details, see Error Codes.

Parent topic: DDM Instances