Updated on 2025-10-24 GMT+08:00

Binding an EIP

API Description

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

Constraints

This operation cannot be performed on frozen or abnormal instances.
The shard and config nodes of a cluster instance, the read-only node of a replica set, and the hidden node 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
URI example
https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/nodes/4709a6332ce348718b5675aadb5e2bccno02/bind-eip

**Table 1** Request Parameters
Name	Type	IN	Mandatory	Description
X-Auth-Token	string	header	Yes	Definition User token obtained from IAM. For details, see Authentication. Constraints N/A Range N/A Default Value N/A
project_id	string	path	Yes	Definition Project ID of a tenant in a region. To obtain the project ID, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A
node_id	string	path	Yes	Definition The node ID. Constraints N/A Range Select the mongos node in a cluster instance. Select the primary or secondary node in a replica set instance. Default Value N/A

Request Parameters

Parameter description

**Table 2** Parameter description
Name	Type	Mandatory	Description
public_ip_id	String	Yes	Definition The ID of the EIP. Constraints N/A Range N/A Default Value N/A
public_ip	String	Yes	Definition EIP. Constraints N/A Range N/A Default Value N/A

Example Requests

Binding an EIP to a node in a DB instance

{
    "public_ip": "10.145.51.128",
    "public_ip_id": "45da4782-e0c8-4aa4-a290-b8740014f710"
}

Response Parameters

Parameter description

**Table 3** Parameter description
Name	Type	Mandatory	Description
job_id	String	Yes	Definition Task ID. Range N/A
node_name	String	Yes	Definition The node name. Range N/A
node_id	String	Yes	Definition The node ID. Range N/A
public_ip_id	String	Yes	Definition The ID of the EIP. Range N/A
public_ip	String	Yes	Definition EIP. Range N/A

Example Responses

{
    "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.

Parent topic: DB Instance Management