# Removing an EIP from a Shared Bandwidth

#### Function

This API is used to remove an EIP from a shared bandwidth.

#### URI

POST /v2.0/{project_id}/bandwidths/{bandwidth_id}/remove

Table 1 describes the parameters.

Table 1 Parameter description
Name | Mandatory | Description
--- | --- | ---
project_id | Yes | Specifies the project ID.
bandwidth_id | Yes | Specifies the bandwidth ID, which uniquely identifies the bandwidth.

#### Request Message

- Request parameter

  Table 2 Request parameter
  Name | Mandatory | Type | Description
  --- | --- | --- | ---
  bandwidth | Yes | bandwidth object | Specifies the bandwidth objects. For details, see Table 3.

  Table 3 Description of the bandwidth field
  Name | Mandatory | Type | Description
  --- | --- | --- | ---

  publicip_info

  Yes

  Array of publicip_info objects

  - Specifies information about the EIP to be removed from the bandwidth. For details, see Table 4.
  - The bandwidth, whose type is WHOLE, can be used by multiple EIPs. The number of EIPs varies depending on the tenant quota. By default, a shared bandwidth can be used by up to 20 EIPs.

  charge_mode | Yes | String | After an EIP is removed from a shared bandwidth, a dedicated bandwidth will be allocated to the EIP, and you will be billed for the dedicated bandwidth. Specifies whether the dedicated bandwidth used by the EIP that has been removed from a shared bandwidth is billed by traffic or by bandwidth. The value can be bandwidth or traffic.

  size

  Yes

  Integer

  After an EIP is removed from a shared bandwidth, a dedicated bandwidth will be allocated to the EIP, and you will be billed for the dedicated bandwidth.

  Specifies the size (Mbit/s) of the dedicated bandwidth used by the EIP that has been removed from a shared bandwidth.

  The value ranges from 1 Mbit/s to 1000 Mbit/s by default. (The specific range may vary depending on the configuration in each region. You can see the bandwidth range of each region on the management console.)

  Table 4 publicip_info object
  Name | Mandatory | Type | Description
  --- | --- | --- | ---
  publicip_id | Yes | String | Specifies the ID of the EIP that uses the bandwidth.

- Example request

      POST https://{Endpoint}/v2.0/{project_id}/bandwidths/{bandwidth_id}/remove

      {
          "bandwidth": {
              "publicip_info": [
                  {
                      "publicip_id": "d91b0028-6f6b-4478-808a-297b75b6812a"

                  },
                  {
                      "publicip_id": "1d184b2c-4ec9-49b5-a3f9-27600a76ba3f"
                  }
              ],
              "charge_mode": "traffic",
              "size": 22
          }
      }

#### Response Message

- Response parameter

  None

- Example response

  None

  Or

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

#### Status Code

See Status Codes.

#### Error Code

See Error Codes.

Parent topic: Bandwidth (V2.0)