1. Packages
  2. Gcore Provider
  3. API Docs
  4. CloudInstanceImage
Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core
Schema (JSON)
g-core/terraform-provider-gcore

gcore.CloudInstanceImage

gcore logo
Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core
Schema (JSON)
g-core/terraform-provider-gcore

    Instance images are operating system images (public, private, or shared) used to boot cloud instances.

    Example Usage

    Upload custom image from URL

    Upload a custom instance image from a publicly accessible URL.

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

// Upload a custom instance image from URL
const ubuntu = new gcore.CloudInstanceImage("ubuntu", {
    projectId: 1,
    regionId: 1,
    name: "ubuntu-22.04-custom",
    url: "https://cloud-images.ubuntu.com/releases/22.04/release/ubuntu-22.04-server-cloudimg-amd64.img",
    osDistro: "ubuntu",
    osType: "linux",
    osVersion: "22.04",
    sshKey: "allow",
});

    import pulumi
import pulumi_gcore as gcore

# Upload a custom instance image from URL
ubuntu = gcore.CloudInstanceImage("ubuntu",
    project_id=1,
    region_id=1,
    name="ubuntu-22.04-custom",
    url="https://cloud-images.ubuntu.com/releases/22.04/release/ubuntu-22.04-server-cloudimg-amd64.img",
    os_distro="ubuntu",
    os_type="linux",
    os_version="22.04",
    ssh_key="allow")

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Upload a custom instance image from URL
		_, err := gcore.NewCloudInstanceImage(ctx, "ubuntu", &gcore.CloudInstanceImageArgs{
			ProjectId: pulumi.Float64(1),
			RegionId:  pulumi.Float64(1),
			Name:      pulumi.String("ubuntu-22.04-custom"),
			Url:       pulumi.String("https://cloud-images.ubuntu.com/releases/22.04/release/ubuntu-22.04-server-cloudimg-amd64.img"),
			OsDistro:  pulumi.String("ubuntu"),
			OsType:    pulumi.String("linux"),
			OsVersion: pulumi.String("22.04"),
			SshKey:    pulumi.String("allow"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    // Upload a custom instance image from URL
    var ubuntu = new Gcore.CloudInstanceImage("ubuntu", new()
    {
        ProjectId = 1,
        RegionId = 1,
        Name = "ubuntu-22.04-custom",
        Url = "https://cloud-images.ubuntu.com/releases/22.04/release/ubuntu-22.04-server-cloudimg-amd64.img",
        OsDistro = "ubuntu",
        OsType = "linux",
        OsVersion = "22.04",
        SshKey = "allow",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcore.CloudInstanceImage;
import com.pulumi.gcore.CloudInstanceImageArgs;
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) {
        // Upload a custom instance image from URL
        var ubuntu = new CloudInstanceImage("ubuntu", CloudInstanceImageArgs.builder()
            .projectId(1.0)
            .regionId(1.0)
            .name("ubuntu-22.04-custom")
            .url("https://cloud-images.ubuntu.com/releases/22.04/release/ubuntu-22.04-server-cloudimg-amd64.img")
            .osDistro("ubuntu")
            .osType("linux")
            .osVersion("22.04")
            .sshKey("allow")
            .build());

    }
}

    resources:
  # Upload a custom instance image from URL
  ubuntu:
    type: gcore:CloudInstanceImage
    properties:
      projectId: 1
      regionId: 1
      name: ubuntu-22.04-custom
      url: https://cloud-images.ubuntu.com/releases/22.04/release/ubuntu-22.04-server-cloudimg-amd64.img
      osDistro: ubuntu
      osType: linux
      osVersion: '22.04'
      sshKey: allow

    Create CloudInstanceImage Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new CloudInstanceImage(name: string, args: CloudInstanceImageArgs, opts?: CustomResourceOptions);
    @overload
def CloudInstanceImage(resource_name: str,
                       args: CloudInstanceImageArgs,
                       opts: Optional[ResourceOptions] = None)

@overload
def CloudInstanceImage(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       url: Optional[str] = None,
                       os_distro: Optional[str] = None,
                       hw_firmware_type: Optional[str] = None,
                       hw_machine_type: Optional[str] = None,
                       is_baremetal: Optional[bool] = None,
                       name: Optional[str] = None,
                       architecture: Optional[str] = None,
                       os_type: Optional[str] = None,
                       os_version: Optional[str] = None,
                       project_id: Optional[float] = None,
                       region_id: Optional[float] = None,
                       ssh_key: Optional[str] = None,
                       tags: Optional[Mapping[str, str]] = None,
                       cow_format: Optional[bool] = None)
    func NewCloudInstanceImage(ctx *Context, name string, args CloudInstanceImageArgs, opts ...ResourceOption) (*CloudInstanceImage, error)
    public CloudInstanceImage(string name, CloudInstanceImageArgs args, CustomResourceOptions? opts = null)
    public CloudInstanceImage(String name, CloudInstanceImageArgs args)
public CloudInstanceImage(String name, CloudInstanceImageArgs args, CustomResourceOptions options)

    type: gcore:CloudInstanceImage
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args CloudInstanceImageArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args CloudInstanceImageArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args CloudInstanceImageArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args CloudInstanceImageArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args CloudInstanceImageArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var cloudInstanceImageResource = new Gcore.CloudInstanceImage("cloudInstanceImageResource", new()
{
    Url = "string",
    OsDistro = "string",
    HwFirmwareType = "string",
    HwMachineType = "string",
    IsBaremetal = false,
    Name = "string",
    Architecture = "string",
    OsType = "string",
    OsVersion = "string",
    ProjectId = 0,
    RegionId = 0,
    SshKey = "string",
    Tags = 
    {
        { "string", "string" },
    },
    CowFormat = false,
});

    example, err := gcore.NewCloudInstanceImage(ctx, "cloudInstanceImageResource", &gcore.CloudInstanceImageArgs{
	Url:            pulumi.String("string"),
	OsDistro:       pulumi.String("string"),
	HwFirmwareType: pulumi.String("string"),
	HwMachineType:  pulumi.String("string"),
	IsBaremetal:    pulumi.Bool(false),
	Name:           pulumi.String("string"),
	Architecture:   pulumi.String("string"),
	OsType:         pulumi.String("string"),
	OsVersion:      pulumi.String("string"),
	ProjectId:      pulumi.Float64(0),
	RegionId:       pulumi.Float64(0),
	SshKey:         pulumi.String("string"),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	CowFormat: pulumi.Bool(false),
})

    var cloudInstanceImageResource = new CloudInstanceImage("cloudInstanceImageResource", CloudInstanceImageArgs.builder()
    .url("string")
    .osDistro("string")
    .hwFirmwareType("string")
    .hwMachineType("string")
    .isBaremetal(false)
    .name("string")
    .architecture("string")
    .osType("string")
    .osVersion("string")
    .projectId(0.0)
    .regionId(0.0)
    .sshKey("string")
    .tags(Map.of("string", "string"))
    .cowFormat(false)
    .build());

    cloud_instance_image_resource = gcore.CloudInstanceImage("cloudInstanceImageResource",
    url="string",
    os_distro="string",
    hw_firmware_type="string",
    hw_machine_type="string",
    is_baremetal=False,
    name="string",
    architecture="string",
    os_type="string",
    os_version="string",
    project_id=0,
    region_id=0,
    ssh_key="string",
    tags={
        "string": "string",
    },
    cow_format=False)

    const cloudInstanceImageResource = new gcore.CloudInstanceImage("cloudInstanceImageResource", {
    url: "string",
    osDistro: "string",
    hwFirmwareType: "string",
    hwMachineType: "string",
    isBaremetal: false,
    name: "string",
    architecture: "string",
    osType: "string",
    osVersion: "string",
    projectId: 0,
    regionId: 0,
    sshKey: "string",
    tags: {
        string: "string",
    },
    cowFormat: false,
});

    type: gcore:CloudInstanceImage
properties:
    architecture: string
    cowFormat: false
    hwFirmwareType: string
    hwMachineType: string
    isBaremetal: false
    name: string
    osDistro: string
    osType: string
    osVersion: string
    projectId: 0
    regionId: 0
    sshKey: string
    tags:
        string: string
    url: string

    CloudInstanceImage Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The CloudInstanceImage resource accepts the following input properties:

    Url string
    URL of the image to download.
    Architecture string
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    CowFormat bool
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    HwFirmwareType string
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    HwMachineType string
    A virtual chipset type. Available values: "pc", "q35".
    IsBaremetal bool
    Set to true if the image will be used by bare metal servers. Defaults to false.
    Name string
    Image name
    OsDistro string
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    OsType string
    The operating system installed on the image. Available values: "linux", "windows".
    OsVersion string
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    ProjectId double
    RegionId double
    SshKey string
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    Tags Dictionary<string, string>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    Url string
    URL of the image to download.
    Architecture string
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    CowFormat bool
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    HwFirmwareType string
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    HwMachineType string
    A virtual chipset type. Available values: "pc", "q35".
    IsBaremetal bool
    Set to true if the image will be used by bare metal servers. Defaults to false.
    Name string
    Image name
    OsDistro string
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    OsType string
    The operating system installed on the image. Available values: "linux", "windows".
    OsVersion string
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    ProjectId float64
    RegionId float64
    SshKey string
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    Tags map[string]string
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    url String
    URL of the image to download.
    architecture String
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    cowFormat Boolean
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    hwFirmwareType String
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    hwMachineType String
    A virtual chipset type. Available values: "pc", "q35".
    isBaremetal Boolean
    Set to true if the image will be used by bare metal servers. Defaults to false.
    name String
    Image name
    osDistro String
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    osType String
    The operating system installed on the image. Available values: "linux", "windows".
    osVersion String
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    projectId Double
    regionId Double
    sshKey String
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    tags Map<String,String>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    url string
    URL of the image to download.
    architecture string
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    cowFormat boolean
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    hwFirmwareType string
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    hwMachineType string
    A virtual chipset type. Available values: "pc", "q35".
    isBaremetal boolean
    Set to true if the image will be used by bare metal servers. Defaults to false.
    name string
    Image name
    osDistro string
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    osType string
    The operating system installed on the image. Available values: "linux", "windows".
    osVersion string
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    projectId number
    regionId number
    sshKey string
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    tags {[key: string]: string}
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    url str
    URL of the image to download.
    architecture str
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    cow_format bool
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    hw_firmware_type str
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    hw_machine_type str
    A virtual chipset type. Available values: "pc", "q35".
    is_baremetal bool
    Set to true if the image will be used by bare metal servers. Defaults to false.
    name str
    Image name
    os_distro str
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    os_type str
    The operating system installed on the image. Available values: "linux", "windows".
    os_version str
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    project_id float
    region_id float
    ssh_key str
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    tags Mapping[str, str]
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    url String
    URL of the image to download.
    architecture String
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    cowFormat Boolean
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    hwFirmwareType String
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    hwMachineType String
    A virtual chipset type. Available values: "pc", "q35".
    isBaremetal Boolean
    Set to true if the image will be used by bare metal servers. Defaults to false.
    name String
    Image name
    osDistro String
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    osType String
    The operating system installed on the image. Available values: "linux", "windows".
    osVersion String
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    projectId Number
    regionId Number
    sshKey String
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    tags Map<String>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the CloudInstanceImage resource produces the following output properties:

    CreatedAt string
    Datetime when the image was created
    CreatorTaskId string
    Task that created this entity
    Description string
    Image description
    DiskFormat string
    Disk format
    DisplayOrder double
    GpuDriver string
    Name of the GPU driver vendor
    GpuDriverType string
    Type of the GPU driver
    GpuDriverVersion string
    Version of the installed GPU driver
    Id string
    The provider-assigned unique ID for this managed resource.
    MinDisk double
    Minimal boot volume required
    MinRam double
    Minimal VM RAM required
    Region string
    Region name
    Size double
    Image size in bytes
    Status string
    Image status, i.e. active
    UpdatedAt string
    Datetime when the image was updated
    Visibility string
    Image visibility. Globally visible images are public
    CreatedAt string
    Datetime when the image was created
    CreatorTaskId string
    Task that created this entity
    Description string
    Image description
    DiskFormat string
    Disk format
    DisplayOrder float64
    GpuDriver string
    Name of the GPU driver vendor
    GpuDriverType string
    Type of the GPU driver
    GpuDriverVersion string
    Version of the installed GPU driver
    Id string
    The provider-assigned unique ID for this managed resource.
    MinDisk float64
    Minimal boot volume required
    MinRam float64
    Minimal VM RAM required
    Region string
    Region name
    Size float64
    Image size in bytes
    Status string
    Image status, i.e. active
    UpdatedAt string
    Datetime when the image was updated
    Visibility string
    Image visibility. Globally visible images are public
    createdAt String
    Datetime when the image was created
    creatorTaskId String
    Task that created this entity
    description String
    Image description
    diskFormat String
    Disk format
    displayOrder Double
    gpuDriver String
    Name of the GPU driver vendor
    gpuDriverType String
    Type of the GPU driver
    gpuDriverVersion String
    Version of the installed GPU driver
    id String
    The provider-assigned unique ID for this managed resource.
    minDisk Double
    Minimal boot volume required
    minRam Double
    Minimal VM RAM required
    region String
    Region name
    size Double
    Image size in bytes
    status String
    Image status, i.e. active
    updatedAt String
    Datetime when the image was updated
    visibility String
    Image visibility. Globally visible images are public
    createdAt string
    Datetime when the image was created
    creatorTaskId string
    Task that created this entity
    description string
    Image description
    diskFormat string
    Disk format
    displayOrder number
    gpuDriver string
    Name of the GPU driver vendor
    gpuDriverType string
    Type of the GPU driver
    gpuDriverVersion string
    Version of the installed GPU driver
    id string
    The provider-assigned unique ID for this managed resource.
    minDisk number
    Minimal boot volume required
    minRam number
    Minimal VM RAM required
    region string
    Region name
    size number
    Image size in bytes
    status string
    Image status, i.e. active
    updatedAt string
    Datetime when the image was updated
    visibility string
    Image visibility. Globally visible images are public
    created_at str
    Datetime when the image was created
    creator_task_id str
    Task that created this entity
    description str
    Image description
    disk_format str
    Disk format
    display_order float
    gpu_driver str
    Name of the GPU driver vendor
    gpu_driver_type str
    Type of the GPU driver
    gpu_driver_version str
    Version of the installed GPU driver
    id str
    The provider-assigned unique ID for this managed resource.
    min_disk float
    Minimal boot volume required
    min_ram float
    Minimal VM RAM required
    region str
    Region name
    size float
    Image size in bytes
    status str
    Image status, i.e. active
    updated_at str
    Datetime when the image was updated
    visibility str
    Image visibility. Globally visible images are public
    createdAt String
    Datetime when the image was created
    creatorTaskId String
    Task that created this entity
    description String
    Image description
    diskFormat String
    Disk format
    displayOrder Number
    gpuDriver String
    Name of the GPU driver vendor
    gpuDriverType String
    Type of the GPU driver
    gpuDriverVersion String
    Version of the installed GPU driver
    id String
    The provider-assigned unique ID for this managed resource.
    minDisk Number
    Minimal boot volume required
    minRam Number
    Minimal VM RAM required
    region String
    Region name
    size Number
    Image size in bytes
    status String
    Image status, i.e. active
    updatedAt String
    Datetime when the image was updated
    visibility String
    Image visibility. Globally visible images are public

    Look up Existing CloudInstanceImage Resource

    Get an existing CloudInstanceImage resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: CloudInstanceImageState, opts?: CustomResourceOptions): CloudInstanceImage
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        architecture: Optional[str] = None,
        cow_format: Optional[bool] = None,
        created_at: Optional[str] = None,
        creator_task_id: Optional[str] = None,
        description: Optional[str] = None,
        disk_format: Optional[str] = None,
        display_order: Optional[float] = None,
        gpu_driver: Optional[str] = None,
        gpu_driver_type: Optional[str] = None,
        gpu_driver_version: Optional[str] = None,
        hw_firmware_type: Optional[str] = None,
        hw_machine_type: Optional[str] = None,
        is_baremetal: Optional[bool] = None,
        min_disk: Optional[float] = None,
        min_ram: Optional[float] = None,
        name: Optional[str] = None,
        os_distro: Optional[str] = None,
        os_type: Optional[str] = None,
        os_version: Optional[str] = None,
        project_id: Optional[float] = None,
        region: Optional[str] = None,
        region_id: Optional[float] = None,
        size: Optional[float] = None,
        ssh_key: Optional[str] = None,
        status: Optional[str] = None,
        tags: Optional[Mapping[str, str]] = None,
        updated_at: Optional[str] = None,
        url: Optional[str] = None,
        visibility: Optional[str] = None) -> CloudInstanceImage
    func GetCloudInstanceImage(ctx *Context, name string, id IDInput, state *CloudInstanceImageState, opts ...ResourceOption) (*CloudInstanceImage, error)
    public static CloudInstanceImage Get(string name, Input<string> id, CloudInstanceImageState? state, CustomResourceOptions? opts = null)
    public static CloudInstanceImage get(String name, Output<String> id, CloudInstanceImageState state, CustomResourceOptions options)
    resources:  _:    type: gcore:CloudInstanceImage    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Architecture string
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    CowFormat bool
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    CreatedAt string
    Datetime when the image was created
    CreatorTaskId string
    Task that created this entity
    Description string
    Image description
    DiskFormat string
    Disk format
    DisplayOrder double
    GpuDriver string
    Name of the GPU driver vendor
    GpuDriverType string
    Type of the GPU driver
    GpuDriverVersion string
    Version of the installed GPU driver
    HwFirmwareType string
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    HwMachineType string
    A virtual chipset type. Available values: "pc", "q35".
    IsBaremetal bool
    Set to true if the image will be used by bare metal servers. Defaults to false.
    MinDisk double
    Minimal boot volume required
    MinRam double
    Minimal VM RAM required
    Name string
    Image name
    OsDistro string
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    OsType string
    The operating system installed on the image. Available values: "linux", "windows".
    OsVersion string
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    ProjectId double
    Region string
    Region name
    RegionId double
    Size double
    Image size in bytes
    SshKey string
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    Status string
    Image status, i.e. active
    Tags Dictionary<string, string>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    UpdatedAt string
    Datetime when the image was updated
    Url string
    URL of the image to download.
    Visibility string
    Image visibility. Globally visible images are public
    Architecture string
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    CowFormat bool
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    CreatedAt string
    Datetime when the image was created
    CreatorTaskId string
    Task that created this entity
    Description string
    Image description
    DiskFormat string
    Disk format
    DisplayOrder float64
    GpuDriver string
    Name of the GPU driver vendor
    GpuDriverType string
    Type of the GPU driver
    GpuDriverVersion string
    Version of the installed GPU driver
    HwFirmwareType string
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    HwMachineType string
    A virtual chipset type. Available values: "pc", "q35".
    IsBaremetal bool
    Set to true if the image will be used by bare metal servers. Defaults to false.
    MinDisk float64
    Minimal boot volume required
    MinRam float64
    Minimal VM RAM required
    Name string
    Image name
    OsDistro string
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    OsType string
    The operating system installed on the image. Available values: "linux", "windows".
    OsVersion string
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    ProjectId float64
    Region string
    Region name
    RegionId float64
    Size float64
    Image size in bytes
    SshKey string
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    Status string
    Image status, i.e. active
    Tags map[string]string
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    UpdatedAt string
    Datetime when the image was updated
    Url string
    URL of the image to download.
    Visibility string
    Image visibility. Globally visible images are public
    architecture String
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    cowFormat Boolean
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    createdAt String
    Datetime when the image was created
    creatorTaskId String
    Task that created this entity
    description String
    Image description
    diskFormat String
    Disk format
    displayOrder Double
    gpuDriver String
    Name of the GPU driver vendor
    gpuDriverType String
    Type of the GPU driver
    gpuDriverVersion String
    Version of the installed GPU driver
    hwFirmwareType String
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    hwMachineType String
    A virtual chipset type. Available values: "pc", "q35".
    isBaremetal Boolean
    Set to true if the image will be used by bare metal servers. Defaults to false.
    minDisk Double
    Minimal boot volume required
    minRam Double
    Minimal VM RAM required
    name String
    Image name
    osDistro String
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    osType String
    The operating system installed on the image. Available values: "linux", "windows".
    osVersion String
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    projectId Double
    region String
    Region name
    regionId Double
    size Double
    Image size in bytes
    sshKey String
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    status String
    Image status, i.e. active
    tags Map<String,String>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt String
    Datetime when the image was updated
    url String
    URL of the image to download.
    visibility String
    Image visibility. Globally visible images are public
    architecture string
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    cowFormat boolean
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    createdAt string
    Datetime when the image was created
    creatorTaskId string
    Task that created this entity
    description string
    Image description
    diskFormat string
    Disk format
    displayOrder number
    gpuDriver string
    Name of the GPU driver vendor
    gpuDriverType string
    Type of the GPU driver
    gpuDriverVersion string
    Version of the installed GPU driver
    hwFirmwareType string
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    hwMachineType string
    A virtual chipset type. Available values: "pc", "q35".
    isBaremetal boolean
    Set to true if the image will be used by bare metal servers. Defaults to false.
    minDisk number
    Minimal boot volume required
    minRam number
    Minimal VM RAM required
    name string
    Image name
    osDistro string
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    osType string
    The operating system installed on the image. Available values: "linux", "windows".
    osVersion string
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    projectId number
    region string
    Region name
    regionId number
    size number
    Image size in bytes
    sshKey string
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    status string
    Image status, i.e. active
    tags {[key: string]: string}
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt string
    Datetime when the image was updated
    url string
    URL of the image to download.
    visibility string
    Image visibility. Globally visible images are public
    architecture str
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    cow_format bool
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    created_at str
    Datetime when the image was created
    creator_task_id str
    Task that created this entity
    description str
    Image description
    disk_format str
    Disk format
    display_order float
    gpu_driver str
    Name of the GPU driver vendor
    gpu_driver_type str
    Type of the GPU driver
    gpu_driver_version str
    Version of the installed GPU driver
    hw_firmware_type str
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    hw_machine_type str
    A virtual chipset type. Available values: "pc", "q35".
    is_baremetal bool
    Set to true if the image will be used by bare metal servers. Defaults to false.
    min_disk float
    Minimal boot volume required
    min_ram float
    Minimal VM RAM required
    name str
    Image name
    os_distro str
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    os_type str
    The operating system installed on the image. Available values: "linux", "windows".
    os_version str
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    project_id float
    region str
    Region name
    region_id float
    size float
    Image size in bytes
    ssh_key str
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    status str
    Image status, i.e. active
    tags Mapping[str, str]
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updated_at str
    Datetime when the image was updated
    url str
    URL of the image to download.
    visibility str
    Image visibility. Globally visible images are public
    architecture String
    Image CPU architecture type: aarch64, x86_64 Available values: "aarch64", <span pulumi-lang-nodejs=""x8664"" pulumi-lang-dotnet=""X8664"" pulumi-lang-go=""x8664"" pulumi-lang-python=""x86_64"" pulumi-lang-yaml=""x8664"" pulumi-lang-java=""x8664"">"x86_64".
    cowFormat Boolean
    When True, image cannot be deleted unless all volumes, created from it, are deleted.
    createdAt String
    Datetime when the image was created
    creatorTaskId String
    Task that created this entity
    description String
    Image description
    diskFormat String
    Disk format
    displayOrder Number
    gpuDriver String
    Name of the GPU driver vendor
    gpuDriverType String
    Type of the GPU driver
    gpuDriverVersion String
    Version of the installed GPU driver
    hwFirmwareType String
    Specifies the type of firmware with which to boot the guest. Available values: "bios", "uefi".
    hwMachineType String
    A virtual chipset type. Available values: "pc", "q35".
    isBaremetal Boolean
    Set to true if the image will be used by bare metal servers. Defaults to false.
    minDisk Number
    Minimal boot volume required
    minRam Number
    Minimal VM RAM required
    name String
    Image name
    osDistro String
    OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc.
    osType String
    The operating system installed on the image. Available values: "linux", "windows".
    osVersion String
    OS version, i.e. 22.04 (for Ubuntu) or 9.4 for Debian
    projectId Number
    region String
    Region name
    regionId Number
    size Number
    Image size in bytes
    sshKey String
    Whether the image supports SSH key or not Available values: "allow", "deny", "required".
    status String
    Image status, i.e. active
    tags Map<String>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt String
    Datetime when the image was updated
    url String
    URL of the image to download.
    visibility String
    Image visibility. Globally visible images are public

    Import

    $ pulumi import gcore:index/cloudInstanceImage:CloudInstanceImage example '<project_id>/<region_id>/<image_id>'

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    gcore g-core/terraform-provider-gcore
    License
    Notes
    This Pulumi package is based on the gcore Terraform Provider.
    gcore logo
    Viewing docs for gcore 2.0.0-alpha.2
    published on Tuesday, Mar 24, 2026 by g-core
    Schema (JSON)
    g-core/terraform-provider-gcore
      Try Pulumi Cloud free. Your team will thank you.