oci.Core.Image
Explore with Pulumi AI
This resource provides the Image resource in Oracle Cloud Infrastructure Core service.
Creates a boot disk image for the specified instance or imports an exported image from the Oracle Cloud Infrastructure Object Storage service.
When creating a new image, you must provide the OCID of the instance you want to use as the basis for the image, and the OCID of the compartment containing that instance. For more information about images, see Managing Custom Images.
When importing an exported image from Object Storage, you specify the source information in ImageSourceDetails.
When importing an image based on the namespace, bucket name, and object name, use ImageSourceViaObjectStorageTupleDetails.
When importing an image based on the Object Storage URL, use ImageSourceViaObjectStorageUriDetails. See Object Storage URLs and Using Pre-Authenticated Requests for constructing URLs for image import/export.
For more information about importing exported images, see Image Import/Export.
You may optionally specify a display name for the image, which is simply a friendly name or description. It does not have to be unique, and you can change it. See UpdateImage. Avoid entering confidential information.
Example Usage
Create image from instance in tenancy
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testImage = new oci.core.Image("test_image", {
compartmentId: compartmentId,
instanceId: testInstance.id,
definedTags: {
"Operations.CostCenter": "42",
},
displayName: imageDisplayName,
launchMode: imageLaunchMode,
freeformTags: {
Department: "Finance",
},
});
import pulumi
import pulumi_oci as oci
test_image = oci.core.Image("test_image",
compartment_id=compartment_id,
instance_id=test_instance["id"],
defined_tags={
"Operations.CostCenter": "42",
},
display_name=image_display_name,
launch_mode=image_launch_mode,
freeform_tags={
"Department": "Finance",
})
package main
import (
"github.com/pulumi/pulumi-oci/sdk/go/oci/Core"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := Core.NewImage(ctx, "test_image", &Core.ImageArgs{
CompartmentId: pulumi.Any(compartmentId),
InstanceId: pulumi.Any(testInstance.Id),
DefinedTags: pulumi.Map{
"Operations.CostCenter": pulumi.Any("42"),
},
DisplayName: pulumi.Any(imageDisplayName),
LaunchMode: pulumi.Any(imageLaunchMode),
FreeformTags: pulumi.Map{
"Department": pulumi.Any("Finance"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() =>
{
var testImage = new Oci.Core.Image("test_image", new()
{
CompartmentId = compartmentId,
InstanceId = testInstance.Id,
DefinedTags =
{
{ "Operations.CostCenter", "42" },
},
DisplayName = imageDisplayName,
LaunchMode = imageLaunchMode,
FreeformTags =
{
{ "Department", "Finance" },
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Core.Image;
import com.pulumi.oci.Core.ImageArgs;
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 testImage = new Image("testImage", ImageArgs.builder()
.compartmentId(compartmentId)
.instanceId(testInstance.id())
.definedTags(Map.of("Operations.CostCenter", "42"))
.displayName(imageDisplayName)
.launchMode(imageLaunchMode)
.freeformTags(Map.of("Department", "Finance"))
.build());
}
}
resources:
testImage:
type: oci:Core:Image
name: test_image
properties:
compartmentId: ${compartmentId}
instanceId: ${testInstance.id}
definedTags:
Operations.CostCenter: '42'
displayName: ${imageDisplayName}
launchMode: ${imageLaunchMode}
freeformTags:
Department: Finance
Create image from exported image via direct access to object store
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testImage = new oci.core.Image("test_image", {
compartmentId: compartmentId,
displayName: imageDisplayName,
launchMode: imageLaunchMode,
imageSourceDetails: {
sourceType: "objectStorageTuple",
bucketName: bucketName,
namespaceName: namespace,
objectName: objectName,
operatingSystem: imageImageSourceDetailsOperatingSystem,
operatingSystemVersion: imageImageSourceDetailsOperatingSystemVersion,
sourceImageType: sourceImageType,
},
});
import pulumi
import pulumi_oci as oci
test_image = oci.core.Image("test_image",
compartment_id=compartment_id,
display_name=image_display_name,
launch_mode=image_launch_mode,
image_source_details=oci.core.ImageImageSourceDetailsArgs(
source_type="objectStorageTuple",
bucket_name=bucket_name,
namespace_name=namespace,
object_name=object_name,
operating_system=image_image_source_details_operating_system,
operating_system_version=image_image_source_details_operating_system_version,
source_image_type=source_image_type,
))
package main
import (
"github.com/pulumi/pulumi-oci/sdk/go/oci/Core"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := Core.NewImage(ctx, "test_image", &Core.ImageArgs{
CompartmentId: pulumi.Any(compartmentId),
DisplayName: pulumi.Any(imageDisplayName),
LaunchMode: pulumi.Any(imageLaunchMode),
ImageSourceDetails: &core.ImageImageSourceDetailsArgs{
SourceType: pulumi.String("objectStorageTuple"),
BucketName: pulumi.Any(bucketName),
NamespaceName: pulumi.Any(namespace),
ObjectName: pulumi.Any(objectName),
OperatingSystem: pulumi.Any(imageImageSourceDetailsOperatingSystem),
OperatingSystemVersion: pulumi.Any(imageImageSourceDetailsOperatingSystemVersion),
SourceImageType: pulumi.Any(sourceImageType),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() =>
{
var testImage = new Oci.Core.Image("test_image", new()
{
CompartmentId = compartmentId,
DisplayName = imageDisplayName,
LaunchMode = imageLaunchMode,
ImageSourceDetails = new Oci.Core.Inputs.ImageImageSourceDetailsArgs
{
SourceType = "objectStorageTuple",
BucketName = bucketName,
NamespaceName = @namespace,
ObjectName = objectName,
OperatingSystem = imageImageSourceDetailsOperatingSystem,
OperatingSystemVersion = imageImageSourceDetailsOperatingSystemVersion,
SourceImageType = sourceImageType,
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Core.Image;
import com.pulumi.oci.Core.ImageArgs;
import com.pulumi.oci.Core.inputs.ImageImageSourceDetailsArgs;
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 testImage = new Image("testImage", ImageArgs.builder()
.compartmentId(compartmentId)
.displayName(imageDisplayName)
.launchMode(imageLaunchMode)
.imageSourceDetails(ImageImageSourceDetailsArgs.builder()
.sourceType("objectStorageTuple")
.bucketName(bucketName)
.namespaceName(namespace)
.objectName(objectName)
.operatingSystem(imageImageSourceDetailsOperatingSystem)
.operatingSystemVersion(imageImageSourceDetailsOperatingSystemVersion)
.sourceImageType(sourceImageType)
.build())
.build());
}
}
resources:
testImage:
type: oci:Core:Image
name: test_image
properties:
compartmentId: ${compartmentId}
displayName: ${imageDisplayName}
launchMode: ${imageLaunchMode}
imageSourceDetails:
sourceType: objectStorageTuple
bucketName: ${bucketName}
namespaceName: ${namespace}
objectName: ${objectName}
operatingSystem: ${imageImageSourceDetailsOperatingSystem}
operatingSystemVersion: ${imageImageSourceDetailsOperatingSystemVersion}
sourceImageType: ${sourceImageType}
Create image from exported image at publicly accessible uri
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testImage = new oci.core.Image("test_image", {
compartmentId: compartmentId,
displayName: imageDisplayName,
launchMode: imageLaunchMode,
imageSourceDetails: {
sourceType: "objectStorageUri",
sourceUri: sourceUri,
operatingSystem: imageImageSourceDetailsOperatingSystem,
operatingSystemVersion: imageImageSourceDetailsOperatingSystemVersion,
sourceImageType: sourceImageType,
},
});
import pulumi
import pulumi_oci as oci
test_image = oci.core.Image("test_image",
compartment_id=compartment_id,
display_name=image_display_name,
launch_mode=image_launch_mode,
image_source_details=oci.core.ImageImageSourceDetailsArgs(
source_type="objectStorageUri",
source_uri=source_uri,
operating_system=image_image_source_details_operating_system,
operating_system_version=image_image_source_details_operating_system_version,
source_image_type=source_image_type,
))
package main
import (
"github.com/pulumi/pulumi-oci/sdk/go/oci/Core"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := Core.NewImage(ctx, "test_image", &Core.ImageArgs{
CompartmentId: pulumi.Any(compartmentId),
DisplayName: pulumi.Any(imageDisplayName),
LaunchMode: pulumi.Any(imageLaunchMode),
ImageSourceDetails: &core.ImageImageSourceDetailsArgs{
SourceType: pulumi.String("objectStorageUri"),
SourceUri: pulumi.Any(sourceUri),
OperatingSystem: pulumi.Any(imageImageSourceDetailsOperatingSystem),
OperatingSystemVersion: pulumi.Any(imageImageSourceDetailsOperatingSystemVersion),
SourceImageType: pulumi.Any(sourceImageType),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() =>
{
var testImage = new Oci.Core.Image("test_image", new()
{
CompartmentId = compartmentId,
DisplayName = imageDisplayName,
LaunchMode = imageLaunchMode,
ImageSourceDetails = new Oci.Core.Inputs.ImageImageSourceDetailsArgs
{
SourceType = "objectStorageUri",
SourceUri = sourceUri,
OperatingSystem = imageImageSourceDetailsOperatingSystem,
OperatingSystemVersion = imageImageSourceDetailsOperatingSystemVersion,
SourceImageType = sourceImageType,
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Core.Image;
import com.pulumi.oci.Core.ImageArgs;
import com.pulumi.oci.Core.inputs.ImageImageSourceDetailsArgs;
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 testImage = new Image("testImage", ImageArgs.builder()
.compartmentId(compartmentId)
.displayName(imageDisplayName)
.launchMode(imageLaunchMode)
.imageSourceDetails(ImageImageSourceDetailsArgs.builder()
.sourceType("objectStorageUri")
.sourceUri(sourceUri)
.operatingSystem(imageImageSourceDetailsOperatingSystem)
.operatingSystemVersion(imageImageSourceDetailsOperatingSystemVersion)
.sourceImageType(sourceImageType)
.build())
.build());
}
}
resources:
testImage:
type: oci:Core:Image
name: test_image
properties:
compartmentId: ${compartmentId}
displayName: ${imageDisplayName}
launchMode: ${imageLaunchMode}
imageSourceDetails:
sourceType: objectStorageUri
sourceUri: ${sourceUri}
operatingSystem: ${imageImageSourceDetailsOperatingSystem}
operatingSystemVersion: ${imageImageSourceDetailsOperatingSystemVersion}
sourceImageType: ${sourceImageType}
Create Image Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Image(name: string, args: ImageArgs, opts?: CustomResourceOptions);
@overload
def Image(resource_name: str,
args: ImageArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Image(resource_name: str,
opts: Optional[ResourceOptions] = None,
compartment_id: Optional[str] = None,
defined_tags: Optional[Mapping[str, Any]] = None,
display_name: Optional[str] = None,
freeform_tags: Optional[Mapping[str, Any]] = None,
image_source_details: Optional[_core.ImageImageSourceDetailsArgs] = None,
instance_id: Optional[str] = None,
launch_mode: Optional[str] = None)
func NewImage(ctx *Context, name string, args ImageArgs, opts ...ResourceOption) (*Image, error)
public Image(string name, ImageArgs args, CustomResourceOptions? opts = null)
type: oci:Core:Image
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 ImageArgs
- 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 ImageArgs
- 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 ImageArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ImageArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ImageArgs
- 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 imageResource = new Oci.Core.Image("imageResource", new()
{
CompartmentId = "string",
DefinedTags =
{
{ "string", "any" },
},
DisplayName = "string",
FreeformTags =
{
{ "string", "any" },
},
ImageSourceDetails = new Oci.Core.Inputs.ImageImageSourceDetailsArgs
{
SourceType = "string",
BucketName = "string",
NamespaceName = "string",
ObjectName = "string",
OperatingSystem = "string",
OperatingSystemVersion = "string",
SourceImageType = "string",
SourceUri = "string",
},
InstanceId = "string",
LaunchMode = "string",
});
example, err := Core.NewImage(ctx, "imageResource", &Core.ImageArgs{
CompartmentId: pulumi.String("string"),
DefinedTags: pulumi.Map{
"string": pulumi.Any("any"),
},
DisplayName: pulumi.String("string"),
FreeformTags: pulumi.Map{
"string": pulumi.Any("any"),
},
ImageSourceDetails: &core.ImageImageSourceDetailsArgs{
SourceType: pulumi.String("string"),
BucketName: pulumi.String("string"),
NamespaceName: pulumi.String("string"),
ObjectName: pulumi.String("string"),
OperatingSystem: pulumi.String("string"),
OperatingSystemVersion: pulumi.String("string"),
SourceImageType: pulumi.String("string"),
SourceUri: pulumi.String("string"),
},
InstanceId: pulumi.String("string"),
LaunchMode: pulumi.String("string"),
})
var imageResource = new Image("imageResource", ImageArgs.builder()
.compartmentId("string")
.definedTags(Map.of("string", "any"))
.displayName("string")
.freeformTags(Map.of("string", "any"))
.imageSourceDetails(ImageImageSourceDetailsArgs.builder()
.sourceType("string")
.bucketName("string")
.namespaceName("string")
.objectName("string")
.operatingSystem("string")
.operatingSystemVersion("string")
.sourceImageType("string")
.sourceUri("string")
.build())
.instanceId("string")
.launchMode("string")
.build());
image_resource = oci.core.Image("imageResource",
compartment_id="string",
defined_tags={
"string": "any",
},
display_name="string",
freeform_tags={
"string": "any",
},
image_source_details=oci.core.ImageImageSourceDetailsArgs(
source_type="string",
bucket_name="string",
namespace_name="string",
object_name="string",
operating_system="string",
operating_system_version="string",
source_image_type="string",
source_uri="string",
),
instance_id="string",
launch_mode="string")
const imageResource = new oci.core.Image("imageResource", {
compartmentId: "string",
definedTags: {
string: "any",
},
displayName: "string",
freeformTags: {
string: "any",
},
imageSourceDetails: {
sourceType: "string",
bucketName: "string",
namespaceName: "string",
objectName: "string",
operatingSystem: "string",
operatingSystemVersion: "string",
sourceImageType: "string",
sourceUri: "string",
},
instanceId: "string",
launchMode: "string",
});
type: oci:Core:Image
properties:
compartmentId: string
definedTags:
string: any
displayName: string
freeformTags:
string: any
imageSourceDetails:
bucketName: string
namespaceName: string
objectName: string
operatingSystem: string
operatingSystemVersion: string
sourceImageType: string
sourceType: string
sourceUri: string
instanceId: string
launchMode: string
Image Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Image resource accepts the following input properties:
- Compartment
Id string - (Updatable) The OCID of the compartment you want the image to be created in.
- Dictionary<string, object>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Display
Name string (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- Dictionary<string, object>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Image
Source ImageDetails Image Source Details - Instance
Id string - The OCID of the instance you want to use as the basis for the image.
- Launch
Mode string Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Compartment
Id string - (Updatable) The OCID of the compartment you want the image to be created in.
- map[string]interface{}
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Display
Name string (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- map[string]interface{}
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Image
Source ImageDetails Image Source Details Args - Instance
Id string - The OCID of the instance you want to use as the basis for the image.
- Launch
Mode string Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- compartment
Id String - (Updatable) The OCID of the compartment you want the image to be created in.
- Map<String,Object>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display
Name String (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- Map<String,Object>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- image
Source ImageDetails Image Source Details - instance
Id String - The OCID of the instance you want to use as the basis for the image.
- launch
Mode String Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- compartment
Id string - (Updatable) The OCID of the compartment you want the image to be created in.
- {[key: string]: any}
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display
Name string (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- {[key: string]: any}
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- image
Source ImageDetails Image Source Details - instance
Id string - The OCID of the instance you want to use as the basis for the image.
- launch
Mode string Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- compartment_
id str - (Updatable) The OCID of the compartment you want the image to be created in.
- Mapping[str, Any]
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display_
name str (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- Mapping[str, Any]
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- image_
source_ core.details Image Image Source Details Args - instance_
id str - The OCID of the instance you want to use as the basis for the image.
- launch_
mode str Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- compartment
Id String - (Updatable) The OCID of the compartment you want the image to be created in.
- Map<Any>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display
Name String (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- Map<Any>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- image
Source Property MapDetails - instance
Id String - The OCID of the instance you want to use as the basis for the image.
- launch
Mode String Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
Outputs
All input properties are implicitly available as output properties. Additionally, the Image resource produces the following output properties:
- Agent
Features List<ImageAgent Feature> - Oracle Cloud Agent features supported on the image.
- Base
Image stringId - The OCID of the image originally used to launch the instance.
- Billable
Size stringIn Gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- Create
Image boolAllowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- Id string
- The provider-assigned unique ID for this managed resource.
- Launch
Options List<ImageLaunch Option> - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- Listing
Type string - The listing type of the image. The default value is "NONE".
- Operating
System string - The image's operating system. Example:
Oracle Linux
- Operating
System stringVersion - The image's operating system version. Example:
7.2
- Size
In stringMbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- State string
- The current state of the image.
- Time
Created string - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- Agent
Features []ImageAgent Feature - Oracle Cloud Agent features supported on the image.
- Base
Image stringId - The OCID of the image originally used to launch the instance.
- Billable
Size stringIn Gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- Create
Image boolAllowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- Id string
- The provider-assigned unique ID for this managed resource.
- Launch
Options []ImageLaunch Option - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- Listing
Type string - The listing type of the image. The default value is "NONE".
- Operating
System string - The image's operating system. Example:
Oracle Linux
- Operating
System stringVersion - The image's operating system version. Example:
7.2
- Size
In stringMbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- State string
- The current state of the image.
- Time
Created string - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- agent
Features List<ImageAgent Feature> - Oracle Cloud Agent features supported on the image.
- base
Image StringId - The OCID of the image originally used to launch the instance.
- billable
Size StringIn Gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- create
Image BooleanAllowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- id String
- The provider-assigned unique ID for this managed resource.
- launch
Options List<ImageLaunch Option> - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- listing
Type String - The listing type of the image. The default value is "NONE".
- operating
System String - The image's operating system. Example:
Oracle Linux
- operating
System StringVersion - The image's operating system version. Example:
7.2
- size
In StringMbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- state String
- The current state of the image.
- time
Created String - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- agent
Features ImageAgent Feature[] - Oracle Cloud Agent features supported on the image.
- base
Image stringId - The OCID of the image originally used to launch the instance.
- billable
Size stringIn Gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- create
Image booleanAllowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- id string
- The provider-assigned unique ID for this managed resource.
- launch
Options ImageLaunch Option[] - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- listing
Type string - The listing type of the image. The default value is "NONE".
- operating
System string - The image's operating system. Example:
Oracle Linux
- operating
System stringVersion - The image's operating system version. Example:
7.2
- size
In stringMbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- state string
- The current state of the image.
- time
Created string - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- agent_
features Sequence[core.Image Agent Feature] - Oracle Cloud Agent features supported on the image.
- base_
image_ strid - The OCID of the image originally used to launch the instance.
- billable_
size_ strin_ gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- create_
image_ boolallowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- id str
- The provider-assigned unique ID for this managed resource.
- launch_
options Sequence[core.Image Launch Option] - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- listing_
type str - The listing type of the image. The default value is "NONE".
- operating_
system str - The image's operating system. Example:
Oracle Linux
- operating_
system_ strversion - The image's operating system version. Example:
7.2
- size_
in_ strmbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- state str
- The current state of the image.
- time_
created str - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- agent
Features List<Property Map> - Oracle Cloud Agent features supported on the image.
- base
Image StringId - The OCID of the image originally used to launch the instance.
- billable
Size StringIn Gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- create
Image BooleanAllowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- id String
- The provider-assigned unique ID for this managed resource.
- launch
Options List<Property Map> - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- listing
Type String - The listing type of the image. The default value is "NONE".
- operating
System String - The image's operating system. Example:
Oracle Linux
- operating
System StringVersion - The image's operating system version. Example:
7.2
- size
In StringMbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- state String
- The current state of the image.
- time
Created String - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
Look up Existing Image Resource
Get an existing Image 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?: ImageState, opts?: CustomResourceOptions): Image
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
agent_features: Optional[Sequence[_core.ImageAgentFeatureArgs]] = None,
base_image_id: Optional[str] = None,
billable_size_in_gbs: Optional[str] = None,
compartment_id: Optional[str] = None,
create_image_allowed: Optional[bool] = None,
defined_tags: Optional[Mapping[str, Any]] = None,
display_name: Optional[str] = None,
freeform_tags: Optional[Mapping[str, Any]] = None,
image_source_details: Optional[_core.ImageImageSourceDetailsArgs] = None,
instance_id: Optional[str] = None,
launch_mode: Optional[str] = None,
launch_options: Optional[Sequence[_core.ImageLaunchOptionArgs]] = None,
listing_type: Optional[str] = None,
operating_system: Optional[str] = None,
operating_system_version: Optional[str] = None,
size_in_mbs: Optional[str] = None,
state: Optional[str] = None,
time_created: Optional[str] = None) -> Image
func GetImage(ctx *Context, name string, id IDInput, state *ImageState, opts ...ResourceOption) (*Image, error)
public static Image Get(string name, Input<string> id, ImageState? state, CustomResourceOptions? opts = null)
public static Image get(String name, Output<String> id, ImageState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- 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.
- Agent
Features List<ImageAgent Feature> - Oracle Cloud Agent features supported on the image.
- Base
Image stringId - The OCID of the image originally used to launch the instance.
- Billable
Size stringIn Gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- Compartment
Id string - (Updatable) The OCID of the compartment you want the image to be created in.
- Create
Image boolAllowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- Dictionary<string, object>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Display
Name string (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- Dictionary<string, object>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Image
Source ImageDetails Image Source Details - Instance
Id string - The OCID of the instance you want to use as the basis for the image.
- Launch
Mode string Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Launch
Options List<ImageLaunch Option> - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- Listing
Type string - The listing type of the image. The default value is "NONE".
- Operating
System string - The image's operating system. Example:
Oracle Linux
- Operating
System stringVersion - The image's operating system version. Example:
7.2
- Size
In stringMbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- State string
- The current state of the image.
- Time
Created string - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- Agent
Features []ImageAgent Feature Args - Oracle Cloud Agent features supported on the image.
- Base
Image stringId - The OCID of the image originally used to launch the instance.
- Billable
Size stringIn Gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- Compartment
Id string - (Updatable) The OCID of the compartment you want the image to be created in.
- Create
Image boolAllowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- map[string]interface{}
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Display
Name string (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- map[string]interface{}
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Image
Source ImageDetails Image Source Details Args - Instance
Id string - The OCID of the instance you want to use as the basis for the image.
- Launch
Mode string Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Launch
Options []ImageLaunch Option Args - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- Listing
Type string - The listing type of the image. The default value is "NONE".
- Operating
System string - The image's operating system. Example:
Oracle Linux
- Operating
System stringVersion - The image's operating system version. Example:
7.2
- Size
In stringMbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- State string
- The current state of the image.
- Time
Created string - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- agent
Features List<ImageAgent Feature> - Oracle Cloud Agent features supported on the image.
- base
Image StringId - The OCID of the image originally used to launch the instance.
- billable
Size StringIn Gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- compartment
Id String - (Updatable) The OCID of the compartment you want the image to be created in.
- create
Image BooleanAllowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- Map<String,Object>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display
Name String (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- Map<String,Object>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- image
Source ImageDetails Image Source Details - instance
Id String - The OCID of the instance you want to use as the basis for the image.
- launch
Mode String Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- launch
Options List<ImageLaunch Option> - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- listing
Type String - The listing type of the image. The default value is "NONE".
- operating
System String - The image's operating system. Example:
Oracle Linux
- operating
System StringVersion - The image's operating system version. Example:
7.2
- size
In StringMbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- state String
- The current state of the image.
- time
Created String - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- agent
Features ImageAgent Feature[] - Oracle Cloud Agent features supported on the image.
- base
Image stringId - The OCID of the image originally used to launch the instance.
- billable
Size stringIn Gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- compartment
Id string - (Updatable) The OCID of the compartment you want the image to be created in.
- create
Image booleanAllowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- {[key: string]: any}
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display
Name string (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- {[key: string]: any}
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- image
Source ImageDetails Image Source Details - instance
Id string - The OCID of the instance you want to use as the basis for the image.
- launch
Mode string Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- launch
Options ImageLaunch Option[] - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- listing
Type string - The listing type of the image. The default value is "NONE".
- operating
System string - The image's operating system. Example:
Oracle Linux
- operating
System stringVersion - The image's operating system version. Example:
7.2
- size
In stringMbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- state string
- The current state of the image.
- time
Created string - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- agent_
features Sequence[core.Image Agent Feature Args] - Oracle Cloud Agent features supported on the image.
- base_
image_ strid - The OCID of the image originally used to launch the instance.
- billable_
size_ strin_ gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- compartment_
id str - (Updatable) The OCID of the compartment you want the image to be created in.
- create_
image_ boolallowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- Mapping[str, Any]
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display_
name str (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- Mapping[str, Any]
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- image_
source_ core.details Image Image Source Details Args - instance_
id str - The OCID of the instance you want to use as the basis for the image.
- launch_
mode str Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- launch_
options Sequence[core.Image Launch Option Args] - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- listing_
type str - The listing type of the image. The default value is "NONE".
- operating_
system str - The image's operating system. Example:
Oracle Linux
- operating_
system_ strversion - The image's operating system version. Example:
7.2
- size_
in_ strmbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- state str
- The current state of the image.
- time_
created str - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- agent
Features List<Property Map> - Oracle Cloud Agent features supported on the image.
- base
Image StringId - The OCID of the image originally used to launch the instance.
- billable
Size StringIn Gbs - The size of the internal storage for this image that is subject to billing (1 GB = 1,073,741,824 bytes). Example:
100
- compartment
Id String - (Updatable) The OCID of the compartment you want the image to be created in.
- create
Image BooleanAllowed - Whether instances launched with this image can be used to create new images. For example, you cannot create an image of an Oracle Database instance. Example:
true
- Map<Any>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- display
Name String (Updatable) A user-friendly name for the image. It does not have to be unique, and it's changeable. Avoid entering confidential information.
You cannot use a platform image name as a custom image name.
Example:
My Oracle Linux image
- Map<Any>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- image
Source Property MapDetails - instance
Id String - The OCID of the instance you want to use as the basis for the image.
- launch
Mode String Specifies the configuration mode for launching virtual machine (VM) instances. The configuration modes are:
NATIVE
- VM instances launch with iSCSI boot and VFIO devices. The default value for platform images.EMULATED
- VM instances launch with emulated devices, such as the E1000 network driver and emulated SCSI disk controller.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.CUSTOM
- VM instances launch with custom configuration settings specified in theLaunchOptions
parameter.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- launch
Options List<Property Map> - Options for tuning the compatibility and performance of VM shapes. The values that you specify override any default values.
- listing
Type String - The listing type of the image. The default value is "NONE".
- operating
System String - The image's operating system. Example:
Oracle Linux
- operating
System StringVersion - The image's operating system version. Example:
7.2
- size
In StringMbs - The boot volume size for an instance launched from this image (1 MB = 1,048,576 bytes). Note this is not the same as the size of the image when it was exported or the actual size of the image. Example:
47694
- state String
- The current state of the image.
- time
Created String - The date and time the image was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
Supporting Types
ImageAgentFeature, ImageAgentFeatureArgs
- Is
Management boolSupported - This attribute is not used.
- Is
Monitoring boolSupported - This attribute is not used.
- Is
Management boolSupported - This attribute is not used.
- Is
Monitoring boolSupported - This attribute is not used.
- is
Management BooleanSupported - This attribute is not used.
- is
Monitoring BooleanSupported - This attribute is not used.
- is
Management booleanSupported - This attribute is not used.
- is
Monitoring booleanSupported - This attribute is not used.
- is_
management_ boolsupported - This attribute is not used.
- is_
monitoring_ boolsupported - This attribute is not used.
- is
Management BooleanSupported - This attribute is not used.
- is
Monitoring BooleanSupported - This attribute is not used.
ImageImageSourceDetails, ImageImageSourceDetailsArgs
- Source
Type string - The source type for the image. Use
objectStorageTuple
when specifying the namespace, bucket name, and object name. UseobjectStorageUri
when specifying the Object Storage URL. - Bucket
Name string - The Object Storage bucket for the image.
- Namespace
Name string - The Object Storage namespace for the image.
- Object
Name string - The Object Storage name for the image.
- Operating
System string - The image's operating system. Example:
Oracle Linux
- Operating
System stringVersion - The image's operating system version. Example:
7.2
- Source
Image stringType - The format of the image to be imported. Only monolithic images are supported. This attribute is not used for exported Oracle images with the Oracle Cloud Infrastructure image format. Allowed values are:
QCOW2
VMDK
- Source
Uri string - The Object Storage URL for the image.
- Source
Type string - The source type for the image. Use
objectStorageTuple
when specifying the namespace, bucket name, and object name. UseobjectStorageUri
when specifying the Object Storage URL. - Bucket
Name string - The Object Storage bucket for the image.
- Namespace
Name string - The Object Storage namespace for the image.
- Object
Name string - The Object Storage name for the image.
- Operating
System string - The image's operating system. Example:
Oracle Linux
- Operating
System stringVersion - The image's operating system version. Example:
7.2
- Source
Image stringType - The format of the image to be imported. Only monolithic images are supported. This attribute is not used for exported Oracle images with the Oracle Cloud Infrastructure image format. Allowed values are:
QCOW2
VMDK
- Source
Uri string - The Object Storage URL for the image.
- source
Type String - The source type for the image. Use
objectStorageTuple
when specifying the namespace, bucket name, and object name. UseobjectStorageUri
when specifying the Object Storage URL. - bucket
Name String - The Object Storage bucket for the image.
- namespace
Name String - The Object Storage namespace for the image.
- object
Name String - The Object Storage name for the image.
- operating
System String - The image's operating system. Example:
Oracle Linux
- operating
System StringVersion - The image's operating system version. Example:
7.2
- source
Image StringType - The format of the image to be imported. Only monolithic images are supported. This attribute is not used for exported Oracle images with the Oracle Cloud Infrastructure image format. Allowed values are:
QCOW2
VMDK
- source
Uri String - The Object Storage URL for the image.
- source
Type string - The source type for the image. Use
objectStorageTuple
when specifying the namespace, bucket name, and object name. UseobjectStorageUri
when specifying the Object Storage URL. - bucket
Name string - The Object Storage bucket for the image.
- namespace
Name string - The Object Storage namespace for the image.
- object
Name string - The Object Storage name for the image.
- operating
System string - The image's operating system. Example:
Oracle Linux
- operating
System stringVersion - The image's operating system version. Example:
7.2
- source
Image stringType - The format of the image to be imported. Only monolithic images are supported. This attribute is not used for exported Oracle images with the Oracle Cloud Infrastructure image format. Allowed values are:
QCOW2
VMDK
- source
Uri string - The Object Storage URL for the image.
- source_
type str - The source type for the image. Use
objectStorageTuple
when specifying the namespace, bucket name, and object name. UseobjectStorageUri
when specifying the Object Storage URL. - bucket_
name str - The Object Storage bucket for the image.
- namespace_
name str - The Object Storage namespace for the image.
- object_
name str - The Object Storage name for the image.
- operating_
system str - The image's operating system. Example:
Oracle Linux
- operating_
system_ strversion - The image's operating system version. Example:
7.2
- source_
image_ strtype - The format of the image to be imported. Only monolithic images are supported. This attribute is not used for exported Oracle images with the Oracle Cloud Infrastructure image format. Allowed values are:
QCOW2
VMDK
- source_
uri str - The Object Storage URL for the image.
- source
Type String - The source type for the image. Use
objectStorageTuple
when specifying the namespace, bucket name, and object name. UseobjectStorageUri
when specifying the Object Storage URL. - bucket
Name String - The Object Storage bucket for the image.
- namespace
Name String - The Object Storage namespace for the image.
- object
Name String - The Object Storage name for the image.
- operating
System String - The image's operating system. Example:
Oracle Linux
- operating
System StringVersion - The image's operating system version. Example:
7.2
- source
Image StringType - The format of the image to be imported. Only monolithic images are supported. This attribute is not used for exported Oracle images with the Oracle Cloud Infrastructure image format. Allowed values are:
QCOW2
VMDK
- source
Uri String - The Object Storage URL for the image.
ImageLaunchOption, ImageLaunchOptionArgs
- Boot
Volume stringType - Emulation type for the boot volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
- Firmware string
- Firmware used to boot VM. Select the option that matches your operating system.
BIOS
- Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating systems that boot using MBR style bootloaders.UEFI_64
- Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the default for platform images.
- Is
Consistent boolVolume Naming Enabled - Whether to enable consistent volume naming feature. Defaults to false.
- Is
Pv boolEncryption In Transit Enabled - Deprecated. Instead use
isPvEncryptionInTransitEnabled
in LaunchInstanceDetails. - Network
Type string - Emulation type for the physical network interface card (NIC).
E1000
- Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver.VFIO
- Direct attached Virtual Function network controller. This is the networking type when you launch an instance using hardware-assisted (SR-IOV) networking.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.
- Remote
Data stringVolume Type - Emulation type for volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
- Boot
Volume stringType - Emulation type for the boot volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
- Firmware string
- Firmware used to boot VM. Select the option that matches your operating system.
BIOS
- Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating systems that boot using MBR style bootloaders.UEFI_64
- Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the default for platform images.
- Is
Consistent boolVolume Naming Enabled - Whether to enable consistent volume naming feature. Defaults to false.
- Is
Pv boolEncryption In Transit Enabled - Deprecated. Instead use
isPvEncryptionInTransitEnabled
in LaunchInstanceDetails. - Network
Type string - Emulation type for the physical network interface card (NIC).
E1000
- Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver.VFIO
- Direct attached Virtual Function network controller. This is the networking type when you launch an instance using hardware-assisted (SR-IOV) networking.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.
- Remote
Data stringVolume Type - Emulation type for volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
- boot
Volume StringType - Emulation type for the boot volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
- firmware String
- Firmware used to boot VM. Select the option that matches your operating system.
BIOS
- Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating systems that boot using MBR style bootloaders.UEFI_64
- Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the default for platform images.
- is
Consistent BooleanVolume Naming Enabled - Whether to enable consistent volume naming feature. Defaults to false.
- is
Pv BooleanEncryption In Transit Enabled - Deprecated. Instead use
isPvEncryptionInTransitEnabled
in LaunchInstanceDetails. - network
Type String - Emulation type for the physical network interface card (NIC).
E1000
- Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver.VFIO
- Direct attached Virtual Function network controller. This is the networking type when you launch an instance using hardware-assisted (SR-IOV) networking.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.
- remote
Data StringVolume Type - Emulation type for volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
- boot
Volume stringType - Emulation type for the boot volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
- firmware string
- Firmware used to boot VM. Select the option that matches your operating system.
BIOS
- Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating systems that boot using MBR style bootloaders.UEFI_64
- Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the default for platform images.
- is
Consistent booleanVolume Naming Enabled - Whether to enable consistent volume naming feature. Defaults to false.
- is
Pv booleanEncryption In Transit Enabled - Deprecated. Instead use
isPvEncryptionInTransitEnabled
in LaunchInstanceDetails. - network
Type string - Emulation type for the physical network interface card (NIC).
E1000
- Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver.VFIO
- Direct attached Virtual Function network controller. This is the networking type when you launch an instance using hardware-assisted (SR-IOV) networking.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.
- remote
Data stringVolume Type - Emulation type for volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
- boot_
volume_ strtype - Emulation type for the boot volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
- firmware str
- Firmware used to boot VM. Select the option that matches your operating system.
BIOS
- Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating systems that boot using MBR style bootloaders.UEFI_64
- Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the default for platform images.
- is_
consistent_ boolvolume_ naming_ enabled - Whether to enable consistent volume naming feature. Defaults to false.
- is_
pv_ boolencryption_ in_ transit_ enabled - Deprecated. Instead use
isPvEncryptionInTransitEnabled
in LaunchInstanceDetails. - network_
type str - Emulation type for the physical network interface card (NIC).
E1000
- Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver.VFIO
- Direct attached Virtual Function network controller. This is the networking type when you launch an instance using hardware-assisted (SR-IOV) networking.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.
- remote_
data_ strvolume_ type - Emulation type for volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
- boot
Volume StringType - Emulation type for the boot volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
- firmware String
- Firmware used to boot VM. Select the option that matches your operating system.
BIOS
- Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating systems that boot using MBR style bootloaders.UEFI_64
- Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the default for platform images.
- is
Consistent BooleanVolume Naming Enabled - Whether to enable consistent volume naming feature. Defaults to false.
- is
Pv BooleanEncryption In Transit Enabled - Deprecated. Instead use
isPvEncryptionInTransitEnabled
in LaunchInstanceDetails. - network
Type String - Emulation type for the physical network interface card (NIC).
E1000
- Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver.VFIO
- Direct attached Virtual Function network controller. This is the networking type when you launch an instance using hardware-assisted (SR-IOV) networking.PARAVIRTUALIZED
- VM instances launch with paravirtualized devices using VirtIO drivers.
- remote
Data StringVolume Type - Emulation type for volume.
ISCSI
- ISCSI attached block storage device.SCSI
- Emulated SCSI disk.IDE
- Emulated IDE disk.VFIO
- Direct attached Virtual Function storage. This is the default option for local data volumes on platform images.PARAVIRTUALIZED
- Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on platform images.
Import
Images can be imported using the id
, e.g.
$ pulumi import oci:Core/image:Image test_image "id"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
oci
Terraform Provider.