NAME
WWW::Hetzner::Cloud::FloatingIP - Hetzner Cloud Floating IP object
VERSION
version 0.002
SYNOPSIS
my $fip = $cloud->floating_ips->get($id);
# Read attributes
print $fip->ip, "\n";
print $fip->type, "\n"; # ipv4 or ipv6
# Assign to server
$fip->assign($server_id);
$fip->unassign;
# Change reverse DNS
$fip->change_dns_ptr($fip->ip, 'server.example.com');
# Update
$fip->name('new-name');
$fip->update;
# Delete
$fip->delete;DESCRIPTION
This class represents a Hetzner Cloud floating IP. Objects are returned by WWW::Hetzner::Cloud::API::FloatingIPs methods.
id
Floating IP ID (read-only).
name
Floating IP name (read-write).
description
Floating IP description (read-write).
ip
The IP address (read-only).
type
IP type: ipv4 or ipv6 (read-only).
server
Assigned server ID, or undef if not assigned (read-only).
dns_ptr
Arrayref of reverse DNS entries (read-only).
home_location
Home location data hash (read-only).
blocked
Whether the IP is blocked (read-only).
labels
Labels hash (read-write).
protection
Protection settings hash (read-only).
created
Creation timestamp (read-only).
is_assigned
Returns true if assigned to a server.
location
Returns home location name.
update
$fip->name('new-name');
$fip->update;Saves changes to name, description, and labels.
delete
$fip->delete;Deletes the floating IP.
assign
$fip->assign($server_id);Assign to a server.
unassign
$fip->unassign;Unassign from current server.
change_dns_ptr
$fip->change_dns_ptr($fip->ip, 'server.example.com');Change reverse DNS pointer.
refresh
$fip->refresh;Reloads floating IP data from the API.
data
my $hashref = $fip->data;Returns all floating IP data as a hashref (for JSON serialization).
SUPPORT
Issues
Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-www-hetzner/issues.
IRC
Join #kubernetes on irc.perl.org or message Getty directly.
CONTRIBUTING
Contributions are welcome! Please fork the repository and submit a pull request.
AUTHOR
Torsten Raudssus <torsten@raudssus.de>
COPYRIGHT AND LICENSE
This software is copyright (c) 2026 by Torsten Raudssus.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.