Updated on 2026-05-30 GMT+08:00

Binding an EIP

Function

This API is used to bind an EIP.

Constraints

None

URI

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

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

Table 2 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.

public_ip_id

Yes

String

EIP ID. The value must be in the standard UUID format.

Example Request

Binding an EIP to an instance
POST https://{endpoint}/v3/{project_id}/instances/{instance_id}/eip
{
  "public_ip": "10.83.84.176",
  "public_ip_id": "7c87996a-85f4-4029-a254-502999d4767a"
}

Response Parameters

  • Normal response
    Table 3 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.