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
)