hcloud.getImage

Explore with Pulumi AI

Hetzner Cloud v1.23.0 published on Wednesday, May 21, 2025 by Pulumi

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as hcloud from "@pulumi/hcloud";

const byId = hcloud.getImage({
    id: 114690387,
});
const byNameX86 = hcloud.getImage({
    name: "debian-12",
    withArchitecture: "x86",
});
const byNameArm = hcloud.getImage({
    name: "debian-12",
    withArchitecture: "arm",
});
const byLabel = hcloud.getImage({
    withSelector: "key=value",
});
const main = new hcloud.Server("main", {image: byName.id});

import pulumi
import pulumi_hcloud as hcloud

by_id = hcloud.get_image(id=114690387)
by_name_x86 = hcloud.get_image(name="debian-12",
    with_architecture="x86")
by_name_arm = hcloud.get_image(name="debian-12",
    with_architecture="arm")
by_label = hcloud.get_image(with_selector="key=value")
main = hcloud.Server("main", image=by_name["id"])

package main

import (
	"github.com/pulumi/pulumi-hcloud/sdk/go/hcloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := hcloud.GetImage(ctx, &hcloud.GetImageArgs{
			Id: pulumi.IntRef(114690387),
		}, nil)
		if err != nil {
			return err
		}
		_, err = hcloud.GetImage(ctx, &hcloud.GetImageArgs{
			Name:             pulumi.StringRef("debian-12"),
			WithArchitecture: pulumi.StringRef("x86"),
		}, nil)
		if err != nil {
			return err
		}
		_, err = hcloud.GetImage(ctx, &hcloud.GetImageArgs{
			Name:             pulumi.StringRef("debian-12"),
			WithArchitecture: pulumi.StringRef("arm"),
		}, nil)
		if err != nil {
			return err
		}
		_, err = hcloud.GetImage(ctx, &hcloud.GetImageArgs{
			WithSelector: pulumi.StringRef("key=value"),
		}, nil)
		if err != nil {
			return err
		}
		_, err = hcloud.NewServer(ctx, "main", &hcloud.ServerArgs{
			Image: pulumi.Any(byName.Id),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using HCloud = Pulumi.HCloud;

return await Deployment.RunAsync(() => 
{
    var byId = HCloud.GetImage.Invoke(new()
    {
        Id = 114690387,
    });

    var byNameX86 = HCloud.GetImage.Invoke(new()
    {
        Name = "debian-12",
        WithArchitecture = "x86",
    });

    var byNameArm = HCloud.GetImage.Invoke(new()
    {
        Name = "debian-12",
        WithArchitecture = "arm",
    });

    var byLabel = HCloud.GetImage.Invoke(new()
    {
        WithSelector = "key=value",
    });

    var main = new HCloud.Server("main", new()
    {
        Image = byName.Id,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.hcloud.HcloudFunctions;
import com.pulumi.hcloud.inputs.GetImageArgs;
import com.pulumi.hcloud.Server;
import com.pulumi.hcloud.ServerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var byId = HcloudFunctions.getImage(GetImageArgs.builder()
            .id(114690387)
            .build());

        final var byNameX86 = HcloudFunctions.getImage(GetImageArgs.builder()
            .name("debian-12")
            .withArchitecture("x86")
            .build());

        final var byNameArm = HcloudFunctions.getImage(GetImageArgs.builder()
            .name("debian-12")
            .withArchitecture("arm")
            .build());

        final var byLabel = HcloudFunctions.getImage(GetImageArgs.builder()
            .withSelector("key=value")
            .build());

        var main = new Server("main", ServerArgs.builder()
            .image(byName.id())
            .build());

    }
}

resources:
  main:
    type: hcloud:Server
    properties:
      image: ${byName.id}
variables:
  byId:
    fn::invoke:
      function: hcloud:getImage
      arguments:
        id: '114690387'
  byNameX86:
    fn::invoke:
      function: hcloud:getImage
      arguments:
        name: debian-12
        withArchitecture: x86
  byNameArm:
    fn::invoke:
      function: hcloud:getImage
      arguments:
        name: debian-12
        withArchitecture: arm
  byLabel:
    fn::invoke:
      function: hcloud:getImage
      arguments:
        withSelector: key=value

Using getImage

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getImage(args: GetImageArgs, opts?: InvokeOptions): Promise<GetImageResult>
function getImageOutput(args: GetImageOutputArgs, opts?: InvokeOptions): Output<GetImageResult>

def get_image(id: Optional[int] = None,
              include_deprecated: Optional[bool] = None,
              most_recent: Optional[bool] = None,
              name: Optional[str] = None,
              selector: Optional[str] = None,
              with_architecture: Optional[str] = None,
              with_selector: Optional[str] = None,
              with_statuses: Optional[Sequence[str]] = None,
              opts: Optional[InvokeOptions] = None) -> GetImageResult
def get_image_output(id: Optional[pulumi.Input[int]] = None,
              include_deprecated: Optional[pulumi.Input[bool]] = None,
              most_recent: Optional[pulumi.Input[bool]] = None,
              name: Optional[pulumi.Input[str]] = None,
              selector: Optional[pulumi.Input[str]] = None,
              with_architecture: Optional[pulumi.Input[str]] = None,
              with_selector: Optional[pulumi.Input[str]] = None,
              with_statuses: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
              opts: Optional[InvokeOptions] = None) -> Output[GetImageResult]

func GetImage(ctx *Context, args *GetImageArgs, opts ...InvokeOption) (*GetImageResult, error)
func GetImageOutput(ctx *Context, args *GetImageOutputArgs, opts ...InvokeOption) GetImageResultOutput

> Note: This function is named GetImage in the Go SDK.

public static class GetImage 
{
    public static Task<GetImageResult> InvokeAsync(GetImageArgs args, InvokeOptions? opts = null)
    public static Output<GetImageResult> Invoke(GetImageInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetImageResult> getImage(GetImageArgs args, InvokeOptions options)
public static Output<GetImageResult> getImage(GetImageArgs args, InvokeOptions options)

fn::invoke:
  function: hcloud:index/getImage:getImage
  arguments:
    # arguments dictionary

The following arguments are supported:

Id int: ID of the Image.
IncludeDeprecated bool: Also return the image if it is marked as deprecated.
MostRecent bool: If more than one result is returned, use the most recent Image.
Name string: Name of the Image.
Selector string: Deprecated: Please use the with_selector property instead.
WithArchitecture string: Select only images with this architecture, could be x86 (default) or arm.
WithSelector string: Label selector
WithStatuses List<string>: Select only images with the specified status, could contain creating or available.

Id int: ID of the Image.
IncludeDeprecated bool: Also return the image if it is marked as deprecated.
MostRecent bool: If more than one result is returned, use the most recent Image.
Name string: Name of the Image.
Selector string: Deprecated: Please use the with_selector property instead.
WithArchitecture string: Select only images with this architecture, could be x86 (default) or arm.
WithSelector string: Label selector
WithStatuses []string: Select only images with the specified status, could contain creating or available.

id Integer: ID of the Image.
includeDeprecated Boolean: Also return the image if it is marked as deprecated.
mostRecent Boolean: If more than one result is returned, use the most recent Image.
name String: Name of the Image.
selector String: Deprecated: Please use the with_selector property instead.
withArchitecture String: Select only images with this architecture, could be x86 (default) or arm.
withSelector String: Label selector
withStatuses List<String>: Select only images with the specified status, could contain creating or available.

id number: ID of the Image.
includeDeprecated boolean: Also return the image if it is marked as deprecated.
mostRecent boolean: If more than one result is returned, use the most recent Image.
name string: Name of the Image.
selector string: Deprecated: Please use the with_selector property instead.
withArchitecture string: Select only images with this architecture, could be x86 (default) or arm.
withSelector string: Label selector
withStatuses string[]: Select only images with the specified status, could contain creating or available.

id int: ID of the Image.
include_deprecated bool: Also return the image if it is marked as deprecated.
most_recent bool: If more than one result is returned, use the most recent Image.
name str: Name of the Image.
selector str: Deprecated: Please use the with_selector property instead.
with_architecture str: Select only images with this architecture, could be x86 (default) or arm.
with_selector str: Label selector
with_statuses Sequence[str]: Select only images with the specified status, could contain creating or available.

id Number: ID of the Image.
includeDeprecated Boolean: Also return the image if it is marked as deprecated.
mostRecent Boolean: If more than one result is returned, use the most recent Image.
name String: Name of the Image.
selector String: Deprecated: Please use the with_selector property instead.
withArchitecture String: Select only images with this architecture, could be x86 (default) or arm.
withSelector String: Label selector
withStatuses List<String>: Select only images with the specified status, could contain creating or available.

getImage Result

The following output properties are available:

Architecture string: (string) Architecture of the Image.
Created string: (string) Date when the Image was created (in ISO-8601 format).
Deprecated string: (string) Point in time when the image is considered to be deprecated (in ISO-8601 format).
Description string: (string) Description of the Image.
Id int: (int) Unique ID of the Image.
Labels Dictionary<string, string>
Name string: (string) Name of the Image, only present when the Image is of type system.
OsFlavor string: (string) Flavor of operating system contained in the image, could be ubuntu, centos, debian, fedora or unknown.
OsVersion string: (string) Operating system version.
RapidDeploy bool: (bool) Indicates that rapid deploy of the image is available.
Type string: (string) Type of the Image, could be system, backup or snapshot.
IncludeDeprecated bool
MostRecent bool
Selector string: Deprecated: Please use the with_selector property instead.
WithArchitecture string
WithSelector string
WithStatuses List<string>

Architecture string: (string) Architecture of the Image.
Created string: (string) Date when the Image was created (in ISO-8601 format).
Deprecated string: (string) Point in time when the image is considered to be deprecated (in ISO-8601 format).
Description string: (string) Description of the Image.
Id int: (int) Unique ID of the Image.
Labels map[string]string
Name string: (string) Name of the Image, only present when the Image is of type system.
OsFlavor string: (string) Flavor of operating system contained in the image, could be ubuntu, centos, debian, fedora or unknown.
OsVersion string: (string) Operating system version.
RapidDeploy bool: (bool) Indicates that rapid deploy of the image is available.
Type string: (string) Type of the Image, could be system, backup or snapshot.
IncludeDeprecated bool
MostRecent bool
Selector string: Deprecated: Please use the with_selector property instead.
WithArchitecture string
WithSelector string
WithStatuses []string

architecture String: (string) Architecture of the Image.
created String: (string) Date when the Image was created (in ISO-8601 format).
deprecated String: (string) Point in time when the image is considered to be deprecated (in ISO-8601 format).
description String: (string) Description of the Image.
id Integer: (int) Unique ID of the Image.
labels Map<String,String>
name String: (string) Name of the Image, only present when the Image is of type system.
osFlavor String: (string) Flavor of operating system contained in the image, could be ubuntu, centos, debian, fedora or unknown.
osVersion String: (string) Operating system version.
rapidDeploy Boolean: (bool) Indicates that rapid deploy of the image is available.
type String: (string) Type of the Image, could be system, backup or snapshot.
includeDeprecated Boolean
mostRecent Boolean
selector String: Deprecated: Please use the with_selector property instead.
withArchitecture String
withSelector String
withStatuses List<String>

architecture string: (string) Architecture of the Image.
created string: (string) Date when the Image was created (in ISO-8601 format).
deprecated string: (string) Point in time when the image is considered to be deprecated (in ISO-8601 format).
description string: (string) Description of the Image.
id number: (int) Unique ID of the Image.
labels {[key: string]: string}
name string: (string) Name of the Image, only present when the Image is of type system.
osFlavor string: (string) Flavor of operating system contained in the image, could be ubuntu, centos, debian, fedora or unknown.
osVersion string: (string) Operating system version.
rapidDeploy boolean: (bool) Indicates that rapid deploy of the image is available.
type string: (string) Type of the Image, could be system, backup or snapshot.
includeDeprecated boolean
mostRecent boolean
selector string: Deprecated: Please use the with_selector property instead.
withArchitecture string
withSelector string
withStatuses string[]

architecture str: (string) Architecture of the Image.
created str: (string) Date when the Image was created (in ISO-8601 format).
deprecated str: (string) Point in time when the image is considered to be deprecated (in ISO-8601 format).
description str: (string) Description of the Image.
id int: (int) Unique ID of the Image.
labels Mapping[str, str]
name str: (string) Name of the Image, only present when the Image is of type system.
os_flavor str: (string) Flavor of operating system contained in the image, could be ubuntu, centos, debian, fedora or unknown.
os_version str: (string) Operating system version.
rapid_deploy bool: (bool) Indicates that rapid deploy of the image is available.
type str: (string) Type of the Image, could be system, backup or snapshot.
include_deprecated bool
most_recent bool
selector str: Deprecated: Please use the with_selector property instead.
with_architecture str
with_selector str
with_statuses Sequence[str]

architecture String: (string) Architecture of the Image.
created String: (string) Date when the Image was created (in ISO-8601 format).
deprecated String: (string) Point in time when the image is considered to be deprecated (in ISO-8601 format).
description String: (string) Description of the Image.
id Number: (int) Unique ID of the Image.
labels Map<String>
name String: (string) Name of the Image, only present when the Image is of type system.
osFlavor String: (string) Flavor of operating system contained in the image, could be ubuntu, centos, debian, fedora or unknown.
osVersion String: (string) Operating system version.
rapidDeploy Boolean: (bool) Indicates that rapid deploy of the image is available.
type String: (string) Type of the Image, could be system, backup or snapshot.
includeDeprecated Boolean
mostRecent Boolean
selector String: Deprecated: Please use the with_selector property instead.
withArchitecture String
withSelector String
withStatuses List<String>

Package Details

Repository: Hetzner Cloud pulumi/pulumi-hcloud
License: Apache-2.0
Notes: This Pulumi package is based on the hcloud Terraform Provider.

Hetzner Cloud v1.23.0 published on Wednesday, May 21, 2025 by Pulumi

pulumi/pulumi-hcloud

hcloud.getImage

On this page

On this page

Example Usage

Using getImage

getImage Result

Package Details

On this page

On this page