ipam_prefix_list_resolver_versions

Creates, updates, deletes, gets or lists an ipam_prefix_list_resolver_versions resource.

Overview

Name	ipam_prefix_list_resolver_versions
Type	Resource
Id	aws.ec2.ipam_prefix_list_resolver_versions

Fields

The following fields are returned by SELECT queries:

get_ipam_prefix_list_resolver_versions

Name	Datatype	Description
version	integer	The version number of the IPAM prefix list resolver. Each version is a snapshot of what CIDRs matched your rules at that moment in time. The version number increments every time the CIDR list changes due to infrastructure changes.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_ipam_prefix_list_resolver_versions	select	IpamPrefixListResolverId, region	DryRun, IpamPrefixListResolverVersion, MaxResults, Filter, NextToken	Retrieves version information for an IPAM prefix list resolver. Each version is a snapshot of what CIDRs matched your rules at that moment in time. The version number increments every time the CIDR list changes due to infrastructure changes. Version example: Initial State (Version 1) Production environment: vpc-prod-web (10.1.0.0/16) - tagged env=prod vpc-prod-db (10.2.0.0/16) - tagged env=prod Resolver rule: Include all VPCs tagged env=prod Version 1 CIDRs: 10.1.0.0/16, 10.2.0.0/16 Infrastructure Change (Version 2) New VPC added: vpc-prod-api (10.3.0.0/16) - tagged env=prod IPAM automatically detects the change and creates a new version. Version 2 CIDRs: 10.1.0.0/16, 10.2.0.0/16, 10.3.0.0/16

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
IpamPrefixListResolverId	string	The ID of the IPAM prefix list resolver whose versions you want to retrieve.
region	string	AWS region (default: us-east-1)
DryRun	boolean	A check for whether you have the required permissions for the action without actually making the request and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Filter	array	One or more filters to limit the results.
IpamPrefixListResolverVersion	array	Specific version numbers to retrieve. If not specified, all versions are returned.
MaxResults	integer	The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output. For more information, see Pagination.
NextToken	string	The token for the next page of results.

SELECT examples

get_ipam_prefix_list_resolver_versions

Retrieves version information for an IPAM prefix list resolver. Each version is a snapshot of what CIDRs matched your rules at that moment in time. The version number increments every time the CIDR list changes due to infrastructure changes. Version example: Initial State (Version 1) Production environment: vpc-prod-web (10.1.0.0/16) - tagged env=prod vpc-prod-db (10.2.0.0/16) - tagged env=prod Resolver rule: Include all VPCs tagged env=prod Version 1 CIDRs: 10.1.0.0/16, 10.2.0.0/16 Infrastructure Change (Version 2) New VPC added: vpc-prod-api (10.3.0.0/16) - tagged env=prod IPAM automatically detects the change and creates a new version. Version 2 CIDRs: 10.1.0.0/16, 10.2.0.0/16, 10.3.0.0/16

SELECT
version
FROM aws.ec2.ipam_prefix_list_resolver_versions
WHERE IpamPrefixListResolverId = '{{ IpamPrefixListResolverId }}' -- required
AND region = '{{ region }}' -- required
AND DryRun = '{{ DryRun }}'
AND IpamPrefixListResolverVersion = '{{ IpamPrefixListResolverVersion }}'
AND MaxResults = '{{ MaxResults }}'
AND Filter = '{{ Filter }}'
AND NextToken = '{{ NextToken }}'
;