1. Packages
  2. Vkcs Provider
  3. API Docs
  4. ImagesImage
vkcs 0.9.3 published on Tuesday, Apr 15, 2025 by vk-cs

vkcs.ImagesImage

Explore with Pulumi AI

vkcs logo
vkcs 0.9.3 published on Tuesday, Apr 15, 2025 by vk-cs

    Manages an Image resource within VKCS.

    Note: All arguments including the source image URL password will be stored in the raw state as plain-text. Read more about sensitive data in state.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as vkcs from "@pulumi/vkcs";
    
    const eurolinux9 = new vkcs.ImagesImage("eurolinux9", {
        compressionFormat: "xz",
        containerFormat: "bare",
        diskFormat: "raw",
        imageSourceUrl: "https://fbi.cdn.euro-linux.com/images/EL-9-cloudgeneric-2023-03-19.raw.xz",
        minDiskGb: 10,
        minRamMb: 1536,
        properties: {
            hw_qemu_guest_agent: "yes",
            mcs_name: "EuroLinux 9",
            mcs_os_distro: "eurolinux",
            mcs_os_version: "9",
            os_admin_user: "root",
            os_require_quiesce: "yes",
            os_type: "linux",
        },
        tags: ["tf-example"],
    });
    
    import pulumi
    import pulumi_vkcs as vkcs
    
    eurolinux9 = vkcs.ImagesImage("eurolinux9",
        compression_format="xz",
        container_format="bare",
        disk_format="raw",
        image_source_url="https://fbi.cdn.euro-linux.com/images/EL-9-cloudgeneric-2023-03-19.raw.xz",
        min_disk_gb=10,
        min_ram_mb=1536,
        properties={
            "hw_qemu_guest_agent": "yes",
            "mcs_name": "EuroLinux 9",
            "mcs_os_distro": "eurolinux",
            "mcs_os_version": "9",
            "os_admin_user": "root",
            "os_require_quiesce": "yes",
            "os_type": "linux",
        },
        tags=["tf-example"])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/vkcs/vkcs"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := vkcs.NewImagesImage(ctx, "eurolinux9", &vkcs.ImagesImageArgs{
    			CompressionFormat: pulumi.String("xz"),
    			ContainerFormat:   pulumi.String("bare"),
    			DiskFormat:        pulumi.String("raw"),
    			ImageSourceUrl:    pulumi.String("https://fbi.cdn.euro-linux.com/images/EL-9-cloudgeneric-2023-03-19.raw.xz"),
    			MinDiskGb:         pulumi.Float64(10),
    			MinRamMb:          pulumi.Float64(1536),
    			Properties: pulumi.StringMap{
    				"hw_qemu_guest_agent": pulumi.String("yes"),
    				"mcs_name":            pulumi.String("EuroLinux 9"),
    				"mcs_os_distro":       pulumi.String("eurolinux"),
    				"mcs_os_version":      pulumi.String("9"),
    				"os_admin_user":       pulumi.String("root"),
    				"os_require_quiesce":  pulumi.String("yes"),
    				"os_type":             pulumi.String("linux"),
    			},
    			Tags: pulumi.StringArray{
    				pulumi.String("tf-example"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Vkcs = Pulumi.Vkcs;
    
    return await Deployment.RunAsync(() => 
    {
        var eurolinux9 = new Vkcs.ImagesImage("eurolinux9", new()
        {
            CompressionFormat = "xz",
            ContainerFormat = "bare",
            DiskFormat = "raw",
            ImageSourceUrl = "https://fbi.cdn.euro-linux.com/images/EL-9-cloudgeneric-2023-03-19.raw.xz",
            MinDiskGb = 10,
            MinRamMb = 1536,
            Properties = 
            {
                { "hw_qemu_guest_agent", "yes" },
                { "mcs_name", "EuroLinux 9" },
                { "mcs_os_distro", "eurolinux" },
                { "mcs_os_version", "9" },
                { "os_admin_user", "root" },
                { "os_require_quiesce", "yes" },
                { "os_type", "linux" },
            },
            Tags = new[]
            {
                "tf-example",
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.vkcs.ImagesImage;
    import com.pulumi.vkcs.ImagesImageArgs;
    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) {
            var eurolinux9 = new ImagesImage("eurolinux9", ImagesImageArgs.builder()
                .compressionFormat("xz")
                .containerFormat("bare")
                .diskFormat("raw")
                .imageSourceUrl("https://fbi.cdn.euro-linux.com/images/EL-9-cloudgeneric-2023-03-19.raw.xz")
                .minDiskGb(10)
                .minRamMb(1536)
                .properties(Map.ofEntries(
                    Map.entry("hw_qemu_guest_agent", "yes"),
                    Map.entry("mcs_name", "EuroLinux 9"),
                    Map.entry("mcs_os_distro", "eurolinux"),
                    Map.entry("mcs_os_version", "9"),
                    Map.entry("os_admin_user", "root"),
                    Map.entry("os_require_quiesce", "yes"),
                    Map.entry("os_type", "linux")
                ))
                .tags("tf-example")
                .build());
    
        }
    }
    
    resources:
      eurolinux9:
        type: vkcs:ImagesImage
        properties:
          # compression_format should be set for compressed image source.
          compressionFormat: xz
          containerFormat: bare
          diskFormat: raw
          imageSourceUrl: https://fbi.cdn.euro-linux.com/images/EL-9-cloudgeneric-2023-03-19.raw.xz
          minDiskGb: 10
          # Minimal requirements from image vendor.
          #     // Should be set to prevent VKCS to build VM on lesser resources.
          minRamMb: 1536
          properties:
            hw_qemu_guest_agent: yes
            mcs_name: EuroLinux 9
            mcs_os_distro: eurolinux
            mcs_os_version: '9'
            os_admin_user: root
            os_require_quiesce: yes
            os_type: linux
          # Use tags to organize your images.
          tags:
            - tf-example
    

    Notes

    Properties

    See the following reference for important supported properties.

    This resource supports the ability to add properties to a resource during creation as well as add, update, and delete properties during an update of this resource.

    VKCS Image service is adding some read-only properties (such as direct_url, store) to each image. This resource automatically reconciles these properties with the user-provided properties.

    Create ImagesImage Resource

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

    Constructor syntax

    new ImagesImage(name: string, args: ImagesImageArgs, opts?: CustomResourceOptions);
    @overload
    def ImagesImage(resource_name: str,
                    args: ImagesImageArgs,
                    opts: Optional[ResourceOptions] = None)
    
    @overload
    def ImagesImage(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    container_format: Optional[str] = None,
                    disk_format: Optional[str] = None,
                    min_disk_gb: Optional[float] = None,
                    min_ram_mb: Optional[float] = None,
                    image_cache_path: Optional[str] = None,
                    image_source_password: Optional[str] = None,
                    image_source_url: Optional[str] = None,
                    image_source_username: Optional[str] = None,
                    images_image_id: Optional[str] = None,
                    local_file_path: Optional[str] = None,
                    archiving_format: Optional[str] = None,
                    compression_format: Optional[str] = None,
                    name: Optional[str] = None,
                    properties: Optional[Mapping[str, str]] = None,
                    protected: Optional[bool] = None,
                    region: Optional[str] = None,
                    tags: Optional[Sequence[str]] = None,
                    timeouts: Optional[ImagesImageTimeoutsArgs] = None,
                    verify_checksum: Optional[bool] = None,
                    visibility: Optional[str] = None)
    func NewImagesImage(ctx *Context, name string, args ImagesImageArgs, opts ...ResourceOption) (*ImagesImage, error)
    public ImagesImage(string name, ImagesImageArgs args, CustomResourceOptions? opts = null)
    public ImagesImage(String name, ImagesImageArgs args)
    public ImagesImage(String name, ImagesImageArgs args, CustomResourceOptions options)
    
    type: vkcs:ImagesImage
    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 ImagesImageArgs
    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 ImagesImageArgs
    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 ImagesImageArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ImagesImageArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ImagesImageArgs
    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 imagesImageResource = new Vkcs.ImagesImage("imagesImageResource", new()
    {
        ContainerFormat = "string",
        DiskFormat = "string",
        MinDiskGb = 0,
        MinRamMb = 0,
        ImageCachePath = "string",
        ImageSourcePassword = "string",
        ImageSourceUrl = "string",
        ImageSourceUsername = "string",
        ImagesImageId = "string",
        LocalFilePath = "string",
        ArchivingFormat = "string",
        CompressionFormat = "string",
        Name = "string",
        Properties = 
        {
            { "string", "string" },
        },
        Protected = false,
        Region = "string",
        Tags = new[]
        {
            "string",
        },
        Timeouts = new Vkcs.Inputs.ImagesImageTimeoutsArgs
        {
            Create = "string",
        },
        VerifyChecksum = false,
        Visibility = "string",
    });
    
    example, err := vkcs.NewImagesImage(ctx, "imagesImageResource", &vkcs.ImagesImageArgs{
    	ContainerFormat:     pulumi.String("string"),
    	DiskFormat:          pulumi.String("string"),
    	MinDiskGb:           pulumi.Float64(0),
    	MinRamMb:            pulumi.Float64(0),
    	ImageCachePath:      pulumi.String("string"),
    	ImageSourcePassword: pulumi.String("string"),
    	ImageSourceUrl:      pulumi.String("string"),
    	ImageSourceUsername: pulumi.String("string"),
    	ImagesImageId:       pulumi.String("string"),
    	LocalFilePath:       pulumi.String("string"),
    	ArchivingFormat:     pulumi.String("string"),
    	CompressionFormat:   pulumi.String("string"),
    	Name:                pulumi.String("string"),
    	Properties: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	Protected: pulumi.Bool(false),
    	Region:    pulumi.String("string"),
    	Tags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Timeouts: &vkcs.ImagesImageTimeoutsArgs{
    		Create: pulumi.String("string"),
    	},
    	VerifyChecksum: pulumi.Bool(false),
    	Visibility:     pulumi.String("string"),
    })
    
    var imagesImageResource = new ImagesImage("imagesImageResource", ImagesImageArgs.builder()
        .containerFormat("string")
        .diskFormat("string")
        .minDiskGb(0)
        .minRamMb(0)
        .imageCachePath("string")
        .imageSourcePassword("string")
        .imageSourceUrl("string")
        .imageSourceUsername("string")
        .imagesImageId("string")
        .localFilePath("string")
        .archivingFormat("string")
        .compressionFormat("string")
        .name("string")
        .properties(Map.of("string", "string"))
        .protected_(false)
        .region("string")
        .tags("string")
        .timeouts(ImagesImageTimeoutsArgs.builder()
            .create("string")
            .build())
        .verifyChecksum(false)
        .visibility("string")
        .build());
    
    images_image_resource = vkcs.ImagesImage("imagesImageResource",
        container_format="string",
        disk_format="string",
        min_disk_gb=0,
        min_ram_mb=0,
        image_cache_path="string",
        image_source_password="string",
        image_source_url="string",
        image_source_username="string",
        images_image_id="string",
        local_file_path="string",
        archiving_format="string",
        compression_format="string",
        name="string",
        properties={
            "string": "string",
        },
        protected=False,
        region="string",
        tags=["string"],
        timeouts={
            "create": "string",
        },
        verify_checksum=False,
        visibility="string")
    
    const imagesImageResource = new vkcs.ImagesImage("imagesImageResource", {
        containerFormat: "string",
        diskFormat: "string",
        minDiskGb: 0,
        minRamMb: 0,
        imageCachePath: "string",
        imageSourcePassword: "string",
        imageSourceUrl: "string",
        imageSourceUsername: "string",
        imagesImageId: "string",
        localFilePath: "string",
        archivingFormat: "string",
        compressionFormat: "string",
        name: "string",
        properties: {
            string: "string",
        },
        "protected": false,
        region: "string",
        tags: ["string"],
        timeouts: {
            create: "string",
        },
        verifyChecksum: false,
        visibility: "string",
    });
    
    type: vkcs:ImagesImage
    properties:
        archivingFormat: string
        compressionFormat: string
        containerFormat: string
        diskFormat: string
        imageCachePath: string
        imageSourcePassword: string
        imageSourceUrl: string
        imageSourceUsername: string
        imagesImageId: string
        localFilePath: string
        minDiskGb: 0
        minRamMb: 0
        name: string
        properties:
            string: string
        protected: false
        region: string
        tags:
            - string
        timeouts:
            create: string
        verifyChecksum: false
        visibility: string
    

    ImagesImage 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 ImagesImage resource accepts the following input properties:

    ContainerFormat string
    required string → The container format. Must be one of "bare".
    DiskFormat string
    required string → The disk format. Must be one of "raw", "iso".
    ArchivingFormat string
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    CompressionFormat string
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    ImageCachePath string
    ImageSourcePassword string
    optional sensitive string → The password of basic auth to download image_source_url.
    ImageSourceUrl string
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    ImageSourceUsername string
    optional string → The username of basic auth to download image_source_url.
    ImagesImageId string
    string → ID of the resource.
    LocalFilePath string
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    MinDiskGb double
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    MinRamMb double
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    Name string
    required string → The name of the image.
    Properties Dictionary<string, string>
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    Protected bool
    optional boolean → If true, image will not be deletable. Defaults to false.
    Region string
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    Tags List<string>
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    Timeouts ImagesImageTimeouts
    VerifyChecksum bool
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    Visibility string
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.
    ContainerFormat string
    required string → The container format. Must be one of "bare".
    DiskFormat string
    required string → The disk format. Must be one of "raw", "iso".
    ArchivingFormat string
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    CompressionFormat string
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    ImageCachePath string
    ImageSourcePassword string
    optional sensitive string → The password of basic auth to download image_source_url.
    ImageSourceUrl string
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    ImageSourceUsername string
    optional string → The username of basic auth to download image_source_url.
    ImagesImageId string
    string → ID of the resource.
    LocalFilePath string
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    MinDiskGb float64
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    MinRamMb float64
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    Name string
    required string → The name of the image.
    Properties map[string]string
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    Protected bool
    optional boolean → If true, image will not be deletable. Defaults to false.
    Region string
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    Tags []string
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    Timeouts ImagesImageTimeoutsArgs
    VerifyChecksum bool
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    Visibility string
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.
    containerFormat String
    required string → The container format. Must be one of "bare".
    diskFormat String
    required string → The disk format. Must be one of "raw", "iso".
    archivingFormat String
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    compressionFormat String
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    imageCachePath String
    imageSourcePassword String
    optional sensitive string → The password of basic auth to download image_source_url.
    imageSourceUrl String
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    imageSourceUsername String
    optional string → The username of basic auth to download image_source_url.
    imagesImageId String
    string → ID of the resource.
    localFilePath String
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    minDiskGb Double
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    minRamMb Double
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    name String
    required string → The name of the image.
    properties Map<String,String>
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    protected_ Boolean
    optional boolean → If true, image will not be deletable. Defaults to false.
    region String
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    tags List<String>
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    timeouts ImagesImageTimeouts
    verifyChecksum Boolean
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    visibility String
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.
    containerFormat string
    required string → The container format. Must be one of "bare".
    diskFormat string
    required string → The disk format. Must be one of "raw", "iso".
    archivingFormat string
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    compressionFormat string
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    imageCachePath string
    imageSourcePassword string
    optional sensitive string → The password of basic auth to download image_source_url.
    imageSourceUrl string
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    imageSourceUsername string
    optional string → The username of basic auth to download image_source_url.
    imagesImageId string
    string → ID of the resource.
    localFilePath string
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    minDiskGb number
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    minRamMb number
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    name string
    required string → The name of the image.
    properties {[key: string]: string}
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    protected boolean
    optional boolean → If true, image will not be deletable. Defaults to false.
    region string
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    tags string[]
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    timeouts ImagesImageTimeouts
    verifyChecksum boolean
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    visibility string
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.
    container_format str
    required string → The container format. Must be one of "bare".
    disk_format str
    required string → The disk format. Must be one of "raw", "iso".
    archiving_format str
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    compression_format str
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    image_cache_path str
    image_source_password str
    optional sensitive string → The password of basic auth to download image_source_url.
    image_source_url str
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    image_source_username str
    optional string → The username of basic auth to download image_source_url.
    images_image_id str
    string → ID of the resource.
    local_file_path str
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    min_disk_gb float
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    min_ram_mb float
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    name str
    required string → The name of the image.
    properties Mapping[str, str]
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    protected bool
    optional boolean → If true, image will not be deletable. Defaults to false.
    region str
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    tags Sequence[str]
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    timeouts ImagesImageTimeoutsArgs
    verify_checksum bool
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    visibility str
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.
    containerFormat String
    required string → The container format. Must be one of "bare".
    diskFormat String
    required string → The disk format. Must be one of "raw", "iso".
    archivingFormat String
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    compressionFormat String
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    imageCachePath String
    imageSourcePassword String
    optional sensitive string → The password of basic auth to download image_source_url.
    imageSourceUrl String
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    imageSourceUsername String
    optional string → The username of basic auth to download image_source_url.
    imagesImageId String
    string → ID of the resource.
    localFilePath String
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    minDiskGb Number
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    minRamMb Number
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    name String
    required string → The name of the image.
    properties Map<String>
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    protected Boolean
    optional boolean → If true, image will not be deletable. Defaults to false.
    region String
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    tags List<String>
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    timeouts Property Map
    verifyChecksum Boolean
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    visibility String
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.

    Outputs

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

    Checksum string
    string → The checksum of the data associated with the image.
    CreatedAt string
    string → The date the image was created.
    File string
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    Id string
    The provider-assigned unique ID for this managed resource.
    Metadata Dictionary<string, string>
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    Owner string
    string → The id of the vkcs user who owns the image.
    Schema string
    string → The path to the JSON-schema that represent the image or image
    SizeBytes double
    number → The size in bytes of the data associated with the image.
    Status string
    string → The status of the image. It can be "queued", "active" or "saving".
    UpdatedAt string
    string → The date the image was last updated.
    Checksum string
    string → The checksum of the data associated with the image.
    CreatedAt string
    string → The date the image was created.
    File string
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    Id string
    The provider-assigned unique ID for this managed resource.
    Metadata map[string]string
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    Owner string
    string → The id of the vkcs user who owns the image.
    Schema string
    string → The path to the JSON-schema that represent the image or image
    SizeBytes float64
    number → The size in bytes of the data associated with the image.
    Status string
    string → The status of the image. It can be "queued", "active" or "saving".
    UpdatedAt string
    string → The date the image was last updated.
    checksum String
    string → The checksum of the data associated with the image.
    createdAt String
    string → The date the image was created.
    file String
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    id String
    The provider-assigned unique ID for this managed resource.
    metadata Map<String,String>
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    owner String
    string → The id of the vkcs user who owns the image.
    schema String
    string → The path to the JSON-schema that represent the image or image
    sizeBytes Double
    number → The size in bytes of the data associated with the image.
    status String
    string → The status of the image. It can be "queued", "active" or "saving".
    updatedAt String
    string → The date the image was last updated.
    checksum string
    string → The checksum of the data associated with the image.
    createdAt string
    string → The date the image was created.
    file string
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    id string
    The provider-assigned unique ID for this managed resource.
    metadata {[key: string]: string}
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    owner string
    string → The id of the vkcs user who owns the image.
    schema string
    string → The path to the JSON-schema that represent the image or image
    sizeBytes number
    number → The size in bytes of the data associated with the image.
    status string
    string → The status of the image. It can be "queued", "active" or "saving".
    updatedAt string
    string → The date the image was last updated.
    checksum str
    string → The checksum of the data associated with the image.
    created_at str
    string → The date the image was created.
    file str
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    id str
    The provider-assigned unique ID for this managed resource.
    metadata Mapping[str, str]
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    owner str
    string → The id of the vkcs user who owns the image.
    schema str
    string → The path to the JSON-schema that represent the image or image
    size_bytes float
    number → The size in bytes of the data associated with the image.
    status str
    string → The status of the image. It can be "queued", "active" or "saving".
    updated_at str
    string → The date the image was last updated.
    checksum String
    string → The checksum of the data associated with the image.
    createdAt String
    string → The date the image was created.
    file String
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    id String
    The provider-assigned unique ID for this managed resource.
    metadata Map<String>
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    owner String
    string → The id of the vkcs user who owns the image.
    schema String
    string → The path to the JSON-schema that represent the image or image
    sizeBytes Number
    number → The size in bytes of the data associated with the image.
    status String
    string → The status of the image. It can be "queued", "active" or "saving".
    updatedAt String
    string → The date the image was last updated.

    Look up Existing ImagesImage Resource

    Get an existing ImagesImage 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?: ImagesImageState, opts?: CustomResourceOptions): ImagesImage
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            archiving_format: Optional[str] = None,
            checksum: Optional[str] = None,
            compression_format: Optional[str] = None,
            container_format: Optional[str] = None,
            created_at: Optional[str] = None,
            disk_format: Optional[str] = None,
            file: Optional[str] = None,
            image_cache_path: Optional[str] = None,
            image_source_password: Optional[str] = None,
            image_source_url: Optional[str] = None,
            image_source_username: Optional[str] = None,
            images_image_id: Optional[str] = None,
            local_file_path: Optional[str] = None,
            metadata: Optional[Mapping[str, str]] = None,
            min_disk_gb: Optional[float] = None,
            min_ram_mb: Optional[float] = None,
            name: Optional[str] = None,
            owner: Optional[str] = None,
            properties: Optional[Mapping[str, str]] = None,
            protected: Optional[bool] = None,
            region: Optional[str] = None,
            schema: Optional[str] = None,
            size_bytes: Optional[float] = None,
            status: Optional[str] = None,
            tags: Optional[Sequence[str]] = None,
            timeouts: Optional[ImagesImageTimeoutsArgs] = None,
            updated_at: Optional[str] = None,
            verify_checksum: Optional[bool] = None,
            visibility: Optional[str] = None) -> ImagesImage
    func GetImagesImage(ctx *Context, name string, id IDInput, state *ImagesImageState, opts ...ResourceOption) (*ImagesImage, error)
    public static ImagesImage Get(string name, Input<string> id, ImagesImageState? state, CustomResourceOptions? opts = null)
    public static ImagesImage get(String name, Output<String> id, ImagesImageState state, CustomResourceOptions options)
    resources:  _:    type: vkcs:ImagesImage    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:
    ArchivingFormat string
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    Checksum string
    string → The checksum of the data associated with the image.
    CompressionFormat string
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    ContainerFormat string
    required string → The container format. Must be one of "bare".
    CreatedAt string
    string → The date the image was created.
    DiskFormat string
    required string → The disk format. Must be one of "raw", "iso".
    File string
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    ImageCachePath string
    ImageSourcePassword string
    optional sensitive string → The password of basic auth to download image_source_url.
    ImageSourceUrl string
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    ImageSourceUsername string
    optional string → The username of basic auth to download image_source_url.
    ImagesImageId string
    string → ID of the resource.
    LocalFilePath string
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    Metadata Dictionary<string, string>
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    MinDiskGb double
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    MinRamMb double
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    Name string
    required string → The name of the image.
    Owner string
    string → The id of the vkcs user who owns the image.
    Properties Dictionary<string, string>
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    Protected bool
    optional boolean → If true, image will not be deletable. Defaults to false.
    Region string
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    Schema string
    string → The path to the JSON-schema that represent the image or image
    SizeBytes double
    number → The size in bytes of the data associated with the image.
    Status string
    string → The status of the image. It can be "queued", "active" or "saving".
    Tags List<string>
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    Timeouts ImagesImageTimeouts
    UpdatedAt string
    string → The date the image was last updated.
    VerifyChecksum bool
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    Visibility string
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.
    ArchivingFormat string
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    Checksum string
    string → The checksum of the data associated with the image.
    CompressionFormat string
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    ContainerFormat string
    required string → The container format. Must be one of "bare".
    CreatedAt string
    string → The date the image was created.
    DiskFormat string
    required string → The disk format. Must be one of "raw", "iso".
    File string
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    ImageCachePath string
    ImageSourcePassword string
    optional sensitive string → The password of basic auth to download image_source_url.
    ImageSourceUrl string
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    ImageSourceUsername string
    optional string → The username of basic auth to download image_source_url.
    ImagesImageId string
    string → ID of the resource.
    LocalFilePath string
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    Metadata map[string]string
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    MinDiskGb float64
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    MinRamMb float64
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    Name string
    required string → The name of the image.
    Owner string
    string → The id of the vkcs user who owns the image.
    Properties map[string]string
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    Protected bool
    optional boolean → If true, image will not be deletable. Defaults to false.
    Region string
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    Schema string
    string → The path to the JSON-schema that represent the image or image
    SizeBytes float64
    number → The size in bytes of the data associated with the image.
    Status string
    string → The status of the image. It can be "queued", "active" or "saving".
    Tags []string
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    Timeouts ImagesImageTimeoutsArgs
    UpdatedAt string
    string → The date the image was last updated.
    VerifyChecksum bool
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    Visibility string
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.
    archivingFormat String
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    checksum String
    string → The checksum of the data associated with the image.
    compressionFormat String
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    containerFormat String
    required string → The container format. Must be one of "bare".
    createdAt String
    string → The date the image was created.
    diskFormat String
    required string → The disk format. Must be one of "raw", "iso".
    file String
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    imageCachePath String
    imageSourcePassword String
    optional sensitive string → The password of basic auth to download image_source_url.
    imageSourceUrl String
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    imageSourceUsername String
    optional string → The username of basic auth to download image_source_url.
    imagesImageId String
    string → ID of the resource.
    localFilePath String
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    metadata Map<String,String>
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    minDiskGb Double
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    minRamMb Double
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    name String
    required string → The name of the image.
    owner String
    string → The id of the vkcs user who owns the image.
    properties Map<String,String>
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    protected_ Boolean
    optional boolean → If true, image will not be deletable. Defaults to false.
    region String
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    schema String
    string → The path to the JSON-schema that represent the image or image
    sizeBytes Double
    number → The size in bytes of the data associated with the image.
    status String
    string → The status of the image. It can be "queued", "active" or "saving".
    tags List<String>
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    timeouts ImagesImageTimeouts
    updatedAt String
    string → The date the image was last updated.
    verifyChecksum Boolean
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    visibility String
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.
    archivingFormat string
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    checksum string
    string → The checksum of the data associated with the image.
    compressionFormat string
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    containerFormat string
    required string → The container format. Must be one of "bare".
    createdAt string
    string → The date the image was created.
    diskFormat string
    required string → The disk format. Must be one of "raw", "iso".
    file string
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    imageCachePath string
    imageSourcePassword string
    optional sensitive string → The password of basic auth to download image_source_url.
    imageSourceUrl string
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    imageSourceUsername string
    optional string → The username of basic auth to download image_source_url.
    imagesImageId string
    string → ID of the resource.
    localFilePath string
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    metadata {[key: string]: string}
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    minDiskGb number
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    minRamMb number
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    name string
    required string → The name of the image.
    owner string
    string → The id of the vkcs user who owns the image.
    properties {[key: string]: string}
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    protected boolean
    optional boolean → If true, image will not be deletable. Defaults to false.
    region string
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    schema string
    string → The path to the JSON-schema that represent the image or image
    sizeBytes number
    number → The size in bytes of the data associated with the image.
    status string
    string → The status of the image. It can be "queued", "active" or "saving".
    tags string[]
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    timeouts ImagesImageTimeouts
    updatedAt string
    string → The date the image was last updated.
    verifyChecksum boolean
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    visibility string
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.
    archiving_format str
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    checksum str
    string → The checksum of the data associated with the image.
    compression_format str
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    container_format str
    required string → The container format. Must be one of "bare".
    created_at str
    string → The date the image was created.
    disk_format str
    required string → The disk format. Must be one of "raw", "iso".
    file str
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    image_cache_path str
    image_source_password str
    optional sensitive string → The password of basic auth to download image_source_url.
    image_source_url str
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    image_source_username str
    optional string → The username of basic auth to download image_source_url.
    images_image_id str
    string → ID of the resource.
    local_file_path str
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    metadata Mapping[str, str]
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    min_disk_gb float
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    min_ram_mb float
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    name str
    required string → The name of the image.
    owner str
    string → The id of the vkcs user who owns the image.
    properties Mapping[str, str]
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    protected bool
    optional boolean → If true, image will not be deletable. Defaults to false.
    region str
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    schema str
    string → The path to the JSON-schema that represent the image or image
    size_bytes float
    number → The size in bytes of the data associated with the image.
    status str
    string → The status of the image. It can be "queued", "active" or "saving".
    tags Sequence[str]
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    timeouts ImagesImageTimeoutsArgs
    updated_at str
    string → The date the image was last updated.
    verify_checksum bool
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    visibility str
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.
    archivingFormat String
    optional string → The format of archived image file. Use this to unzip image file when downloading an archive. Currently only "tar" format is supported.New since v0.4.2.
    checksum String
    string → The checksum of the data associated with the image.
    compressionFormat String
    optional string → The format of compressed image. Use this attribute to decompress image when downloading it from source. Must be one of "auto", "bzip2", "gzip", "xz". If set to "auto", response Content-Type header will be used to detect compression format.New since v0.4.2.
    containerFormat String
    required string → The container format. Must be one of "bare".
    createdAt String
    string → The date the image was created.
    diskFormat String
    required string → The disk format. Must be one of "raw", "iso".
    file String
    string → The trailing path after the image endpoint that represent the location of the image or the path to retrieve it.
    imageCachePath String
    imageSourcePassword String
    optional sensitive string → The password of basic auth to download image_source_url.
    imageSourceUrl String
    optional string → This is the url of the raw image. The image will be downloaded in the image_cache_path before being uploaded to VKCS. Conflicts with local_file_path.
    imageSourceUsername String
    optional string → The username of basic auth to download image_source_url.
    imagesImageId String
    string → ID of the resource.
    localFilePath String
    optional string → This is the filepath of the raw image file that will be uploaded to VKCS. Conflicts with image_source_url
    metadata Map<String>
    map of string → The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
    minDiskGb Number
    optional number → Amount of disk space (in GB) required to boot VM. Defaults to 0.
    minRamMb Number
    optional number → Amount of ram (in MB) required to boot VM. Defauts to 0.
    name String
    required string → The name of the image.
    owner String
    string → The id of the vkcs user who owns the image.
    properties Map<String>
    optional map of string → A map of key/value pairs to set freeform information about an image. See the "Notes" section for further information about properties.
    protected Boolean
    optional boolean → If true, image will not be deletable. Defaults to false.
    region String
    optional string → The region in which to obtain the Image client. An Image client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used. Changing this creates a new Image.
    schema String
    string → The path to the JSON-schema that represent the image or image
    sizeBytes Number
    number → The size in bytes of the data associated with the image.
    status String
    string → The status of the image. It can be "queued", "active" or "saving".
    tags List<String>
    optional set of string → The tags of the image. It must be a list of strings. At this time, it is not possible to delete all tags of an image.
    timeouts Property Map
    updatedAt String
    string → The date the image was last updated.
    verifyChecksum Boolean
    optional boolean → If false, the checksum will not be verified once the image is finished uploading.
    visibility String
    optional string → The visibility of the image. Must be one of "private", "community", or "shared". The ability to set the visibility depends upon the configuration of the VKCS cloud.

    Supporting Types

    ImagesImageTimeouts, ImagesImageTimeoutsArgs

    Create string
    Create string
    create String
    create string
    create str
    create String

    Import

    Images can be imported using the id, e.g.

    $ pulumi import vkcs:index/imagesImage:ImagesImage rancheros 89c60255-9bd6-460c-822a-e2b959ede9d2
    

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

    Package Details

    Repository
    vkcs vk-cs/terraform-provider-vkcs
    License
    Notes
    This Pulumi package is based on the vkcs Terraform Provider.
    vkcs logo
    vkcs 0.9.3 published on Tuesday, Apr 15, 2025 by vk-cs