Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Opentelekomcloud Provider
  3. API Docs
  4. ImsImageV2
opentelekomcloud 1.36.37 published on Thursday, Apr 24, 2025 by opentelekomcloud
opentelekomcloud/terraform-provider-opentelekomcloud

opentelekomcloud.ImsImageV2

Explore with Pulumi AI

opentelekomcloud logo
opentelekomcloud 1.36.37 published on Thursday, Apr 24, 2025 by opentelekomcloud
opentelekomcloud/terraform-provider-opentelekomcloud

    Up-to-date reference of API arguments for IMS image you can get at documentation portal

    Manages a V2 Image resource within OpenTelekomCloud IMS.

    Example Usage

    Creating an image using an ECS

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

const imsTest = new opentelekomcloud.ImsImageV2("imsTest", {
    description: "Create an image using an ECS.",
    instanceId: "54a6c3a4-8511-4d01-818f-3fe5177cbb06",
    tags: {
        foo: "bar",
        key: "value",
    },
});

    import pulumi
import pulumi_opentelekomcloud as opentelekomcloud

ims_test = opentelekomcloud.ImsImageV2("imsTest",
    description="Create an image using an ECS.",
    instance_id="54a6c3a4-8511-4d01-818f-3fe5177cbb06",
    tags={
        "foo": "bar",
        "key": "value",
    })

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := opentelekomcloud.NewImsImageV2(ctx, "imsTest", &opentelekomcloud.ImsImageV2Args{
			Description: pulumi.String("Create an image using an ECS."),
			InstanceId:  pulumi.String("54a6c3a4-8511-4d01-818f-3fe5177cbb06"),
			Tags: pulumi.StringMap{
				"foo": pulumi.String("bar"),
				"key": pulumi.String("value"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var imsTest = new Opentelekomcloud.ImsImageV2("imsTest", new()
    {
        Description = "Create an image using an ECS.",
        InstanceId = "54a6c3a4-8511-4d01-818f-3fe5177cbb06",
        Tags = 
        {
            { "foo", "bar" },
            { "key", "value" },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.opentelekomcloud.ImsImageV2;
import com.pulumi.opentelekomcloud.ImsImageV2Args;
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 imsTest = new ImsImageV2("imsTest", ImsImageV2Args.builder()
            .description("Create an image using an ECS.")
            .instanceId("54a6c3a4-8511-4d01-818f-3fe5177cbb06")
            .tags(Map.ofEntries(
                Map.entry("foo", "bar"),
                Map.entry("key", "value")
            ))
            .build());

    }
}

    resources:
  imsTest:
    type: opentelekomcloud:ImsImageV2
    properties:
      description: Create an image using an ECS.
      instanceId: 54a6c3a4-8511-4d01-818f-3fe5177cbb06
      tags:
        foo: bar
        key: value

    Creating an image in the OBS bucket

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

const imsTestFile = new opentelekomcloud.ImsImageV2("imsTestFile", {
    description: "Create an image using a file in the OBS bucket.",
    imageUrl: "ims-image:centos70.qcow2",
    minDisk: 40,
    tags: {
        foo: "bar1",
        key: "value",
    },
});

    import pulumi
import pulumi_opentelekomcloud as opentelekomcloud

ims_test_file = opentelekomcloud.ImsImageV2("imsTestFile",
    description="Create an image using a file in the OBS bucket.",
    image_url="ims-image:centos70.qcow2",
    min_disk=40,
    tags={
        "foo": "bar1",
        "key": "value",
    })

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := opentelekomcloud.NewImsImageV2(ctx, "imsTestFile", &opentelekomcloud.ImsImageV2Args{
			Description: pulumi.String("Create an image using a file in the OBS bucket."),
			ImageUrl:    pulumi.String("ims-image:centos70.qcow2"),
			MinDisk:     pulumi.Float64(40),
			Tags: pulumi.StringMap{
				"foo": pulumi.String("bar1"),
				"key": pulumi.String("value"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var imsTestFile = new Opentelekomcloud.ImsImageV2("imsTestFile", new()
    {
        Description = "Create an image using a file in the OBS bucket.",
        ImageUrl = "ims-image:centos70.qcow2",
        MinDisk = 40,
        Tags = 
        {
            { "foo", "bar1" },
            { "key", "value" },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.opentelekomcloud.ImsImageV2;
import com.pulumi.opentelekomcloud.ImsImageV2Args;
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 imsTestFile = new ImsImageV2("imsTestFile", ImsImageV2Args.builder()
            .description("Create an image using a file in the OBS bucket.")
            .imageUrl("ims-image:centos70.qcow2")
            .minDisk(40)
            .tags(Map.ofEntries(
                Map.entry("foo", "bar1"),
                Map.entry("key", "value")
            ))
            .build());

    }
}

    resources:
  imsTestFile:
    type: opentelekomcloud:ImsImageV2
    properties:
      description: Create an image using a file in the OBS bucket.
      imageUrl: ims-image:centos70.qcow2
      minDisk: 40
      tags:
        foo: bar1
        key: value

    Creating an image using an Volume

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

const imageVolume = new opentelekomcloud.ImsImageV2("imageVolume", {
    description: "created by Terraform",
    osVersion: "Debian GNU/Linux 10.0.0 64bit",
    tags: {
        foo: "bar",
        key: "value",
    },
    volumeId: "54a6c3a4-8511-4d01-818f-3fe5177cbb07",
});

    import pulumi
import pulumi_opentelekomcloud as opentelekomcloud

image_volume = opentelekomcloud.ImsImageV2("imageVolume",
    description="created by Terraform",
    os_version="Debian GNU/Linux 10.0.0 64bit",
    tags={
        "foo": "bar",
        "key": "value",
    },
    volume_id="54a6c3a4-8511-4d01-818f-3fe5177cbb07")

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := opentelekomcloud.NewImsImageV2(ctx, "imageVolume", &opentelekomcloud.ImsImageV2Args{
			Description: pulumi.String("created by Terraform"),
			OsVersion:   pulumi.String("Debian GNU/Linux 10.0.0 64bit"),
			Tags: pulumi.StringMap{
				"foo": pulumi.String("bar"),
				"key": pulumi.String("value"),
			},
			VolumeId: pulumi.String("54a6c3a4-8511-4d01-818f-3fe5177cbb07"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var imageVolume = new Opentelekomcloud.ImsImageV2("imageVolume", new()
    {
        Description = "created by Terraform",
        OsVersion = "Debian GNU/Linux 10.0.0 64bit",
        Tags = 
        {
            { "foo", "bar" },
            { "key", "value" },
        },
        VolumeId = "54a6c3a4-8511-4d01-818f-3fe5177cbb07",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.opentelekomcloud.ImsImageV2;
import com.pulumi.opentelekomcloud.ImsImageV2Args;
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 imageVolume = new ImsImageV2("imageVolume", ImsImageV2Args.builder()
            .description("created by Terraform")
            .osVersion("Debian GNU/Linux 10.0.0 64bit")
            .tags(Map.ofEntries(
                Map.entry("foo", "bar"),
                Map.entry("key", "value")
            ))
            .volumeId("54a6c3a4-8511-4d01-818f-3fe5177cbb07")
            .build());

    }
}

    resources:
  imageVolume:
    type: opentelekomcloud:ImsImageV2
    properties:
      description: created by Terraform
      osVersion: Debian GNU/Linux 10.0.0 64bit
      tags:
        foo: bar
        key: value
      volumeId: 54a6c3a4-8511-4d01-818f-3fe5177cbb07

    Create ImsImageV2 Resource

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

    Constructor syntax

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

@overload
def ImsImageV2(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               cmk_id: Optional[str] = None,
               description: Optional[str] = None,
               hw_firmware_type: Optional[str] = None,
               image_url: Optional[str] = None,
               ims_image_v2_id: Optional[str] = None,
               instance_id: Optional[str] = None,
               is_config: Optional[bool] = None,
               max_ram: Optional[float] = None,
               min_disk: Optional[float] = None,
               min_ram: Optional[float] = None,
               name: Optional[str] = None,
               os_version: Optional[str] = None,
               tags: Optional[Mapping[str, str]] = None,
               timeouts: Optional[ImsImageV2TimeoutsArgs] = None,
               type: Optional[str] = None,
               volume_id: Optional[str] = None)
    func NewImsImageV2(ctx *Context, name string, args *ImsImageV2Args, opts ...ResourceOption) (*ImsImageV2, error)
    public ImsImageV2(string name, ImsImageV2Args? args = null, CustomResourceOptions? opts = null)
    public ImsImageV2(String name, ImsImageV2Args args)
public ImsImageV2(String name, ImsImageV2Args args, CustomResourceOptions options)

    type: opentelekomcloud:ImsImageV2
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 ImsImageV2Args
    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 ImsImageV2Args
    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 ImsImageV2Args
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ImsImageV2Args
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ImsImageV2Args
    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 imsImageV2Resource = new Opentelekomcloud.ImsImageV2("imsImageV2Resource", new()
{
    CmkId = "string",
    Description = "string",
    HwFirmwareType = "string",
    ImageUrl = "string",
    ImsImageV2Id = "string",
    InstanceId = "string",
    IsConfig = false,
    MaxRam = 0,
    MinDisk = 0,
    MinRam = 0,
    Name = "string",
    OsVersion = "string",
    Tags = 
    {
        { "string", "string" },
    },
    Timeouts = new Opentelekomcloud.Inputs.ImsImageV2TimeoutsArgs
    {
        Create = "string",
        Delete = "string",
    },
    Type = "string",
    VolumeId = "string",
});

    example, err := opentelekomcloud.NewImsImageV2(ctx, "imsImageV2Resource", &opentelekomcloud.ImsImageV2Args{
	CmkId:          pulumi.String("string"),
	Description:    pulumi.String("string"),
	HwFirmwareType: pulumi.String("string"),
	ImageUrl:       pulumi.String("string"),
	ImsImageV2Id:   pulumi.String("string"),
	InstanceId:     pulumi.String("string"),
	IsConfig:       pulumi.Bool(false),
	MaxRam:         pulumi.Float64(0),
	MinDisk:        pulumi.Float64(0),
	MinRam:         pulumi.Float64(0),
	Name:           pulumi.String("string"),
	OsVersion:      pulumi.String("string"),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Timeouts: &opentelekomcloud.ImsImageV2TimeoutsArgs{
		Create: pulumi.String("string"),
		Delete: pulumi.String("string"),
	},
	Type:     pulumi.String("string"),
	VolumeId: pulumi.String("string"),
})

    var imsImageV2Resource = new ImsImageV2("imsImageV2Resource", ImsImageV2Args.builder()
    .cmkId("string")
    .description("string")
    .hwFirmwareType("string")
    .imageUrl("string")
    .imsImageV2Id("string")
    .instanceId("string")
    .isConfig(false)
    .maxRam(0)
    .minDisk(0)
    .minRam(0)
    .name("string")
    .osVersion("string")
    .tags(Map.of("string", "string"))
    .timeouts(ImsImageV2TimeoutsArgs.builder()
        .create("string")
        .delete("string")
        .build())
    .type("string")
    .volumeId("string")
    .build());

    ims_image_v2_resource = opentelekomcloud.ImsImageV2("imsImageV2Resource",
    cmk_id="string",
    description="string",
    hw_firmware_type="string",
    image_url="string",
    ims_image_v2_id="string",
    instance_id="string",
    is_config=False,
    max_ram=0,
    min_disk=0,
    min_ram=0,
    name="string",
    os_version="string",
    tags={
        "string": "string",
    },
    timeouts={
        "create": "string",
        "delete": "string",
    },
    type="string",
    volume_id="string")

    const imsImageV2Resource = new opentelekomcloud.ImsImageV2("imsImageV2Resource", {
    cmkId: "string",
    description: "string",
    hwFirmwareType: "string",
    imageUrl: "string",
    imsImageV2Id: "string",
    instanceId: "string",
    isConfig: false,
    maxRam: 0,
    minDisk: 0,
    minRam: 0,
    name: "string",
    osVersion: "string",
    tags: {
        string: "string",
    },
    timeouts: {
        create: "string",
        "delete": "string",
    },
    type: "string",
    volumeId: "string",
});

    type: opentelekomcloud:ImsImageV2
properties:
    cmkId: string
    description: string
    hwFirmwareType: string
    imageUrl: string
    imsImageV2Id: string
    instanceId: string
    isConfig: false
    maxRam: 0
    minDisk: 0
    minRam: 0
    name: string
    osVersion: string
    tags:
        string: string
    timeouts:
        create: string
        delete: string
    type: string
    volumeId: string

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

    CmkId string
    The master key used for encrypting an image. Changing this creates a new image.
    Description string
    A description of the image. Changing this creates a new image.
    HwFirmwareType string
    Specifies the boot mode. The value can be bios or uefi.
    ImageUrl string
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    ImsImageV2Id string
    A unique ID assigned by IMS.
    InstanceId string
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    IsConfig bool
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    MaxRam double
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    MinDisk double
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    MinRam double
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    Name string
    The name of the image.
    OsVersion string
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    Tags Dictionary<string, string>
    The tags of the image.
    Timeouts ImsImageV2Timeouts
    Type string
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    VolumeId string
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.
    CmkId string
    The master key used for encrypting an image. Changing this creates a new image.
    Description string
    A description of the image. Changing this creates a new image.
    HwFirmwareType string
    Specifies the boot mode. The value can be bios or uefi.
    ImageUrl string
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    ImsImageV2Id string
    A unique ID assigned by IMS.
    InstanceId string
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    IsConfig bool
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    MaxRam float64
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    MinDisk float64
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    MinRam float64
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    Name string
    The name of the image.
    OsVersion string
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    Tags map[string]string
    The tags of the image.
    Timeouts ImsImageV2TimeoutsArgs
    Type string
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    VolumeId string
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.
    cmkId String
    The master key used for encrypting an image. Changing this creates a new image.
    description String
    A description of the image. Changing this creates a new image.
    hwFirmwareType String
    Specifies the boot mode. The value can be bios or uefi.
    imageUrl String
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    imsImageV2Id String
    A unique ID assigned by IMS.
    instanceId String
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    isConfig Boolean
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    maxRam Double
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    minDisk Double
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    minRam Double
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    name String
    The name of the image.
    osVersion String
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    tags Map<String,String>
    The tags of the image.
    timeouts ImsImageV2Timeouts
    type String
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    volumeId String
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.
    cmkId string
    The master key used for encrypting an image. Changing this creates a new image.
    description string
    A description of the image. Changing this creates a new image.
    hwFirmwareType string
    Specifies the boot mode. The value can be bios or uefi.
    imageUrl string
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    imsImageV2Id string
    A unique ID assigned by IMS.
    instanceId string
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    isConfig boolean
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    maxRam number
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    minDisk number
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    minRam number
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    name string
    The name of the image.
    osVersion string
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    tags {[key: string]: string}
    The tags of the image.
    timeouts ImsImageV2Timeouts
    type string
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    volumeId string
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.
    cmk_id str
    The master key used for encrypting an image. Changing this creates a new image.
    description str
    A description of the image. Changing this creates a new image.
    hw_firmware_type str
    Specifies the boot mode. The value can be bios or uefi.
    image_url str
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    ims_image_v2_id str
    A unique ID assigned by IMS.
    instance_id str
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    is_config bool
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    max_ram float
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    min_disk float
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    min_ram float
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    name str
    The name of the image.
    os_version str
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    tags Mapping[str, str]
    The tags of the image.
    timeouts ImsImageV2TimeoutsArgs
    type str
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    volume_id str
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.
    cmkId String
    The master key used for encrypting an image. Changing this creates a new image.
    description String
    A description of the image. Changing this creates a new image.
    hwFirmwareType String
    Specifies the boot mode. The value can be bios or uefi.
    imageUrl String
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    imsImageV2Id String
    A unique ID assigned by IMS.
    instanceId String
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    isConfig Boolean
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    maxRam Number
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    minDisk Number
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    minRam Number
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    name String
    The name of the image.
    osVersion String
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    tags Map<String>
    The tags of the image.
    timeouts Property Map
    type String
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    volumeId String
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.

    Outputs

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

    DataOrigin string
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    DiskFormat string
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    File string
    The URL for uploading and downloading the image file.
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageSize string
    The size(bytes) of the image file format.
    Visibility string
    Whether the image is visible to other tenants.
    DataOrigin string
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    DiskFormat string
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    File string
    The URL for uploading and downloading the image file.
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageSize string
    The size(bytes) of the image file format.
    Visibility string
    Whether the image is visible to other tenants.
    dataOrigin String
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    diskFormat String
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    file String
    The URL for uploading and downloading the image file.
    id String
    The provider-assigned unique ID for this managed resource.
    imageSize String
    The size(bytes) of the image file format.
    visibility String
    Whether the image is visible to other tenants.
    dataOrigin string
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    diskFormat string
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    file string
    The URL for uploading and downloading the image file.
    id string
    The provider-assigned unique ID for this managed resource.
    imageSize string
    The size(bytes) of the image file format.
    visibility string
    Whether the image is visible to other tenants.
    data_origin str
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    disk_format str
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    file str
    The URL for uploading and downloading the image file.
    id str
    The provider-assigned unique ID for this managed resource.
    image_size str
    The size(bytes) of the image file format.
    visibility str
    Whether the image is visible to other tenants.
    dataOrigin String
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    diskFormat String
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    file String
    The URL for uploading and downloading the image file.
    id String
    The provider-assigned unique ID for this managed resource.
    imageSize String
    The size(bytes) of the image file format.
    visibility String
    Whether the image is visible to other tenants.

    Look up Existing ImsImageV2 Resource

    Get an existing ImsImageV2 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?: ImsImageV2State, opts?: CustomResourceOptions): ImsImageV2
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        cmk_id: Optional[str] = None,
        data_origin: Optional[str] = None,
        description: Optional[str] = None,
        disk_format: Optional[str] = None,
        file: Optional[str] = None,
        hw_firmware_type: Optional[str] = None,
        image_size: Optional[str] = None,
        image_url: Optional[str] = None,
        ims_image_v2_id: Optional[str] = None,
        instance_id: Optional[str] = None,
        is_config: Optional[bool] = None,
        max_ram: Optional[float] = None,
        min_disk: Optional[float] = None,
        min_ram: Optional[float] = None,
        name: Optional[str] = None,
        os_version: Optional[str] = None,
        tags: Optional[Mapping[str, str]] = None,
        timeouts: Optional[ImsImageV2TimeoutsArgs] = None,
        type: Optional[str] = None,
        visibility: Optional[str] = None,
        volume_id: Optional[str] = None) -> ImsImageV2
    func GetImsImageV2(ctx *Context, name string, id IDInput, state *ImsImageV2State, opts ...ResourceOption) (*ImsImageV2, error)
    public static ImsImageV2 Get(string name, Input<string> id, ImsImageV2State? state, CustomResourceOptions? opts = null)
    public static ImsImageV2 get(String name, Output<String> id, ImsImageV2State state, CustomResourceOptions options)
    resources:  _:    type: opentelekomcloud:ImsImageV2    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:
    CmkId string
    The master key used for encrypting an image. Changing this creates a new image.
    DataOrigin string
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    Description string
    A description of the image. Changing this creates a new image.
    DiskFormat string
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    File string
    The URL for uploading and downloading the image file.
    HwFirmwareType string
    Specifies the boot mode. The value can be bios or uefi.
    ImageSize string
    The size(bytes) of the image file format.
    ImageUrl string
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    ImsImageV2Id string
    A unique ID assigned by IMS.
    InstanceId string
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    IsConfig bool
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    MaxRam double
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    MinDisk double
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    MinRam double
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    Name string
    The name of the image.
    OsVersion string
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    Tags Dictionary<string, string>
    The tags of the image.
    Timeouts ImsImageV2Timeouts
    Type string
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    Visibility string
    Whether the image is visible to other tenants.
    VolumeId string
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.
    CmkId string
    The master key used for encrypting an image. Changing this creates a new image.
    DataOrigin string
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    Description string
    A description of the image. Changing this creates a new image.
    DiskFormat string
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    File string
    The URL for uploading and downloading the image file.
    HwFirmwareType string
    Specifies the boot mode. The value can be bios or uefi.
    ImageSize string
    The size(bytes) of the image file format.
    ImageUrl string
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    ImsImageV2Id string
    A unique ID assigned by IMS.
    InstanceId string
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    IsConfig bool
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    MaxRam float64
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    MinDisk float64
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    MinRam float64
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    Name string
    The name of the image.
    OsVersion string
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    Tags map[string]string
    The tags of the image.
    Timeouts ImsImageV2TimeoutsArgs
    Type string
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    Visibility string
    Whether the image is visible to other tenants.
    VolumeId string
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.
    cmkId String
    The master key used for encrypting an image. Changing this creates a new image.
    dataOrigin String
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    description String
    A description of the image. Changing this creates a new image.
    diskFormat String
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    file String
    The URL for uploading and downloading the image file.
    hwFirmwareType String
    Specifies the boot mode. The value can be bios or uefi.
    imageSize String
    The size(bytes) of the image file format.
    imageUrl String
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    imsImageV2Id String
    A unique ID assigned by IMS.
    instanceId String
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    isConfig Boolean
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    maxRam Double
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    minDisk Double
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    minRam Double
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    name String
    The name of the image.
    osVersion String
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    tags Map<String,String>
    The tags of the image.
    timeouts ImsImageV2Timeouts
    type String
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    visibility String
    Whether the image is visible to other tenants.
    volumeId String
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.
    cmkId string
    The master key used for encrypting an image. Changing this creates a new image.
    dataOrigin string
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    description string
    A description of the image. Changing this creates a new image.
    diskFormat string
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    file string
    The URL for uploading and downloading the image file.
    hwFirmwareType string
    Specifies the boot mode. The value can be bios or uefi.
    imageSize string
    The size(bytes) of the image file format.
    imageUrl string
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    imsImageV2Id string
    A unique ID assigned by IMS.
    instanceId string
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    isConfig boolean
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    maxRam number
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    minDisk number
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    minRam number
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    name string
    The name of the image.
    osVersion string
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    tags {[key: string]: string}
    The tags of the image.
    timeouts ImsImageV2Timeouts
    type string
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    visibility string
    Whether the image is visible to other tenants.
    volumeId string
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.
    cmk_id str
    The master key used for encrypting an image. Changing this creates a new image.
    data_origin str
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    description str
    A description of the image. Changing this creates a new image.
    disk_format str
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    file str
    The URL for uploading and downloading the image file.
    hw_firmware_type str
    Specifies the boot mode. The value can be bios or uefi.
    image_size str
    The size(bytes) of the image file format.
    image_url str
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    ims_image_v2_id str
    A unique ID assigned by IMS.
    instance_id str
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    is_config bool
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    max_ram float
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    min_disk float
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    min_ram float
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    name str
    The name of the image.
    os_version str
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    tags Mapping[str, str]
    The tags of the image.
    timeouts ImsImageV2TimeoutsArgs
    type str
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    visibility str
    Whether the image is visible to other tenants.
    volume_id str
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.
    cmkId String
    The master key used for encrypting an image. Changing this creates a new image.
    dataOrigin String
    The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.
    description String
    A description of the image. Changing this creates a new image.
    diskFormat String
    The image file format. The value can be vhd, zvhd, raw, zvhd2, or qcow2.
    file String
    The URL for uploading and downloading the image file.
    hwFirmwareType String
    Specifies the boot mode. The value can be bios or uefi.
    imageSize String
    The size(bytes) of the image file format.
    imageUrl String
    The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.
    imsImageV2Id String
    A unique ID assigned by IMS.
    instanceId String
    The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.
    isConfig Boolean
    If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.
    maxRam Number
    The maximum memory of the image in the unit of MB. Changing this creates a new image.
    minDisk Number
    The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.
    minRam Number
    The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.
    name String
    The name of the image.
    osVersion String
    The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.
    tags Map<String>
    The tags of the image.
    timeouts Property Map
    type String
    The image type. Must be one of ECS, FusionCompute, BMS, Ironic or IsoImage. Changing this creates a new image.
    visibility String
    Whether the image is visible to other tenants.
    volumeId String
    Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.

    Supporting Types

    ImsImageV2Timeouts, ImsImageV2TimeoutsArgs

    Create string
    Delete string
    Create string
    Delete string
    create String
    delete String
    create string
    delete string
    create str
    delete str
    create String
    delete String

    Import

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

    $ pulumi import opentelekomcloud:index/imsImageV2:ImsImageV2 my_image 7886e623-f1b3-473e-b882-67ba1c35887f

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

    Package Details

    Repository
    opentelekomcloud opentelekomcloud/terraform-provider-opentelekomcloud
    License
    Notes
    This Pulumi package is based on the opentelekomcloud Terraform Provider.
    opentelekomcloud logo
    opentelekomcloud 1.36.37 published on Thursday, Apr 24, 2025 by opentelekomcloud
    opentelekomcloud/terraform-provider-opentelekomcloud