• Elastic IP

eip
  1. Help Center
  2. Elastic IP
  3. API Reference
  4. APIs
  5. Floating IP Address (IPv6)
  6. Updating a Floating IP Address

Updating a Floating IP Address

Function

This interface is used to update a specific floating IP address and the port associated with the IP address.

Restrictions

When you bind a floating IP address, if the floating IP address is in the error state, try unbinding the address first.

You are not allowed to bind a floating IP address that has been bound to a port to another port. You must first unbind the IP address from its original port and bind it to the required port.

URI

PUT /v2.0/eip/floatingips_v6/{floatingip_id}

Request Message

  • Request parameter
    Table 1 Request parameter

    Parameter

    Type

    Mandatory

    Description

    floatingip

    Dict

    Yes

    Specifies the floating IP address list. For details, see Table 1. Mandatory fields: floatingip and port_id

  • Example request 1
    PUT /v2.0/eip/floatingips_v6/b639c937-4737-4107-8978-fecc7327a5ae
    {
        "floatingip": {
            "port_id": "21b5c483-84e9-40a1-86b3-3041606106f5",
            "fixed_ip_address": "10.0.2.2"
        }
    }
  • Example request 2
    PUT /v2.0/eip/floatingips_v6/3870858f-91dc-489f-92a1-c04dbdc6d781
    {
        "floatingip": {
            "port_id": null
        }
    }

Response Message

  • Response parameter
    Table 2 Response parameter

    Parameter

    Type

    Description

    floatingip

    Dict

    Specifies the floating IP address list. For details, see Table 1.

  • Example response 1
    {
        "floatingip": {
            "router_id": "76c052d6-6a92-444c-b67d-147ee166a480",
            "status": "ACTIVE",
            "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f",
            "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
            "fixed_ip_address": "10.0.2.2",
            "floating_ip_address": "cdcd:910a:2222:5498:8475:1111:c013:8096",
            "port_id": "21b5c483-84e9-40a1-86b3-3041606106f5",
            "id": "b639c937-4737-4107-8978-fecc7327a5ae"
        }
    }
  • Example response 2
    {
        "floatingip": {
            "floating_network_id": "809fdbbc-2e3e-426e-897c-cb632b081a72",
            "router_id": null,
            "fixed_ip_address": null,
            "floating_ip_address": "cdcd:910a:2222:5498:8475:1111:c013:8096",
            "tenant_id": "3c8c36e1520147ccbc83d2ccfbb9ab24",
            "status": "ACTIVE",
            "port_id": null,
            "id": "3870858f-91dc-489f-92a1-c04dbdc6d781"
        }
    }

Status Codes

For details, see section Status Codes.

Error Codes

For details, see section Error Codes.