EC2 / Client / create_ipam_routing_policy_registration

create_ipam_routing_policy_registration

EC2.Client.create_ipam_routing_policy_registration(**kwargs)

Creates a routing policy registration and publishes Route Origin Authorizations (ROAs) to the RPKI for the specified CIDR prefix and ASNs.

See also: AWS API Documentation

Request Syntax

response = client.create_ipam_routing_policy_registration(
    DryRun=True|False,
    IpamInternetRegistryAssociationId='string',
    Cidr='string',
    Asns=[
        'string',
    ],
    PermitMoreSpecificAnnouncements=True|False,
    MaxLength=123,
    Description='string',
    Force=True|False,
    ClientToken='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) –

    [REQUIRED]

    The IP address prefix in CIDR notation to authorize in the ROA.

  • Asns (list) –

    [REQUIRED]

    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. Must be greater than or equal to the prefix length of the CIDR. If not specified, defaults to the prefix length of the CIDR (exact match only).

  • Description (string) – A description for the routing policy registration.

  • Force (boolean) – Forces the creation of the routing policy registration even if it conflicts with an announced route. Default: false.

  • ClientToken (string) –

    A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, the operation ignores the request, but does not return an error.

    This field is autopopulated if not provided.

Return type:

dict

Returns:

Response Syntax

{
    'IpamRoutingPolicyRegistrationDelta': {
        'DeltaId': 'string',
        'DeltaJson': 'string',
        'State': 'pending'|'published'|'failed',
        'StateMessage': 'string'
    }
}

Response Structure

  • (dict) –

    • IpamRoutingPolicyRegistrationDelta (dict) –

      Information about the routing policy registration delta created by this operation.

      • DeltaId (string) –

        The unique identifier of the delta.

      • DeltaJson (string) –

        The JSON specification describing the changes applied in this delta.

      • State (string) –

        The state of the delta. Valid values: pending | published | failed.

      • StateMessage (string) –

        A message describing the current state, including error information if the delta failed.