/ 
WWW-Hetzner-0.101
/ WWW::Hetzner::Robot::API::Failover

NAME

WWW::Hetzner::Robot::API::Failover - Hetzner Robot Failover IP API

VERSION

version 0.101

SYNOPSIS

my $robot = WWW::Hetzner::Robot->new(...);

# List all failover IPs
my $failovers = $robot->failover->list;

# Get one failover IP
my $failover = $robot->failover->get('203.0.113.60');
print $failover->active_server_ip, "\n";

# Route it to another server
$robot->failover->switch('203.0.113.60', '198.51.100.10');

# Drop the routing
$robot->failover->delete('203.0.113.60');

DESCRIPTION

Failover IPs are routed to one of your dedicated servers and can be switched to another one, which is how a service survives the loss of a machine.

Hetzner rate limits switching hard (50 requests per hour) - a failover switch is not a health check.

list

Returns arrayref of WWW::Hetzner::Robot::Failover objects.

get

my $failover = $robot->failover->get($failover_ip);

Returns WWW::Hetzner::Robot::Failover object.

switch

my $failover = $robot->failover->switch($failover_ip, $target_server_ip);

Routes the failover IP to another server. $target_server_ip is the main IP of the destination server, or its subnet address for IPv6.

delete

$robot->failover->delete($failover_ip);

Deletes the routing of the failover IP. The IP itself stays in the account - this is not a cancellation.

SEE ALSO

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 <torsten@raudssus.de> https://raudssus.de/.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.