Skip to content

Retrieves route protection findings for an IPAM

Description

Retrieves route protection findings for an IPAM. Route protection findings show the Resource Public Key Infrastructure (RPKI) validation status of your Bring Your Own IP (BYOIP) routes. Findings identify routes that have valid, invalid, or unknown validation states. We recommend using pagination to ensure that the operation returns quickly and successfully.

Usage

ec2_get_ipam_route_protection_findings(DryRun, IpamId, Filters,
  NextToken, MaxResults)

Arguments

  • DryRun

    Checks whether you have the required permissions for the operation, 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.

  • IpamId

    [required] The ID of the IPAM to retrieve route protection findings for.

  • Filters

    One or more filters to apply to the results.

  • NextToken

    The token for the next page of results.

  • MaxResults

    The maximum number of results to return in a single call. If not specified, all available results are returned. To retrieve the remaining results, make another call with the returned nextToken value.

Value

A list with the following syntax:

list(
  IpamId = "string",
  RouteProtectionFindings = list(
    list(
      ResourceOwnerId = "string",
      ResourceRegion = "string",
      IpamPoolId = "string",
      Cidr = "string",
      State = "advertised"|"deprovisioned"|"failed-deprovision"|"failed-provision"|"pending-advertising"|"pending-deprovision"|"pending-provision"|"pending-withdrawal"|"provisioned"|"provisioned-not-publicly-advertisable",
      AdvertisementType = "regional"|"global",
      NetworkBorderGroup = "string",
      PoolId = "string",
      Asn = "string",
      RpkiStatus = "valid"|"invalid"|"unknown",
      RpkiStrength = "strict"|"permissive",
      Roas = list(
        list(
          Asn = "string",
          Prefix = "string",
          MaxLength = 123,
          Match = TRUE|FALSE,
          Expiration = as.POSIXct(
            "2015-01-01"
          )
        )
      ),
      RouteOverlaps = list(
        list(
          Prefix = "string",
          Asn = "string",
          DetectedAt = as.POSIXct(
            "2015-01-01"
          )
        )
      ),
      SampleTime = as.POSIXct(
        "2015-01-01"
      ),
      RoaSampleTime = as.POSIXct(
        "2015-01-01"
      )
    )
  ),
  NextToken = "string"
)

Request syntax

svc$get_ipam_route_protection_findings(
  DryRun = TRUE|FALSE,
  IpamId = "string",
  Filters = list(
    list(
      Name = "string",
      Values = list(
        "string"
      )
    )
  ),
  NextToken = "string",
  MaxResults = 123
)