Hetzner Cloud icon

Hetzner Cloud

Manage servers, volumes, networks and more in Hetzner Cloud

Floating IP → Create

AI-generated

Summary

Creates a new Hetzner Cloud Floating IP by sending POST /v1/floating_ips with the chosen IP type and either a home location or a server to assign it to.

Inputs

  • Type (required) — IP version of the Floating IP: IPv4 (default) or IPv6. Sent as type.
  • Home Location — Location name such as fsn1, sent as home_location. The field description says it is required unless a server is given.
  • Server — Server to assign the new Floating IP to. Pick from a searchable list or enter the ID. It is sent as a numeric server field.
  • Additional Body Fields (JSON) — JSON object for any other API fields, such as name, description or labels. It is shared with the Update operation and defaults to {}. In this operation's routing, no preSend step merges it into the request body, so its effect is unconfirmed.
  • Request Options — Node settings for batching (items per batch, interval), ignoring SSL issues, proxy and timeout (default 10000 ms).

Output shape

One item per input item, containing the raw Hetzner API response for the create call.

The operation has no response unwrapping, so the output is not reduced to the floating_ip object. It should keep the API's top-level wrapper, which normally holds floating_ip plus an action when a server is assigned. Authentication uses the hetznerCloudApi credential.

Examples

Example 1: Reserve an IPv4 Floating IP in Falkenstein

Type = IPv4, Home Location = fsn1, leave Server empty.

Example 2: Create an IPv6 Floating IP and assign it to an existing server

Type = IPv6, Server = chosen from list or by ID. Home Location can be left empty.

Example 3: Create a named, labelled Floating IP

Type = IPv4, Home Location = nbg1, Additional Body Fields = {"name":"web-ip","labels":{"env":"prod"}}. The merge of this JSON into the request is unconfirmed, so check the output.

Links

Discussion