Qin Ying, Fan 65b77b76d4 EIP API 20230106 version

Reviewed-by: Hajba, László Antal <laszlo-antal.hajba@t-systems.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>

2023-08-01 06:58:15 +00:00

5.5 KiB

Raw Blame History

Unbinding an EIP from an ECS

Scenarios

This section describes how to unbind an EIP from an ECS by calling APIs.

Prerequisites

You have created an ECS. For details, see section "Purchasing an ECS with Customized Configurations" in the Elastic Cloud Server User Guide.
If you use a token for authentication, you must obtain the token and add X-Auth-Token to the request header when making an API call.

The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequent calling.

Procedure

Query EIP details.

Send GET /v1/project_id/publicips/publicip_id. Parameter project_id indicates the project ID.
Add X-Auth-Token to the request header.

Check the response message.

The request is successful if the following response is displayed.

{ 
   "publicip": { 
     "id": "f6318bef-6508-4ea5-a48f-6152b6b1a8fb", 
     "status": "ACTIVE", 
     "type": "5_bgp", 
     "port_id": "a135e9b8-1630-40d2-a6c5-eb534a61efbe", 
     "public_ip_address": "10.xx.xx.162", 
     "private_ip_address": "192.168.1.131", 
     "port_id": "a135e9b8-1630-40d2-a6c5-eb534a61efbe",
     "tenant_id": "26ae5181a416420998eb2093aaed84d9", 
     "create_time": "2019-03-27 01:33:18", 
     "bandwidth_id": "02da78da-4fb0-4880-b512-f516cdeb8ef3",
     "bandwidth_name": "test",
     "bandwidth_share_type": "PER",
     "bandwidth_size": 1,
     "enterprise_project_id": "0",
     "profile": {},
     "ip_version": 4 
   } 
 }

For details about the error codes when the request is abnormal, see Error Codes.

Unbind the EIP from the ECS NIC.

Send PUT /v1/project_id/publicips/publicip_id. Parameter project_id indicates the project ID.
Add X-Auth-Token to the request header.

Specify the following parameters in the request body:

{     
     "publicip": {         
         "port_id": ""      
     }
 }