imagebuilder/aws.sdk.kotlin.services.imagebuilder/importDiskImage

importDiskImage

inline suspend fun ImagebuilderClient.importDiskImage(crossinline block: ImportDiskImageRequest.Builder.() -> Unit): ImportDiskImageResponse

Imports a Windows operating system image from a verified Microsoft ISO disk file. The following disk images are supported:

Windows 11 Enterprise

The response returns as soon as Image Builder creates the new image resource in the PENDING state. The conversion from ISO file to AMI then runs asynchronously on an EC2 instance that Image Builder launches with the specified infrastructure configuration.

Samples

// The following example starts an image build that converts a Windows 11 ISO disk file stored in
// Amazon S3 into an AMI the imageBuildVersionArn in the response identifies the Image Builder image resource
// that tracks the build, not the output AMI.
val resp = imagebuilderClient.importDiskImage {
    name = "my-example-imported-image"
    semanticVersion = "1.0.0"
    platform = "Windows"
    osVersion = "Microsoft Windows 11"
    uri = "s3://amzn-s3-demo-bucket/Win11_23H2_English_x64.iso"
    infrastructureConfigurationArn = "arn:aws:imagebuilder:us-west-2:111122223333:infrastructure-configuration/my-example-infrastructure"
    clientToken = "a1b2c3d4-5678-90ab-cdef-EXAMPLE12345"
}