Skip to content

create_ipam_internet_registry_association

create_ipam_internet_registry_association(
    *,
    config_overrides: Optional[EC2ClientConfig] = None,
    dry_run: Optional[Boolean] = None,
    ipam_id: Optional[IpamId] = None,
    rir: Optional[Rir] = None,
    organization_handle: Optional[String] = None,
    description: Optional[String] = None,
    tag_specifications: Optional[TagSpecificationList] = None,
    client_token: Optional[String] = None,
) -> CreateIpamInternetRegistryAssociationResult

Creates an association between an IPAM and a Regional Internet Registry (RIR) for Resource Public Key Infrastructure (RPKI) management. You can use this association to create Route Origin Authorizations (ROAs) for IP address prefixes registered with the internet registry. Your IPAM must be in the Advanced tier to use this feature.

Parameters:

  • dry_run (Optional[Boolean], default: None ) –

    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.

  • ipam_id (Optional[IpamId], default: None ) –

    The ID of the IPAM to associate with the internet registry.

  • rir (Optional[Rir], default: None ) –

    The Regional Internet Registry to associate with. Possible values:

    • ripe - RIPE NCC (Europe, the Middle East, and Central Asia).

    • apnic - APNIC (Asia Pacific).

    • arin - ARIN (North America).

    • lacnic - LACNIC (Latin America and the Caribbean).

  • organization_handle (Optional[String], default: None ) –

    The organization handle at the internet registry (for example, a RIPE NCC organization ID or ARIN Org ID).

  • description (Optional[String], default: None ) –

    A description for the internet registry association.

  • tag_specifications (Optional[TagSpecificationList], default: None ) –

    The tags to assign to the internet registry association.

  • client_token (Optional[String], default: None ) –

    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.

Raises:

Source code in docs_src/capo_ec2/_services/ec2.py
def create_ipam_internet_registry_association(
    self,
    *,
    config_overrides: Optional[EC2ClientConfig] = None,
    dry_run: Optional["capo_ec2.types.boolean.Boolean"] = None,
    ipam_id: Optional["capo_ec2.types.ipam_id.IpamId"] = None,
    rir: Optional["capo_ec2.types.rir.Rir"] = None,
    organization_handle: Optional["capo_ec2.types.string.String"] = None,
    description: Optional["capo_ec2.types.string.String"] = None,
    tag_specifications: Optional[
        "capo_ec2.types.tag_specification_list.TagSpecificationList"
    ] = None,
    client_token: Optional["capo_ec2.types.string.String"] = None,
) -> "capo_ec2.types.create_ipam_internet_registry_association_result.CreateIpamInternetRegistryAssociationResult":
    """<p>Creates an association between an IPAM and a Regional Internet Registry (RIR) for Resource Public Key Infrastructure (RPKI) management. You can use this association to create Route Origin Authorizations (ROAs) for IP address prefixes registered with the internet registry. Your IPAM must be in the Advanced tier to use this feature.</p>

    Args:
        dry_run: <p>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 <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
        ipam_id: <p>The ID of the IPAM to associate with the internet registry.</p>
        rir: <p>The Regional Internet Registry to associate with. Possible values:</p> <ul> <li> <p> <code>ripe</code> - RIPE NCC (Europe, the Middle East, and Central Asia).</p> </li> <li> <p> <code>apnic</code> - APNIC (Asia Pacific).</p> </li> <li> <p> <code>arin</code> - ARIN (North America).</p> </li> <li> <p> <code>lacnic</code> - LACNIC (Latin America and the Caribbean).</p> </li> </ul>
        organization_handle: <p>The organization handle at the internet registry (for example, a RIPE NCC organization ID or ARIN Org ID).</p>
        description: <p>A description for the internet registry association.</p>
        tag_specifications: <p>The tags to assign to the internet registry association.</p>
        client_token: <p>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.</p>

    Raises:
        capo_ec2.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_ec2.types.create_ipam_internet_registry_association_request.CreateIpamInternetRegistryAssociationRequest]",
    ) -> OperationResponse[
        "capo_ec2.types.create_ipam_internet_registry_association_result.CreateIpamInternetRegistryAssociationResult"
    ]:
        import capo_ec2._operations.amazon_ec2.create_ipam_internet_registry_association

        output, http_response = (
            capo_ec2._operations.amazon_ec2.create_ipam_internet_registry_association.create_ipam_internet_registry_association(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateIpamInternetRegistryAssociation")
    )
    input_: capo_ec2.types.create_ipam_internet_registry_association_request.CreateIpamInternetRegistryAssociationRequest = {}
    if dry_run is not None:
        input_["dry_run"] = dry_run
    if ipam_id is not None:
        input_["ipam_id"] = ipam_id
    if rir is not None:
        input_["rir"] = rir
    if organization_handle is not None:
        input_["organization_handle"] = organization_handle
    if description is not None:
        input_["description"] = description
    if tag_specifications is not None:
        input_["tag_specifications"] = tag_specifications
    if client_token is None:
        client_token = str(uuid.uuid4())
    input_["client_token"] = client_token

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output