package awsec2

import (
	_init_ "github.com/aws/aws-cdk-go/awscdk/v2/jsii"
	_jsii_ "github.com/aws/jsii-runtime-go/runtime"
)

// Factory functions for standard Amazon Machine Image objects.
//
// Example:
//   var vpc vpc
//
//
//   mySecurityGroup := ec2.NewSecurityGroup(this, jsii.String("SecurityGroup"), &SecurityGroupProps{
//   	Vpc: Vpc,
//   })
//   autoscaling.NewAutoScalingGroup(this, jsii.String("ASG"), &AutoScalingGroupProps{
//   	Vpc: Vpc,
//   	InstanceType: ec2.InstanceType_Of(ec2.InstanceClass_BURSTABLE2, ec2.InstanceSize_MICRO),
//   	MachineImage: ec2.MachineImage_LatestAmazonLinux(&AmazonLinuxImageProps{
//   		Generation: ec2.AmazonLinuxGeneration_AMAZON_LINUX_2,
//   	}),
//   	SecurityGroup: mySecurityGroup,
//   })
//
type MachineImage interface {
}

// The jsii proxy struct for MachineImage
type jsiiProxy_MachineImage struct {
	_ byte // padding
}

func NewMachineImage_Override(m MachineImage) {
	_init_.Initialize()

	_jsii_.Create(
		"aws-cdk-lib.aws_ec2.MachineImage",
		nil, // no parameters
		m,
	)
}

// An image specified in SSM parameter store.
//
// By default, the SSM parameter is refreshed at every deployment,
// causing your instances to be replaced whenever a new version of the AMI
// is released.
//
// Pass `{ cachedInContext: true }` to keep the AMI ID stable. If you do, you
// will have to remember to periodically invalidate the context to refresh
// to the newest AMI ID.
func MachineImage_FromSsmParameter(parameterName *string, options *SsmParameterImageOptions) IMachineImage {
	_init_.Initialize()

	if err := validateMachineImage_FromSsmParameterParameters(parameterName, options); err != nil {
		panic(err)
	}
	var returns IMachineImage

	_jsii_.StaticInvoke(
		"aws-cdk-lib.aws_ec2.MachineImage",
		"fromSsmParameter",
		[]interface{}{parameterName, options},
		&returns,
	)

	return returns
}

// A Linux image where you specify the AMI ID for every region.
func MachineImage_GenericLinux(amiMap *map[string]*string, props *GenericLinuxImageProps) IMachineImage {
	_init_.Initialize()

	if err := validateMachineImage_GenericLinuxParameters(amiMap, props); err != nil {
		panic(err)
	}
	var returns IMachineImage

	_jsii_.StaticInvoke(
		"aws-cdk-lib.aws_ec2.MachineImage",
		"genericLinux",
		[]interface{}{amiMap, props},
		&returns,
	)

	return returns
}

// A Windows image where you specify the AMI ID for every region.
func MachineImage_GenericWindows(amiMap *map[string]*string, props *GenericWindowsImageProps) IMachineImage {
	_init_.Initialize()

	if err := validateMachineImage_GenericWindowsParameters(amiMap, props); err != nil {
		panic(err)
	}
	var returns IMachineImage

	_jsii_.StaticInvoke(
		"aws-cdk-lib.aws_ec2.MachineImage",
		"genericWindows",
		[]interface{}{amiMap, props},
		&returns,
	)

	return returns
}

// An Amazon Linux image that is automatically kept up-to-date.
//
// 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.
//
// N.B.: "latest" in the name of this function indicates that it always uses the most recent
// image of a particular generation of Amazon Linux, not that it uses the "latest generation".
// For backwards compatibility, this function uses Amazon Linux 1 if no generation
// is specified.
//
// Specify the desired generation using the `generation` property:
//
// ```ts
// ec2.MachineImage.latestAmazonLinux({
//   // Use Amazon Linux 2
//   generation: ec2.AmazonLinuxGeneration.AMAZON_LINUX_2,
// })
// ```.
// Deprecated: use MachineImage.latestAmazonLinux2 instead
func MachineImage_LatestAmazonLinux(props *AmazonLinuxImageProps) IMachineImage {
	_init_.Initialize()

	if err := validateMachineImage_LatestAmazonLinuxParameters(props); err != nil {
		panic(err)
	}
	var returns IMachineImage

	_jsii_.StaticInvoke(
		"aws-cdk-lib.aws_ec2.MachineImage",
		"latestAmazonLinux",
		[]interface{}{props},
		&returns,
	)

	return returns
}

// An Amazon Linux 2 image that is automatically kept up-to-date.
//
// 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.
func MachineImage_LatestAmazonLinux2(props *AmazonLinux2ImageSsmParameterProps) IMachineImage {
	_init_.Initialize()

	if err := validateMachineImage_LatestAmazonLinux2Parameters(props); err != nil {
		panic(err)
	}
	var returns IMachineImage

	_jsii_.StaticInvoke(
		"aws-cdk-lib.aws_ec2.MachineImage",
		"latestAmazonLinux2",
		[]interface{}{props},
		&returns,
	)

	return returns
}

// An Amazon Linux 2022 image that is automatically kept up-to-date.
//
// 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.
// Deprecated: - use latestAmazonLinux2023() instead.
func MachineImage_LatestAmazonLinux2022(props *AmazonLinux2022ImageSsmParameterProps) IMachineImage {
	_init_.Initialize()

	if err := validateMachineImage_LatestAmazonLinux2022Parameters(props); err != nil {
		panic(err)
	}
	var returns IMachineImage

	_jsii_.StaticInvoke(
		"aws-cdk-lib.aws_ec2.MachineImage",
		"latestAmazonLinux2022",
		[]interface{}{props},
		&returns,
	)

	return returns
}

// An Amazon Linux 2023 image that is automatically kept up-to-date.
//
// 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.
func MachineImage_LatestAmazonLinux2023(props *AmazonLinux2023ImageSsmParameterProps) IMachineImage {
	_init_.Initialize()

	if err := validateMachineImage_LatestAmazonLinux2023Parameters(props); err != nil {
		panic(err)
	}
	var returns IMachineImage

	_jsii_.StaticInvoke(
		"aws-cdk-lib.aws_ec2.MachineImage",
		"latestAmazonLinux2023",
		[]interface{}{props},
		&returns,
	)

	return returns
}

// A Windows image that is automatically kept up-to-date.
//
// 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.
func MachineImage_LatestWindows(version WindowsVersion, props *WindowsImageProps) IMachineImage {
	_init_.Initialize()

	if err := validateMachineImage_LatestWindowsParameters(version, props); err != nil {
		panic(err)
	}
	var returns IMachineImage

	_jsii_.StaticInvoke(
		"aws-cdk-lib.aws_ec2.MachineImage",
		"latestWindows",
		[]interface{}{version, props},
		&returns,
	)

	return returns
}

// Look up a shared Machine Image 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.
//
// This function can not be used in environment-agnostic stacks.
func MachineImage_Lookup(props *LookupMachineImageProps) IMachineImage {
	_init_.Initialize()

	if err := validateMachineImage_LookupParameters(props); err != nil {
		panic(err)
	}
	var returns IMachineImage

	_jsii_.StaticInvoke(
		"aws-cdk-lib.aws_ec2.MachineImage",
		"lookup",
		[]interface{}{props},
		&returns,
	)

	return returns
}

// An image specified in SSM parameter store that will be resolved at instance launch time.
//
// The AMI ID will be resolved at instance launch time.
// See: https://docs.aws.amazon.com/autoscaling/ec2/userguide/using-systems-manager-parameters.html
//
func MachineImage_ResolveSsmParameterAtLaunch(parameterName *string, options *SsmParameterImageOptions) IMachineImage {
	_init_.Initialize()

	if err := validateMachineImage_ResolveSsmParameterAtLaunchParameters(parameterName, options); err != nil {
		panic(err)
	}
	var returns IMachineImage

	_jsii_.StaticInvoke(
		"aws-cdk-lib.aws_ec2.MachineImage",
		"resolveSsmParameterAtLaunch",
		[]interface{}{parameterName, options},
		&returns,
	)

	return returns
}