steampipe plugin install hcloud

Table: hcloud_image - Query Hetzner Cloud Images using SQL

Hetzner Cloud Images are system images and snapshots that can be used to create new servers. These images include pre-configured operating systems, applications, and configurations that are stored in Hetzner Cloud. They can be public (provided by Hetzner), private (custom images created by users), or snapshots created from existing servers.

Table Usage Guide

The hcloud_image table provides insights into images within Hetzner Cloud. As a cloud administrator, explore image-specific details through this table, including image type, status, and associated metadata. Utilize it to uncover information about images, such as their description, source server, and the last time they were updated.

Examples

List all images

Explore all available images in your system to gain a better understanding of your resources. This can be useful for managing and organizing your digital assets.

select
id,
name,
description
from
hcloud_image
order by
id;
select
id,
name,
description
from
hcloud_image
order by
id;

Find all deprecated images

Uncover the details of outdated images within your system to better manage and update your resources for optimal performance.

select
id,
name,
description,
deprecated
from
hcloud_image
where
deprecated is not null;
select
id,
name,
description,
deprecated
from
hcloud_image
where
deprecated is not null;

Schema for hcloud_image

NameTypeOperatorsDescription
_ctxjsonbSteampipe context in JSON form, e.g. connection_name.
bound_tobigintID of Server the Image is bound to. Only set for Images of type backup.
build_idtextBuild ID of the Image.
createdtimestamp with time zonePoint in time when the Image was created.
created_fromjsonbInformation about the Server the Image was created from.
deletedtimestamp with time zonePoint in time when the Image was deleted.
deprecatedtimestamp with time zonePoint in time when the Image was deprecated.
descriptiontextDescription of the Image.
disk_sizebigintSize of the disk contained in the Image in GB.
idbigint=ID of the Image.
image_sizebigintSize of the Image file in our storage in GB. For snapshot Images this is the value relevant for calculating costs for the Image.
image_typetext=Type of the Image: system, app, snapshot, backup, temporary.
labelsjsonbUser-defined labels (key-value pairs).
nametext=Unique identifier of the Image. This value is only set for system Images.
os_flavortextFlavor of operating system contained in the Image: ubuntu, centos, debian, fedora, unknown.
os_versiontextOperating system version.
protectionjsonbProtection configuration for the Resource.
rapid_deploybooleanIndicates that rapid deploy of the Image is available.
statustext=Whether the Image can be used or if it's still being created or unavailable: available, creating, unavailable.

Export

This table is available as a standalone Exporter CLI. Steampipe exporters are stand-alone binaries that allow you to extract data using Steampipe plugins without a database.

You can download the tarball for your platform from the Releases page, but it is simplest to install them with the steampipe_export_installer.sh script:

/bin/sh -c "$(curl -fsSL https://steampipe.io/install/export.sh)" -- hcloud

You can pass the configuration to the command with the --config argument:

steampipe_export_hcloud --config '<your_config>' hcloud_image