import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * Use this data source to get a list of AMI IDs matching the specified criteria. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const ubuntu = aws.ec2.getAmiIds({ * filters: [{ * name: "name", * values: ["ubuntu/images/ubuntu-*-*-amd64-server-*"], * }], * owners: ["099720109477"], * }); * ``` */ export declare function getAmiIds(args: GetAmiIdsArgs, opts?: pulumi.InvokeOptions): Promise; /** * A collection of arguments for invoking getAmiIds. */ export interface GetAmiIdsArgs { /** * Limit search to users with *explicit* launch permission on the image. Valid items are the numeric account ID or `self`. */ executableUsers?: string[]; /** * One or more name/value pairs to filter off of. For a full reference, check out [describe-images in the AWS CLI reference](http://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html). See `filter` Block below. */ filters?: inputs.ec2.GetAmiIdsFilter[]; /** * 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`. */ includeDeprecated?: boolean; /** * 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. */ nameRegex?: string; /** * 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`). */ owners: string[]; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: string; /** * Used to sort AMIs by creation time. If no value is specified, the default value is `false`. */ sortAscending?: boolean; } /** * A collection of values returned by getAmiIds. */ export interface GetAmiIdsResult { readonly executableUsers?: string[]; readonly filters?: outputs.ec2.GetAmiIdsFilter[]; /** * The provider-assigned unique ID for this managed resource. */ readonly id: string; /** * List of AMI IDs, sorted by creation time according to `sortAscending`. */ readonly ids: string[]; readonly includeDeprecated?: boolean; readonly nameRegex?: string; readonly owners: string[]; readonly region: string; readonly sortAscending?: boolean; } /** * Use this data source to get a list of AMI IDs matching the specified criteria. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const ubuntu = aws.ec2.getAmiIds({ * filters: [{ * name: "name", * values: ["ubuntu/images/ubuntu-*-*-amd64-server-*"], * }], * owners: ["099720109477"], * }); * ``` */ export declare function getAmiIdsOutput(args: GetAmiIdsOutputArgs, opts?: pulumi.InvokeOutputOptions): pulumi.Output; /** * A collection of arguments for invoking getAmiIds. */ export interface GetAmiIdsOutputArgs { /** * Limit search to users with *explicit* launch permission on the image. Valid items are the numeric account ID or `self`. */ executableUsers?: pulumi.Input[] | undefined>; /** * One or more name/value pairs to filter off of. For a full reference, check out [describe-images in the AWS CLI reference](http://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html). See `filter` Block below. */ filters?: pulumi.Input[] | undefined>; /** * 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`. */ includeDeprecated?: pulumi.Input; /** * 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. */ nameRegex?: pulumi.Input; /** * 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`). */ owners: pulumi.Input[]>; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Used to sort AMIs by creation time. If no value is specified, the default value is `false`. */ sortAscending?: pulumi.Input; } //# sourceMappingURL=getAmiIds.d.ts.map