52 lines
1.5 KiB
Markdown
52 lines
1.5 KiB
Markdown
|
---
|
||
|
|
layout: "aws"
|
||
|
|
page_title: "AWS: aws_ami_ids"
|
||
|
|
sidebar_current: "docs-aws-datasource-ami-ids"
|
||
|
|
description: |-
|
||
|
|
Provides a list of AMI IDs.
|
||
|
|
---
|
||
|
|
|
||
|
|
# aws\_ami_ids
|
||
|
|
|
||
|
|
Use this data source to get a list of AMI IDs matching the specified criteria.
|
||
|
|
|
||
|
|
## Example Usage
|
||
|
|
|
||
|
|
```hcl
|
||
|
|
data "aws_ami_ids" "ubuntu" {
|
||
|
|
owners = ["099720109477"]
|
||
|
|
|
||
|
|
filter {
|
||
|
|
name = "name"
|
||
|
|
values = ["ubuntu/images/ubuntu-*-*-amd64-server-*"]
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Argument Reference
|
||
|
|
|
||
|
|
* `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][1].
|
||
|
|
|
||
|
|
* `owners` - (Optional) Limit search to specific AMI owners. Valid items are
|
||
|
|
the numeric account ID, `amazon`, or `self`.
|
||
|
|
|
||
|
|
* `name_regex` - (Optional) A 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. It is recommended to combine this with other
|
||
|
|
options to narrow down the list AWS returns.
|
||
|
|
|
||
|
|
~> **NOTE:** At least one of `executable_users`, `filter`, `owners` or
|
||
|
|
`name_regex` must be specified.
|
||
|
|
|
||
|
|
## Attributes Reference
|
||
|
|
|
||
|
|
`ids` is set to the list of AMI IDs.
|
||
|
|
|
||
|
|
[1]: http://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html
|