/ 
WWW-Hetzner-0.001
/ WWW::Hetzner::Cloud::API::Images

NAME

WWW::Hetzner::Cloud::API::Images - Hetzner Cloud Images API

VERSION

version 0.001

SYNOPSIS

use WWW::Hetzner::Cloud;

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

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

# Filter by type
my $snapshots = $cloud->images->list(type => 'snapshot');

# Get by name
my $debian = $cloud->images->get_by_name('debian-13');
printf "Image: %s (%s)\n", $debian->name, $debian->description;

DESCRIPTION

This module provides access to Hetzner Cloud images. Images can be system images (provided by Hetzner), snapshots (user-created), or backups. All methods return WWW::Hetzner::Cloud::Image objects.

NAME

WWW::Hetzner::Cloud::API::Images - Hetzner Cloud Images API

METHODS

list

my $images = $cloud->images->list;
my $images = $cloud->images->list(type => 'system');

Returns an arrayref of WWW::Hetzner::Cloud::Image objects. Optional parameters:

  • type - Filter by type: system, snapshot, backup

  • status - Filter by status: available, creating

  • name - Filter by name

get

my $image = $cloud->images->get($id);

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

get_by_name

my $image = $cloud->images->get_by_name('debian-13');

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

SUPPORT

Source Code

The code is open to the world, and available for you to hack on. Please feel free to browse it and play with it, or whatever. If you want to contribute patches, please send me a diff or prod me to pull from your repository :)

https://github.com/Getty/p5-www-hetzner

git clone https://github.com/Getty/p5-www-hetzner.git

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.