provision_ipam_byoasn ¶

def provision_ipam_byoasn(
    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,
    asn: Optional["capo_ec2.types.string.String"] = None,
    asn_authorization_context: Optional[
        "capo_ec2.types.asn_authorization_context.AsnAuthorizationContext"
    ] = None,
) -> "capo_ec2.types.provision_ipam_byoasn_result.ProvisionIpamByoasnResult":
    """<p>Provisions your Autonomous System Number (ASN) for use in your Amazon Web Services account. This action requires authorization context for Amazon to bring the ASN to an Amazon Web Services account. For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/ipam/tutorials-byoasn.html">Tutorial: Bring your ASN to IPAM</a> in the <i>Amazon VPC IPAM guide</i>.</p>

    Args:
        dry_run: <p>Checks whether you have the required permissions for the action, 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>An IPAM ID.</p>
        asn: <p>A public 2-byte or 4-byte ASN.</p>
        asn_authorization_context: <p>An ASN authorization context.</p>

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

    def _handler(
        req: "OperationRequest[capo_ec2.types.provision_ipam_byoasn_request.ProvisionIpamByoasnRequest]",
    ) -> OperationResponse[
        "capo_ec2.types.provision_ipam_byoasn_result.ProvisionIpamByoasnResult"
    ]:
        import capo_ec2._operations.amazon_ec2.provision_ipam_byoasn

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

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ProvisionIpamByoasn")
    )
    input_: capo_ec2.types.provision_ipam_byoasn_request.ProvisionIpamByoasnRequest = {}
    if dry_run is not None:
        input_["dry_run"] = dry_run
    if ipam_id is not None:
        input_["ipam_id"] = ipam_id
    if asn is not None:
        input_["asn"] = asn
    if asn_authorization_context is not None:
        input_["asn_authorization_context"] = asn_authorization_context

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