Update a Floating IP

PUT

/floating_ips/{id}

Updates the description or labels of a Floating IP.
Also note that when updating labels, the Floating IP’s current set of labels will be replaced with the labels provided in the request body. So, for example, if you want to add a new label, you have to provide all existing labels plus the new label in the request body.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200The `floating_ip` key in the reply contains the modified Floating IP object with the new description

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.hetzner.cloud/v1/floating_ips/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "Web Frontend",
    "labels": {
        "labelkey": "value"
    },
    "name": "Web Frontend"
}'

Response Example

{
    "floating_ip": {
        "blocked": false,
        "created": "2016-01-30T23:50:00.000Z",
        "description": "Web Frontend",
        "dns_ptr": [
            {
                "dns_ptr": "server.example.com",
                "ip": "2001:db8::1"
            }
        ],
        "home_location": {
            "city": "Falkenstein",
            "country": "DE",
            "description": "Falkenstein DC Park 1",
            "id": 1,
            "latitude": 50.47612,
            "longitude": 12.370071,
            "name": "fsn1",
            "network_zone": "eu-central"
        },
        "id": 4711,
        "ip": "131.232.99.1",
        "labels": {
            "labelkey": "value"
        },
        "name": "Web Frontend",
        "protection": {
            "delete": false
        },
        "server": 42,
        "type": "ipv4"
    }
}

Modified at 2023-08-16 03:09:21

Get a Floating IP

Get all Actions for a Floating IP