Resource: aws_ami_launch_permission

Adds a launch permission to an Amazon Machine Image (AMI).

Example Usage

AWS Account ID

resource "aws_ami_launch_permission" "example" {
  image_id   = "ami-12345678"
  account_id = "123456789012"
}

Public Access

resource "aws_ami_launch_permission" "example" {
  image_id = "ami-12345678"
  group    = "all"
}

Organization Access

data "aws_organizations_organization" "current" {}

resource "aws_ami_launch_permission" "example" {
  image_id         = "ami-12345678"
  organization_arn = data.aws_organizations_organization.current.arn
}

Argument Reference

This resource supports the following arguments:

Attribute Reference

This resource exports the following attributes in addition to the arguments above:

Import

In Terraform v1.5.0 and later, use an import block to import AMI Launch Permissions using [ACCOUNT-ID|GROUP-NAME|ORGANIZATION-ARN|ORGANIZATIONAL-UNIT-ARN]/IMAGE-ID. For example:

import {
  to = aws_ami_launch_permission.example
  id = "123456789012/ami-12345678"
}

Using terraform import, import AMI Launch Permissions using [ACCOUNT-ID|GROUP-NAME|ORGANIZATION-ARN|ORGANIZATIONAL-UNIT-ARN]/IMAGE-ID. For example:

% terraform import aws_ami_launch_permission.example 123456789012/ami-12345678