aws-cdk-lib.aws_ec2.LookupMachineImage

class LookupMachineImage

LanguageType name
.NETAmazon.CDK.AWS.EC2.LookupMachineImage
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsec2#LookupMachineImage
Javasoftware.amazon.awscdk.services.ec2.LookupMachineImage
Pythonaws_cdk.aws_ec2.LookupMachineImage
TypeScript (source)aws-cdk-lib » aws_ec2 » LookupMachineImage

Implements IMachineImage

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.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_ec2 as ec2 } from 'aws-cdk-lib';

declare const userData: ec2.UserData;
const lookupMachineImage = new ec2.LookupMachineImage({
  name: 'name',

  // the properties below are optional
  filters: {
    filtersKey: ['filters'],
  },
  owners: ['owners'],
  userData: userData,
  windows: false,
});

Initializer

new LookupMachineImage(props: LookupMachineImageProps)

Parameters

  • props LookupMachineImageProps

Methods

NameDescription
getImage(scope)Return the image to use in the given context.

getImage(scope)

public getImage(scope: Construct): MachineImageConfig

Parameters

  • scope Construct

Returns

  • MachineImageConfig

Return the image to use in the given context.