Updated on 2022-02-22 GMT+08:00

Binding an EIP

Function

This API is used to bind an EIP to a node in a DB instance.

Constraints

  • This API can freeze instances except abnormal instances.
  • Hidden nodes do not support this operation.
  • Multiple EIPs cannot be bound to the same node.

URI

  • URI format

    POST /v3/{project_id}/nodes/{node_id}/bind-eip

  • Parameter description
    Table 1 Parameter description

    Name

    Mandatory

    Description

    project_id

    Yes

    Specifies the project ID of a tenant in a region.

    node_id

    Yes

    Specifies the ID of the node to which the EIP is to be bound.

    • Select the mongos node in a cluster instance
    • Select the primary or secondary node in a replica set instance.

Requests

  • Parameter description
    Table 2 Parameter description

    Name

    Mandatory

    Type

    Description

    public_ip_id

    Yes

    String

    Specifies the ID of the EIP.

    public_ip

    Yes

    String

    Specifies the EIP.

  • Request header
    POST https://DDS endpoint/v3/{project_id}/nodes/{node_id}//bind-eip
  • Example request
    {
        "public_ip": "10.145.51.128",
        "public_ip_id": "45da4782-e0c8-4aa4-a290-b8740014f710"
    }

Responses

  • Parameter description
    Table 3 Parameter description

    Name

    Type

    Description

    job_id

    String

    Indicates the workflow ID.

    node_name

    String

    Indicates the node name.

    node_id

    String

    Indicates the node ID.

    public_ip_id

    String

    Specifies the ID of the EIP.

    public_ip

    String

    Specifies the EIP.

  • Response example
    {
        "job_id":"3711e2ad-5787-49bc-a47f-3f0b066af9f5",
        "node_id":"52a4c096bb1f455d8d866956a959519eno02",
        "node_name":"mongodb-8977_mongos_node_1",
        "public_ip":"10.145.51.128",
        "public_ip_id":"45da4782-e0c8-4aa4-a290-b8740014f710"
    }

Status Code

For more information, see Status Code.

Error Code

For more information, see Error Code.