software.amazon.awscdk.services.ec2

Class LookupMachineImage

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.ec2.LookupMachineImage

All Implemented Interfaces:

IMachineImage, software.amazon.jsii.JsiiSerializable

Direct Known Subclasses:

NatInstanceImage

@Generated(value="jsii-pacmak/1.30.0 (build adae23f)",
           date="2021-06-30T10:01:06.652Z")
 @Stability(value=Experimental)
public class LookupMachineImage
extends software.amazon.jsii.JsiiObject
implements IMachineImage

(experimental) A machine image whose AMI ID will be searched using DescribeImages.

The most recent, available, launchable image matching the given filter criteria will be used. Looking up AMIs may take a long time; specify as many filter criteria as possible to narrow down the search.

The AMI selected will be cached in cdk.context.json and the same value will be used on future runs. To refresh the AMI lookup, you will have to evict the value from the cache using the cdk context command. See https://docs.aws.amazon.com/cdk/latest/guide/context.html for more information.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LookupMachineImage.Builder (experimental) A fluent builder for LookupMachineImage.

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	LookupMachineImage(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	LookupMachineImage(software.amazon.jsii.JsiiObjectRef objRef)
	LookupMachineImage(LookupMachineImageProps props)

Method Summary

Modifier and Type	Method and Description
MachineImageConfig	getImage(software.constructs.Construct scope) (experimental) Return the image to use in the given context.

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

LookupMachineImage

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

LookupMachineImage

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

LookupMachineImage

@Stability(value=Experimental)
public LookupMachineImage(@NotNull
                                                         LookupMachineImageProps props)

Parameters:

props - This parameter is required.

Method Detail

getImage

@Stability(value=Experimental)
 @NotNull
public MachineImageConfig getImage(@NotNull
                                                                            software.constructs.Construct scope)

(experimental) Return the image to use in the given context.

Specified by:

getImage in interface IMachineImage

Parameters:

scope - This parameter is required.