1. Registry
  2. Packages
  3. OVH
  4. API Docs
  5. getCloudInstanceImages
Viewing docs for OVHCloud v2.19.1
published on Tuesday, Aug 18, 2026 by OVHcloud
ovh logo
Viewing docs for OVHCloud v2.19.1
published on Tuesday, Aug 18, 2026 by OVHcloud

    Use this data source to list the images available in a public cloud project. This is read-only reference data: each entry describes a bootable image the project can create instances from, not an existing resource.

    Using getCloudInstanceImages

    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 getCloudInstanceImages(args: GetCloudInstanceImagesArgs, opts?: InvokeOptions): Promise<GetCloudInstanceImagesResult>
    function getCloudInstanceImagesOutput(args: GetCloudInstanceImagesOutputArgs, opts?: InvokeOutputOptions): Output<GetCloudInstanceImagesResult>
    def get_cloud_instance_images(region: Optional[str] = None,
                                  service_name: Optional[str] = None,
                                  opts: Optional[InvokeOptions] = None) -> GetCloudInstanceImagesResult
    def get_cloud_instance_images_output(region: pulumi.Input[Optional[str]] = None,
                                  service_name: pulumi.Input[Optional[str]] = None,
                                  opts: Optional[InvokeOutputOptions] = None) -> Output[GetCloudInstanceImagesResult]
    func GetCloudInstanceImages(ctx *Context, args *GetCloudInstanceImagesArgs, opts ...InvokeOption) (*GetCloudInstanceImagesResult, error)
    func GetCloudInstanceImagesOutput(ctx *Context, args *GetCloudInstanceImagesOutputArgs, opts ...InvokeOption) GetCloudInstanceImagesResultOutput

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

    public static class GetCloudInstanceImages 
    {
        public static Task<GetCloudInstanceImagesResult> InvokeAsync(GetCloudInstanceImagesArgs args, InvokeOptions? opts = null)
        public static Output<GetCloudInstanceImagesResult> Invoke(GetCloudInstanceImagesInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetCloudInstanceImagesResult> Invoke(GetCloudInstanceImagesInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetCloudInstanceImagesResult> getCloudInstanceImages(GetCloudInstanceImagesArgs args, InvokeOptions options)
    public static Output<GetCloudInstanceImagesResult> getCloudInstanceImages(GetCloudInstanceImagesArgs args, InvokeOptions options)
    public static Output<GetCloudInstanceImagesResult> getCloudInstanceImages(GetCloudInstanceImagesArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: ovh:index/getCloudInstanceImages:getCloudInstanceImages
      arguments:
        # arguments dictionary
    data "ovh_get_cloud_instance_images" "name" {
        # arguments
    }

    The following arguments are supported:

    ServiceName string
    Service name of the resource representing the id of the cloud project.
    Region string
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    ServiceName string
    Service name of the resource representing the id of the cloud project.
    Region string
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    service_name string
    Service name of the resource representing the id of the cloud project.
    region string
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    serviceName String
    Service name of the resource representing the id of the cloud project.
    region String
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    serviceName string
    Service name of the resource representing the id of the cloud project.
    region string
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    service_name str
    Service name of the resource representing the id of the cloud project.
    region str
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    serviceName String
    Service name of the resource representing the id of the cloud project.
    region String
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.

    getCloudInstanceImages Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    Images List<GetCloudInstanceImagesImage>
    Images advertised by the backend for this project, one entry per region the image is offered in:
    ServiceName string
    Region string
    Region code.
    Id string
    The provider-assigned unique ID for this managed resource.
    Images []GetCloudInstanceImagesImage
    Images advertised by the backend for this project, one entry per region the image is offered in:
    ServiceName string
    Region string
    Region code.
    id string
    The provider-assigned unique ID for this managed resource.
    images list(object)
    Images advertised by the backend for this project, one entry per region the image is offered in:
    service_name string
    region string
    Region code.
    id String
    The provider-assigned unique ID for this managed resource.
    images List<GetCloudInstanceImagesImage>
    Images advertised by the backend for this project, one entry per region the image is offered in:
    serviceName String
    region String
    Region code.
    id string
    The provider-assigned unique ID for this managed resource.
    images GetCloudInstanceImagesImage[]
    Images advertised by the backend for this project, one entry per region the image is offered in:
    serviceName string
    region string
    Region code.
    id str
    The provider-assigned unique ID for this managed resource.
    images Sequence[GetCloudInstanceImagesImage]
    Images advertised by the backend for this project, one entry per region the image is offered in:
    service_name str
    region str
    Region code.
    id String
    The provider-assigned unique ID for this managed resource.
    images List<Property Map>
    Images advertised by the backend for this project, one entry per region the image is offered in:
    serviceName String
    region String
    Region code.

    Supporting Types

    GetCloudInstanceImagesImage

    CreatedAt string
    Timestamp at which the image was created on the backend, in RFC 3339 format.
    Id string
    The OpenStack/Glance image ID. Stable within a region and used to reference the image when creating an instance.
    Location GetCloudInstanceImagesImageLocation
    Region (and, where applicable, availability zone) where this image is offered. The image catalog is per-region: an image returned for one region is not guaranteed to exist in another:
    MinDisk int
    Minimum root disk size, in GB, that an instance must provide to boot from this image. A flavor whose disk is smaller than this value cannot be used with the image.
    MinRam int
    Minimum amount of memory, in MB, that an instance must provide to boot from this image. A flavor whose RAM is below this value cannot be used with the image.
    Name string
    Display name of the image as reported by the backend (for example the distribution and version, such as Debian 12).
    Size int
    Size of the image on the backend, expressed in bytes.
    Status string
    Availability status of the image as reported by the backend. Only images in an active status can be used to create an instance.
    UpdatedAt string
    Timestamp of the last modification of the image on the backend, in RFC 3339 format.
    Visibility string
    Visibility scope of the image, for example whether it is a public OVHcloud-provided image or private to the project.
    CreatedAt string
    Timestamp at which the image was created on the backend, in RFC 3339 format.
    Id string
    The OpenStack/Glance image ID. Stable within a region and used to reference the image when creating an instance.
    Location GetCloudInstanceImagesImageLocation
    Region (and, where applicable, availability zone) where this image is offered. The image catalog is per-region: an image returned for one region is not guaranteed to exist in another:
    MinDisk int
    Minimum root disk size, in GB, that an instance must provide to boot from this image. A flavor whose disk is smaller than this value cannot be used with the image.
    MinRam int
    Minimum amount of memory, in MB, that an instance must provide to boot from this image. A flavor whose RAM is below this value cannot be used with the image.
    Name string
    Display name of the image as reported by the backend (for example the distribution and version, such as Debian 12).
    Size int
    Size of the image on the backend, expressed in bytes.
    Status string
    Availability status of the image as reported by the backend. Only images in an active status can be used to create an instance.
    UpdatedAt string
    Timestamp of the last modification of the image on the backend, in RFC 3339 format.
    Visibility string
    Visibility scope of the image, for example whether it is a public OVHcloud-provided image or private to the project.
    created_at string
    Timestamp at which the image was created on the backend, in RFC 3339 format.
    id string
    The OpenStack/Glance image ID. Stable within a region and used to reference the image when creating an instance.
    location object
    Region (and, where applicable, availability zone) where this image is offered. The image catalog is per-region: an image returned for one region is not guaranteed to exist in another:
    min_disk number
    Minimum root disk size, in GB, that an instance must provide to boot from this image. A flavor whose disk is smaller than this value cannot be used with the image.
    min_ram number
    Minimum amount of memory, in MB, that an instance must provide to boot from this image. A flavor whose RAM is below this value cannot be used with the image.
    name string
    Display name of the image as reported by the backend (for example the distribution and version, such as Debian 12).
    size number
    Size of the image on the backend, expressed in bytes.
    status string
    Availability status of the image as reported by the backend. Only images in an active status can be used to create an instance.
    updated_at string
    Timestamp of the last modification of the image on the backend, in RFC 3339 format.
    visibility string
    Visibility scope of the image, for example whether it is a public OVHcloud-provided image or private to the project.
    createdAt String
    Timestamp at which the image was created on the backend, in RFC 3339 format.
    id String
    The OpenStack/Glance image ID. Stable within a region and used to reference the image when creating an instance.
    location GetCloudInstanceImagesImageLocation
    Region (and, where applicable, availability zone) where this image is offered. The image catalog is per-region: an image returned for one region is not guaranteed to exist in another:
    minDisk Integer
    Minimum root disk size, in GB, that an instance must provide to boot from this image. A flavor whose disk is smaller than this value cannot be used with the image.
    minRam Integer
    Minimum amount of memory, in MB, that an instance must provide to boot from this image. A flavor whose RAM is below this value cannot be used with the image.
    name String
    Display name of the image as reported by the backend (for example the distribution and version, such as Debian 12).
    size Integer
    Size of the image on the backend, expressed in bytes.
    status String
    Availability status of the image as reported by the backend. Only images in an active status can be used to create an instance.
    updatedAt String
    Timestamp of the last modification of the image on the backend, in RFC 3339 format.
    visibility String
    Visibility scope of the image, for example whether it is a public OVHcloud-provided image or private to the project.
    createdAt string
    Timestamp at which the image was created on the backend, in RFC 3339 format.
    id string
    The OpenStack/Glance image ID. Stable within a region and used to reference the image when creating an instance.
    location GetCloudInstanceImagesImageLocation
    Region (and, where applicable, availability zone) where this image is offered. The image catalog is per-region: an image returned for one region is not guaranteed to exist in another:
    minDisk number
    Minimum root disk size, in GB, that an instance must provide to boot from this image. A flavor whose disk is smaller than this value cannot be used with the image.
    minRam number
    Minimum amount of memory, in MB, that an instance must provide to boot from this image. A flavor whose RAM is below this value cannot be used with the image.
    name string
    Display name of the image as reported by the backend (for example the distribution and version, such as Debian 12).
    size number
    Size of the image on the backend, expressed in bytes.
    status string
    Availability status of the image as reported by the backend. Only images in an active status can be used to create an instance.
    updatedAt string
    Timestamp of the last modification of the image on the backend, in RFC 3339 format.
    visibility string
    Visibility scope of the image, for example whether it is a public OVHcloud-provided image or private to the project.
    created_at str
    Timestamp at which the image was created on the backend, in RFC 3339 format.
    id str
    The OpenStack/Glance image ID. Stable within a region and used to reference the image when creating an instance.
    location GetCloudInstanceImagesImageLocation
    Region (and, where applicable, availability zone) where this image is offered. The image catalog is per-region: an image returned for one region is not guaranteed to exist in another:
    min_disk int
    Minimum root disk size, in GB, that an instance must provide to boot from this image. A flavor whose disk is smaller than this value cannot be used with the image.
    min_ram int
    Minimum amount of memory, in MB, that an instance must provide to boot from this image. A flavor whose RAM is below this value cannot be used with the image.
    name str
    Display name of the image as reported by the backend (for example the distribution and version, such as Debian 12).
    size int
    Size of the image on the backend, expressed in bytes.
    status str
    Availability status of the image as reported by the backend. Only images in an active status can be used to create an instance.
    updated_at str
    Timestamp of the last modification of the image on the backend, in RFC 3339 format.
    visibility str
    Visibility scope of the image, for example whether it is a public OVHcloud-provided image or private to the project.
    createdAt String
    Timestamp at which the image was created on the backend, in RFC 3339 format.
    id String
    The OpenStack/Glance image ID. Stable within a region and used to reference the image when creating an instance.
    location Property Map
    Region (and, where applicable, availability zone) where this image is offered. The image catalog is per-region: an image returned for one region is not guaranteed to exist in another:
    minDisk Number
    Minimum root disk size, in GB, that an instance must provide to boot from this image. A flavor whose disk is smaller than this value cannot be used with the image.
    minRam Number
    Minimum amount of memory, in MB, that an instance must provide to boot from this image. A flavor whose RAM is below this value cannot be used with the image.
    name String
    Display name of the image as reported by the backend (for example the distribution and version, such as Debian 12).
    size Number
    Size of the image on the backend, expressed in bytes.
    status String
    Availability status of the image as reported by the backend. Only images in an active status can be used to create an instance.
    updatedAt String
    Timestamp of the last modification of the image on the backend, in RFC 3339 format.
    visibility String
    Visibility scope of the image, for example whether it is a public OVHcloud-provided image or private to the project.

    GetCloudInstanceImagesImageLocation

    AvailabilityZone string
    Availability zone within the region.
    Region string
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    AvailabilityZone string
    Availability zone within the region.
    Region string
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    availability_zone string
    Availability zone within the region.
    region string
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    availabilityZone String
    Availability zone within the region.
    region String
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    availabilityZone string
    Availability zone within the region.
    region string
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    availability_zone str
    Availability zone within the region.
    region str
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.
    availabilityZone String
    Availability zone within the region.
    region String
    Restrict the listing to the images offered in this region. The catalog is per-region: an image returned for one region is not guaranteed to exist in another.

    Package Details

    Repository
    ovh ovh/pulumi-ovh
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the ovh Terraform Provider.
    ovh logo
    Viewing docs for OVHCloud v2.19.1
    published on Tuesday, Aug 18, 2026 by OVHcloud

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial