NAME

WWW::Hetzner::Cloud::API::Locations - Hetzner Cloud Locations API

VERSION

version 0.002

SYNOPSIS

use WWW::Hetzner::Cloud;

my $cloud = WWW::Hetzner::Cloud->new(token => $ENV{HETZNER_API_TOKEN});

# List all locations
my $locations = $cloud->locations->list;

# Get by name
my $fsn1 = $cloud->locations->get_by_name('fsn1');
printf "Falkenstein: %s, %s\n", $fsn1->city, $fsn1->country;

DESCRIPTION

This module provides access to Hetzner Cloud locations. Locations are physical data center sites where servers can be deployed. All methods return WWW::Hetzner::Cloud::Location objects.

Available locations: fsn1 (Falkenstein), nbg1 (Nuremberg), hel1 (Helsinki), ash (Ashburn), hil (Hillsboro), sin (Singapore).

list

my $locations = $cloud->locations->list;

Returns an arrayref of WWW::Hetzner::Cloud::Location objects.

get

my $location = $cloud->locations->get($id);

Returns a WWW::Hetzner::Cloud::Location object.

get_by_name

my $location = $cloud->locations->get_by_name('fsn1');

Returns a WWW::Hetzner::Cloud::Location object. Returns undef if not found.

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.