AmazonManagedImage

class aws_cdk.aws_imagebuilder_alpha.AmazonManagedImage

Bases: object

(experimental) Helper class for working with Amazon-managed images.

Stability:

experimental

ExampleMetadata:

infused

Example:

# Amazon Linux 2023 AMI for x86_64
amazon_linux2023_ami = imagebuilder.AmazonManagedImage.amazon_linux2023(self, "AmazonLinux2023",
    image_type=imagebuilder.ImageType.AMI,
    image_architecture=imagebuilder.ImageArchitecture.X86_64
)

# Ubuntu 22.04 AMI for ARM64
ubuntu2204_ami = imagebuilder.AmazonManagedImage.ubuntu_server2204(self, "Ubuntu2204",
    image_type=imagebuilder.ImageType.AMI,
    image_architecture=imagebuilder.ImageArchitecture.ARM64
)

# Windows Server 2022 Full AMI
windows2022_ami = imagebuilder.AmazonManagedImage.windows_server2022_full(self, "Windows2022",
    image_type=imagebuilder.ImageType.AMI,
    image_architecture=imagebuilder.ImageArchitecture.X86_64
)

# Use as base image in recipe
managed_image_recipe = imagebuilder.ImageRecipe(self, "ManagedImageRecipe",
    base_image=amazon_linux2023_ami.to_base_image()
)
Stability:

experimental

Static Methods

classmethod amazon_linux2(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Amazon Linux 2 Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://gallery.ecr.aws/amazonlinux/amazonlinux

Stability:

experimental

Return type:

IImage

classmethod amazon_linux2023(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Amazon Linux 2023 Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://gallery.ecr.aws/amazonlinux/amazonlinux

Stability:

experimental

Return type:

IImage

classmethod from_amazon_managed_image_attributes(scope, id, *, image_name, image_version=None)

(experimental) Imports an Amazon-managed image from its attributes.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_name (str) – (experimental) The name of the Amazon-managed image. The provided name must be normalized by converting all alphabetical characters to lowercase, and replacing all spaces and underscores with hyphens.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

Stability:

experimental

Return type:

IImage

classmethod from_amazon_managed_image_name(scope, id, amazon_managed_image_name)

(experimental) Imports an Amazon-managed image from its name.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • amazon_managed_image_name (str) –

    • The name of the Amazon-managed image.

Stability:

experimental

Return type:

IImage

classmethod mac_os14(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the macOS 14 Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-mac-instances.html

Stability:

experimental

Return type:

IImage

classmethod mac_os15(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the macOS 15 Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-mac-instances.html

Stability:

experimental

Return type:

IImage

classmethod red_hat_enterprise_linux10(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Red Hat Enterprise Linux 10 Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://aws.amazon.com/partners/redhat/faqs

Stability:

experimental

Return type:

IImage

classmethod suse_linux_enterprise_server15(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the SUSE Linux Enterprise Server 15 Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://aws.amazon.com/linux/commercial-linux/faqs/

Stability:

experimental

Return type:

IImage

classmethod ubuntu_server2204(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Ubuntu 22.04 Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://hub.docker.com/_/ubuntu

Stability:

experimental

Return type:

IImage

classmethod ubuntu_server2404(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Ubuntu 24.04 Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://hub.docker.com/_/ubuntu

Stability:

experimental

Return type:

IImage

classmethod windows_server2016_core(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Windows Server 2016 Core Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://hub.docker.com/r/microsoft/windows-servercore

Stability:

experimental

Return type:

IImage

classmethod windows_server2016_full(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Windows Server 2016 Full Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html

Stability:

experimental

Return type:

IImage

classmethod windows_server2019_core(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Windows Server 2019 Core Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://hub.docker.com/r/microsoft/windows-servercore

Stability:

experimental

Return type:

IImage

classmethod windows_server2019_full(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Windows Server 2019 Full Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html

Stability:

experimental

Return type:

IImage

classmethod windows_server2022_core(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Windows Server 2022 Core Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html

Stability:

experimental

Return type:

IImage

classmethod windows_server2022_full(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Windows Server 2022 Full Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html

Stability:

experimental

Return type:

IImage

classmethod windows_server2025_core(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Windows Server 2025 Core Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html

Stability:

experimental

Return type:

IImage

classmethod windows_server2025_full(scope, id, *, image_architecture, image_type, image_version=None)

(experimental) Imports the Windows Server 2025 Full Amazon-managed image.

Parameters:

  • scope (Construct) – The construct scope.

  • id (str) – Identifier of the construct.

  • image_architecture (ImageArchitecture) – (experimental) The architecture of the Amazon-managed image.

  • image_type (ImageType) – (experimental) The type of the Amazon-managed image.

  • image_version (Optional[str]) – (experimental) The version of the Amazon-managed image. Default: x.x.x

See:

https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html

Stability:

experimental

Return type:

IImage