EC2 / Client / get_ipam_routing_policy_registrations

get_ipam_routing_policy_registrations

EC2.Client.get_ipam_routing_policy_registrations(**kwargs)

Retrieves routing policy registrations for an IPAM internet registry association. Each registration represents a Route Origin Authorization (ROA) that has been created or is pending publication to the RPKI. We recommend using pagination to ensure that the operation returns quickly and successfully.

See also: AWS API Documentation

Request Syntax

response = client.get_ipam_routing_policy_registrations(
    DryRun=True|False,
    IpamInternetRegistryAssociationId='string',
    Cidr='string',
    MaxResults=123,
    NextToken='string'
)
Parameters:

  • DryRun (boolean) – 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.

  • IpamInternetRegistryAssociationId (string) –

    [REQUIRED]

    The ID of the IPAM internet registry association.

  • Cidr (string) – Filter results to a specific CIDR prefix.

  • MaxResults (integer) – 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.

  • NextToken (string) – The token for the next page of results.

Return type:

dict

Returns:

Response Syntax

{
    'IpamRoutingPolicyRegistrations': [
        {
            'Cidr': 'string',
            'Asns': [
                'string',
            ],
            'PermitMoreSpecificAnnouncements': True|False,
            'MaxLength': 123,
            'Description': 'string',
            'LatestDeltaId': 'string',
            'State': 'pending-activate'|'activate-failed'|'create-in-progress'|'create-complete'|'update-in-progress'|'update-complete'|'delete-in-progress'|'delete-complete'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • IpamRoutingPolicyRegistrations (list) –

      The routing policy registrations.

      • (dict) –

        Contains information about a routing policy registration that represents a Route Origin Authorization (ROA) managed through IPAM.

        • Cidr (string) –

          The IP address prefix in CIDR notation authorized by the ROA.

        • Asns (list) –

          The Autonomous System Numbers (ASNs) authorized to originate the prefix.

          • (string) –

        • PermitMoreSpecificAnnouncements (boolean) –

          Specifies whether to permit more specific route announcements than the CIDR prefix. When enabled, ASNs can announce sub-prefixes of the authorized CIDR up to the specified maximum length. Default: false.

        • MaxLength (integer) –

          The maximum prefix length that the ASNs are authorized to announce.

        • Description (string) –

          The description of the routing policy registration.

        • LatestDeltaId (string) –

          The ID of the most recent delta that modified this registration.

        • State (string) –

          The state of the routing policy registration. Valid values: pending-activate | activate-failed | create-in-progress | create-complete | update-in-progress | update-complete | delete-in-progress | delete-complete.

    • NextToken (string) –

      The token to use to retrieve the next page of results.