software.amazon.awscdk.services.ec2

Class WindowsImage

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.ec2.GenericSSMParameterImage

software.amazon.awscdk.services.ec2.WindowsImage

All Implemented Interfaces:

IMachineImage, software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:38.526Z")
 @Stability(value=Stable)
public class WindowsImage
extends GenericSSMParameterImage

Select the latest version of the indicated Windows version.

This Machine Image automatically updates to the latest version on every deployment. Be aware this will cause your instances to be replaced when a new version of the image becomes available. Do not store stateful information on the instance if you are using this image.

The AMI ID is selected using the values published to the SSM parameter store.

https://aws.amazon.com/blogs/mt/query-for-the-latest-windows-ami-using-systems-manager-parameter-store/

Example:

 // Pick a Windows edition to use
 WindowsImage windows = new WindowsImage(WindowsVersion.WINDOWS_SERVER_2019_ENGLISH_FULL_BASE);
 // Pick the right Amazon Linux edition. All arguments shown are optional
 // and will default to these values when omitted.
 AmazonLinuxImage amznLinux = AmazonLinuxImage.Builder.create()
         .generation(AmazonLinuxGeneration.AMAZON_LINUX)
         .edition(AmazonLinuxEdition.STANDARD)
         .virtualization(AmazonLinuxVirt.HVM)
         .storage(AmazonLinuxStorage.GENERAL_PURPOSE)
         .build();
 // For other custom (Linux) images, instantiate a `GenericLinuxImage` with
 // a map giving the AMI to in for each region:
 GenericLinuxImage linux = new GenericLinuxImage(Map.of(
         "us-east-1", "ami-97785bed",
         "eu-west-1", "ami-12345678"));
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WindowsImage.Builder A fluent builder for WindowsImage.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.ec2.IMachineImage

IMachineImage.Jsii$Default, IMachineImage.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	WindowsImage(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	WindowsImage(software.amazon.jsii.JsiiObjectRef objRef)
	WindowsImage(WindowsVersion version)
	WindowsImage(WindowsVersion version, WindowsImageProps props)

Method Summary

Methods inherited from class software.amazon.awscdk.services.ec2.GenericSSMParameterImage

getImage, getParameterName

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

WindowsImage

protected WindowsImage(software.amazon.jsii.JsiiObjectRef objRef)

WindowsImage

protected WindowsImage(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

WindowsImage

@Stability(value=Stable)
public WindowsImage(@NotNull
                                             WindowsVersion version,
                                             @Nullable
                                             WindowsImageProps props)

Parameters:

version - This parameter is required.

props -

WindowsImage

@Stability(value=Stable)
public WindowsImage(@NotNull
                                             WindowsVersion version)

Parameters:

version - This parameter is required.