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

NAME

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

VERSION

version 0.101

SYNOPSIS

use WWW::Hetzner::Cloud;

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

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

# 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.

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

list_all

my $entities = $controller->list_all(per_page => 50, %filters);

Returns a combined arrayref. Inherited from "list_all" in WWW::Hetzner::Role::Pagination. Unlike "list", which fetches one page, it follows every subsequent page starting at page 1 or the supplied page. It carries per_page, filters, and sort values to every request.

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.

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.