Skip to content

Get Ipam Prefix List Resolver Versions

ec2_get_ipam_prefix_list_resolver_versions R Documentation

Retrieves version information for an IPAM prefix list resolver

Description

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

Usage

ec2_get_ipam_prefix_list_resolver_versions(DryRun,
  IpamPrefixListResolverId, IpamPrefixListResolverVersions, MaxResults,
  Filters, NextToken)

Arguments

DryRun

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.
IpamPrefixListResolverId

[required] The ID of the IPAM prefix list resolver whose versions you want to retrieve.
IpamPrefixListResolverVersions

Specific version numbers to retrieve. If not specified, all versions are returned.
MaxResults

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.
Filters

One or more filters to limit the results.
NextToken

The token for the next page of results.

Value

A list with the following syntax:

list(
  IpamPrefixListResolverVersions = list(
    list(
      Version = 123
    )
  ),
  NextToken = "string"
)

Request syntax

svc$get_ipam_prefix_list_resolver_versions(
  DryRun = TRUE|FALSE,
  IpamPrefixListResolverId = "string",
  IpamPrefixListResolverVersions = list(
    123
  ),
  MaxResults = 123,
  Filters = list(
    list(
      Name = "string",
      Values = list(
        "string"
      )
    )
  ),
  NextToken = "string"
)