## aws-ami (builder)

Search for and return an existing AMI.

### Interface

- Output: **ami.Image**

### Required Parameters

These parameters are used in the [`use` stanza](/docs/waypoint-hcl/use) for this plugin.

#### region

The AWS region to search in.

- Type: **string**

### Optional Parameters

These parameters are used in the [`use` stanza](/docs/waypoint-hcl/use) for this plugin.

#### filters

DescribeImage specific filters to search with.

The filters are always name => [value].

- Type: **map of string to list of string**
- **Optional**

#### name

The name of the AMI to search for, supports wildcards.

- Type: **string**
- **Optional**

#### owners

The set of AMI owners to restrict the search to.

- Type: **list of string**
- **Optional**

### Output Attributes

Output attributes can be used in your `waypoint.hcl` as [variables](/docs/waypoint-hcl/variables) via [`artifact`](/docs/waypoint-hcl/variables/artifact) or [`deploy`](/docs/waypoint-hcl/variables/deploy).

#### image

- Type: **string**
