virtual-private-cloud/api-ref/source/apis/eip/releasing_an_eip.rst

original_name

vpc_eip_0005.html

Releasing an EIP

Function

This API is used to release an EIP.

Note

Note the following when you use EIPs of the Dedicated Load Balancer (5_gray) type:

• In eu-de, no more new EIPs of this type can be assigned. You can assign EIPs of the BGP (5_bgp) type.
• Existing EIPs of this type can be bound to dedicated or shared load balancers.
  • Binding or unbinding EIPs of this type to or from dedicated load balancers is not allowed on the EIP console.
  • You can use APIs to bind EIPs to or unbind them from dedicated load balancers. For details, see Binding an EIP and Unbinding an EIP.
  • EIPs of this type can be bound to or unbound from shared load balancers on the EIP console or through API calls.
  • You are advised to bind or unbind BGP EIPs to or from dedicated load balancers.
• 5_gray EIPs cannot be added to the same shared bandwidth as EIPs of other types. If they are in the same shared bandwidth, the bandwidth limit settings will not take effect.

URI

DELETE /v1/{project_id}/publicips/{publicip_id}

Table 1 <vpc_eip_0005__table45251091> describes the parameters.

Table 1 Parameter description

Name	Mandatory	Description
project_id	Yes	Specifies the project ID.
publicip_id	Yes	Specifies the unique identifier of an EIP.

Request Message

• Request parameter

  None

• Example request

  DELETE https://{Endpoint}/v1/{project_id}/publicips/{publicip_id}

Response Message

• Response parameter

  None

• Example response

  None

  Or

  {
         "code":"xxx",
         "message":"xxxxx"
  }

Status Code

See Status Codes <vpc_api_0002>.

Error Code

See Error Codes <vpc_api_0003>.