Skip to content

Latest commit

 

History

History
59 lines (41 loc) · 2 KB

ami_ids.html.markdown

File metadata and controls

59 lines (41 loc) · 2 KB
Raw
subcategory layout page_title description
EC2 (Elastic Compute Cloud)
aws
AWS: aws_ami_ids
Provides a list of AMI IDs.

Data Source: aws_ami_ids

Use this data source to get a list of AMI IDs matching the specified criteria.

Example Usage

data "aws_ami_ids" "ubuntu" {
  owners = ["099720109477"]

  filter {
    name   = "name"
    values = ["ubuntu/images/ubuntu-*-*-amd64-server-*"]
  }
}

Argument Reference

  • owners - (Required) List of AMI owners to limit search. At least 1 value must be specified. Valid values: an AWS account ID, self (the current account), or an AWS owner alias (e.g., amazon, aws-marketplace, microsoft).

  • executable_users - (Optional) Limit search to users with explicit launch permission on the image. Valid items are the numeric account ID or self.

  • filter - (Optional) One or more name/value pairs to filter off of. There are several valid keys, for a full reference, check out describe-images in the AWS CLI reference.

  • name_regex - (Optional) Regex string to apply to the AMI list returned by AWS. This allows more advanced filtering not supported from the AWS API. This filtering is done locally on what AWS returns, and could have a performance impact if the result is large. Combine this with other options to narrow down the list AWS returns.

  • sort_ascending - (Optional) Used to sort AMIs by creation time. If no value is specified, the default value is false.

  • include_deprecated - (Optional) If true, all deprecated AMIs are included in the response. If false, no deprecated AMIs are included in the response. If no value is specified, the default value is false.

Attribute Reference

ids is set to the list of AMI IDs, sorted by creation time according to sort_ascending.

Timeouts

Configuration options:

  • read - (Default 20m)