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

Binding an EIP (a V3 API)

Function

This API is used to bind an EIP.

Constraints

None

URI

POST /v3/{project_id}/instances/{instance_id}/eip

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
public_ip	Yes	String	EIP to be bound. The value must be in the standard IP address format. For details, see EIP > Assigning an EIP.
public_ip_id	Yes	String	EIP ID. The value must be in the standard UUID format. To create an EIP, follow the instructions in EIP > Assigning an EIP. If an EIP has been created, follow the instructions in EIP > Querying an EIP.

Example Request

Binding an EIP to an instance

POST https://ddm.eu-de.otc.t-systems.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/1f5c9fd6cd984056ba89c8c87cc03278in09/eip
{
  "public_ip": "10.83.84.176",
  "public_ip_id": "7c87996a-85f4-4029-a254-502999d4767a"
}

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