github.com/pulumi/pulumi-aws/sdk/v6@v6.32.0/go/aws/ec2/amiLaunchPermission.go

// Code generated by the Pulumi Terraform Bridge (tfgen) Tool DO NOT EDIT.
// *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***

package ec2

import (
	"context"
	"reflect"

	"errors"
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/internal"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

// Adds a launch permission to an Amazon Machine Image (AMI).
//
// ## Example Usage
//
// ### AWS Account ID
//
// <!--Start PulumiCodeChooser -->
// ```go
// package main
//
// import (
//
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
//	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
//
// )
//
//	func main() {
//		pulumi.Run(func(ctx *pulumi.Context) error {
//			_, err := ec2.NewAmiLaunchPermission(ctx, "example", &ec2.AmiLaunchPermissionArgs{
//				ImageId:   pulumi.String("ami-12345678"),
//				AccountId: pulumi.String("123456789012"),
//			})
//			if err != nil {
//				return err
//			}
//			return nil
//		})
//	}
//
// ```
// <!--End PulumiCodeChooser -->
//
// ### Public Access
//
// <!--Start PulumiCodeChooser -->
// ```go
// package main
//
// import (
//
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
//	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
//
// )
//
//	func main() {
//		pulumi.Run(func(ctx *pulumi.Context) error {
//			_, err := ec2.NewAmiLaunchPermission(ctx, "example", &ec2.AmiLaunchPermissionArgs{
//				ImageId: pulumi.String("ami-12345678"),
//				Group:   pulumi.String("all"),
//			})
//			if err != nil {
//				return err
//			}
//			return nil
//		})
//	}
//
// ```
// <!--End PulumiCodeChooser -->
//
// ### Organization Access
//
// <!--Start PulumiCodeChooser -->
// ```go
// package main
//
// import (
//
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/organizations"
//	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
//
// )
//
//	func main() {
//		pulumi.Run(func(ctx *pulumi.Context) error {
//			current, err := organizations.LookupOrganization(ctx, nil, nil)
//			if err != nil {
//				return err
//			}
//			_, err = ec2.NewAmiLaunchPermission(ctx, "example", &ec2.AmiLaunchPermissionArgs{
//				ImageId:         pulumi.String("ami-12345678"),
//				OrganizationArn: pulumi.String(current.Arn),
//			})
//			if err != nil {
//				return err
//			}
//			return nil
//		})
//	}
//
// ```
// <!--End PulumiCodeChooser -->
//
// ## Import
//
// Using `pulumi import`, import AMI Launch Permissions using `[ACCOUNT-ID|GROUP-NAME|ORGANIZATION-ARN|ORGANIZATIONAL-UNIT-ARN]/IMAGE-ID`. For example:
//
// ```sh
// $ pulumi import aws:ec2/amiLaunchPermission:AmiLaunchPermission example 123456789012/ami-12345678
// ```
type AmiLaunchPermission struct {
	pulumi.CustomResourceState

	// AWS account ID for the launch permission.
	AccountId pulumi.StringPtrOutput `pulumi:"accountId"`
	// Name of the group for the launch permission. Valid values: `"all"`.
	Group pulumi.StringPtrOutput `pulumi:"group"`
	// ID of the AMI.
	ImageId pulumi.StringOutput `pulumi:"imageId"`
	// ARN of an organization for the launch permission.
	OrganizationArn pulumi.StringPtrOutput `pulumi:"organizationArn"`
	// ARN of an organizational unit for the launch permission.
	OrganizationalUnitArn pulumi.StringPtrOutput `pulumi:"organizationalUnitArn"`
}

// NewAmiLaunchPermission registers a new resource with the given unique name, arguments, and options.
func NewAmiLaunchPermission(ctx *pulumi.Context,
	name string, args *AmiLaunchPermissionArgs, opts ...pulumi.ResourceOption) (*AmiLaunchPermission, error) {
	if args == nil {
		return nil, errors.New("missing one or more required arguments")
	}

	if args.ImageId == nil {
		return nil, errors.New("invalid value for required argument 'ImageId'")
	}
	opts = internal.PkgResourceDefaultOpts(opts)
	var resource AmiLaunchPermission
	err := ctx.RegisterResource("aws:ec2/amiLaunchPermission:AmiLaunchPermission", name, args, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// GetAmiLaunchPermission gets an existing AmiLaunchPermission resource's state with the given name, ID, and optional
// state properties that are used to uniquely qualify the lookup (nil if not required).
func GetAmiLaunchPermission(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *AmiLaunchPermissionState, opts ...pulumi.ResourceOption) (*AmiLaunchPermission, error) {
	var resource AmiLaunchPermission
	err := ctx.ReadResource("aws:ec2/amiLaunchPermission:AmiLaunchPermission", name, id, state, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// Input properties used for looking up and filtering AmiLaunchPermission resources.
type amiLaunchPermissionState struct {
	// AWS account ID for the launch permission.
	AccountId *string `pulumi:"accountId"`
	// Name of the group for the launch permission. Valid values: `"all"`.
	Group *string `pulumi:"group"`
	// ID of the AMI.
	ImageId *string `pulumi:"imageId"`
	// ARN of an organization for the launch permission.
	OrganizationArn *string `pulumi:"organizationArn"`
	// ARN of an organizational unit for the launch permission.
	OrganizationalUnitArn *string `pulumi:"organizationalUnitArn"`
}

type AmiLaunchPermissionState struct {
	// AWS account ID for the launch permission.
	AccountId pulumi.StringPtrInput
	// Name of the group for the launch permission. Valid values: `"all"`.
	Group pulumi.StringPtrInput
	// ID of the AMI.
	ImageId pulumi.StringPtrInput
	// ARN of an organization for the launch permission.
	OrganizationArn pulumi.StringPtrInput
	// ARN of an organizational unit for the launch permission.
	OrganizationalUnitArn pulumi.StringPtrInput
}

func (AmiLaunchPermissionState) ElementType() reflect.Type {
	return reflect.TypeOf((*amiLaunchPermissionState)(nil)).Elem()
}

type amiLaunchPermissionArgs struct {
	// AWS account ID for the launch permission.
	AccountId *string `pulumi:"accountId"`
	// Name of the group for the launch permission. Valid values: `"all"`.
	Group *string `pulumi:"group"`
	// ID of the AMI.
	ImageId string `pulumi:"imageId"`
	// ARN of an organization for the launch permission.
	OrganizationArn *string `pulumi:"organizationArn"`
	// ARN of an organizational unit for the launch permission.
	OrganizationalUnitArn *string `pulumi:"organizationalUnitArn"`
}

// The set of arguments for constructing a AmiLaunchPermission resource.
type AmiLaunchPermissionArgs struct {
	// AWS account ID for the launch permission.
	AccountId pulumi.StringPtrInput
	// Name of the group for the launch permission. Valid values: `"all"`.
	Group pulumi.StringPtrInput
	// ID of the AMI.
	ImageId pulumi.StringInput
	// ARN of an organization for the launch permission.
	OrganizationArn pulumi.StringPtrInput
	// ARN of an organizational unit for the launch permission.
	OrganizationalUnitArn pulumi.StringPtrInput
}

func (AmiLaunchPermissionArgs) ElementType() reflect.Type {
	return reflect.TypeOf((*amiLaunchPermissionArgs)(nil)).Elem()
}

type AmiLaunchPermissionInput interface {
	pulumi.Input

	ToAmiLaunchPermissionOutput() AmiLaunchPermissionOutput
	ToAmiLaunchPermissionOutputWithContext(ctx context.Context) AmiLaunchPermissionOutput
}

func (*AmiLaunchPermission) ElementType() reflect.Type {
	return reflect.TypeOf((**AmiLaunchPermission)(nil)).Elem()
}

func (i *AmiLaunchPermission) ToAmiLaunchPermissionOutput() AmiLaunchPermissionOutput {
	return i.ToAmiLaunchPermissionOutputWithContext(context.Background())
}

func (i *AmiLaunchPermission) ToAmiLaunchPermissionOutputWithContext(ctx context.Context) AmiLaunchPermissionOutput {
	return pulumi.ToOutputWithContext(ctx, i).(AmiLaunchPermissionOutput)
}

// AmiLaunchPermissionArrayInput is an input type that accepts AmiLaunchPermissionArray and AmiLaunchPermissionArrayOutput values.
// You can construct a concrete instance of `AmiLaunchPermissionArrayInput` via:
//
//	AmiLaunchPermissionArray{ AmiLaunchPermissionArgs{...} }
type AmiLaunchPermissionArrayInput interface {
	pulumi.Input

	ToAmiLaunchPermissionArrayOutput() AmiLaunchPermissionArrayOutput
	ToAmiLaunchPermissionArrayOutputWithContext(context.Context) AmiLaunchPermissionArrayOutput
}

type AmiLaunchPermissionArray []AmiLaunchPermissionInput

func (AmiLaunchPermissionArray) ElementType() reflect.Type {
	return reflect.TypeOf((*[]*AmiLaunchPermission)(nil)).Elem()
}

func (i AmiLaunchPermissionArray) ToAmiLaunchPermissionArrayOutput() AmiLaunchPermissionArrayOutput {
	return i.ToAmiLaunchPermissionArrayOutputWithContext(context.Background())
}

func (i AmiLaunchPermissionArray) ToAmiLaunchPermissionArrayOutputWithContext(ctx context.Context) AmiLaunchPermissionArrayOutput {
	return pulumi.ToOutputWithContext(ctx, i).(AmiLaunchPermissionArrayOutput)
}

// AmiLaunchPermissionMapInput is an input type that accepts AmiLaunchPermissionMap and AmiLaunchPermissionMapOutput values.
// You can construct a concrete instance of `AmiLaunchPermissionMapInput` via:
//
//	AmiLaunchPermissionMap{ "key": AmiLaunchPermissionArgs{...} }
type AmiLaunchPermissionMapInput interface {
	pulumi.Input

	ToAmiLaunchPermissionMapOutput() AmiLaunchPermissionMapOutput
	ToAmiLaunchPermissionMapOutputWithContext(context.Context) AmiLaunchPermissionMapOutput
}

type AmiLaunchPermissionMap map[string]AmiLaunchPermissionInput

func (AmiLaunchPermissionMap) ElementType() reflect.Type {
	return reflect.TypeOf((*map[string]*AmiLaunchPermission)(nil)).Elem()
}

func (i AmiLaunchPermissionMap) ToAmiLaunchPermissionMapOutput() AmiLaunchPermissionMapOutput {
	return i.ToAmiLaunchPermissionMapOutputWithContext(context.Background())
}

func (i AmiLaunchPermissionMap) ToAmiLaunchPermissionMapOutputWithContext(ctx context.Context) AmiLaunchPermissionMapOutput {
	return pulumi.ToOutputWithContext(ctx, i).(AmiLaunchPermissionMapOutput)
}

type AmiLaunchPermissionOutput struct{ *pulumi.OutputState }

func (AmiLaunchPermissionOutput) ElementType() reflect.Type {
	return reflect.TypeOf((**AmiLaunchPermission)(nil)).Elem()
}

func (o AmiLaunchPermissionOutput) ToAmiLaunchPermissionOutput() AmiLaunchPermissionOutput {
	return o
}

func (o AmiLaunchPermissionOutput) ToAmiLaunchPermissionOutputWithContext(ctx context.Context) AmiLaunchPermissionOutput {
	return o
}

// AWS account ID for the launch permission.
func (o AmiLaunchPermissionOutput) AccountId() pulumi.StringPtrOutput {
	return o.ApplyT(func(v *AmiLaunchPermission) pulumi.StringPtrOutput { return v.AccountId }).(pulumi.StringPtrOutput)
}

// Name of the group for the launch permission. Valid values: `"all"`.
func (o AmiLaunchPermissionOutput) Group() pulumi.StringPtrOutput {
	return o.ApplyT(func(v *AmiLaunchPermission) pulumi.StringPtrOutput { return v.Group }).(pulumi.StringPtrOutput)
}

// ID of the AMI.
func (o AmiLaunchPermissionOutput) ImageId() pulumi.StringOutput {
	return o.ApplyT(func(v *AmiLaunchPermission) pulumi.StringOutput { return v.ImageId }).(pulumi.StringOutput)
}

// ARN of an organization for the launch permission.
func (o AmiLaunchPermissionOutput) OrganizationArn() pulumi.StringPtrOutput {
	return o.ApplyT(func(v *AmiLaunchPermission) pulumi.StringPtrOutput { return v.OrganizationArn }).(pulumi.StringPtrOutput)
}

// ARN of an organizational unit for the launch permission.
func (o AmiLaunchPermissionOutput) OrganizationalUnitArn() pulumi.StringPtrOutput {
	return o.ApplyT(func(v *AmiLaunchPermission) pulumi.StringPtrOutput { return v.OrganizationalUnitArn }).(pulumi.StringPtrOutput)
}

type AmiLaunchPermissionArrayOutput struct{ *pulumi.OutputState }

func (AmiLaunchPermissionArrayOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*[]*AmiLaunchPermission)(nil)).Elem()
}

func (o AmiLaunchPermissionArrayOutput) ToAmiLaunchPermissionArrayOutput() AmiLaunchPermissionArrayOutput {
	return o
}

func (o AmiLaunchPermissionArrayOutput) ToAmiLaunchPermissionArrayOutputWithContext(ctx context.Context) AmiLaunchPermissionArrayOutput {
	return o
}

func (o AmiLaunchPermissionArrayOutput) Index(i pulumi.IntInput) AmiLaunchPermissionOutput {
	return pulumi.All(o, i).ApplyT(func(vs []interface{}) *AmiLaunchPermission {
		return vs[0].([]*AmiLaunchPermission)[vs[1].(int)]
	}).(AmiLaunchPermissionOutput)
}

type AmiLaunchPermissionMapOutput struct{ *pulumi.OutputState }

func (AmiLaunchPermissionMapOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*map[string]*AmiLaunchPermission)(nil)).Elem()
}

func (o AmiLaunchPermissionMapOutput) ToAmiLaunchPermissionMapOutput() AmiLaunchPermissionMapOutput {
	return o
}

func (o AmiLaunchPermissionMapOutput) ToAmiLaunchPermissionMapOutputWithContext(ctx context.Context) AmiLaunchPermissionMapOutput {
	return o
}

func (o AmiLaunchPermissionMapOutput) MapIndex(k pulumi.StringInput) AmiLaunchPermissionOutput {
	return pulumi.All(o, k).ApplyT(func(vs []interface{}) *AmiLaunchPermission {
		return vs[0].(map[string]*AmiLaunchPermission)[vs[1].(string)]
	}).(AmiLaunchPermissionOutput)
}

func init() {
	pulumi.RegisterInputType(reflect.TypeOf((*AmiLaunchPermissionInput)(nil)).Elem(), &AmiLaunchPermission{})
	pulumi.RegisterInputType(reflect.TypeOf((*AmiLaunchPermissionArrayInput)(nil)).Elem(), AmiLaunchPermissionArray{})
	pulumi.RegisterInputType(reflect.TypeOf((*AmiLaunchPermissionMapInput)(nil)).Elem(), AmiLaunchPermissionMap{})
	pulumi.RegisterOutputType(AmiLaunchPermissionOutput{})
	pulumi.RegisterOutputType(AmiLaunchPermissionArrayOutput{})
	pulumi.RegisterOutputType(AmiLaunchPermissionMapOutput{})
}