Skip to content

push_domain async

push_domain(
    domain_name: DomainName,
    target: Label,
    *,
    config_overrides: Optional[AsyncRoute53DomainsClientConfig] = None,
) -> None

Moves a domain from Amazon Web Services to another registrar.

Supported actions:

  • Changes the IPS tags of a .uk domain, and pushes it to transit. Transit means that the domain is ready to be transferred to another registrar.

Parameters:

  • domain_name (DomainName) –

    Name of the domain.

  • target (Label) –

    New IPS tag for the domain.

Raises:

  • InvalidInput –

    The requested item is not acceptable. For example, for APIs that accept a domain name, the request might specify a domain name that doesn't belong to the account that submitted the request. For AcceptDomainTransferFromAnotherAwsAccount, the password might be invalid.

  • OperationLimitExceeded –

    The number of operations or jobs running exceeded the allowed threshold for the account.

  • TLDInMaintenance –

    The top-level domain is currently undergoing maintenance and the request cannot be processed. Try again later.

  • UnsupportedTLD –

    Amazon Route 53 does not support this top-level domain (TLD).

  • UnknownServiceError –

    The service returned an error code this client does not model.

Source code in docs_src/capo_route_53_domains/_services/async_route53_domains.py
async def push_domain(
    self,
    domain_name: "capo_route_53_domains.types.domain_name.DomainName",
    target: "capo_route_53_domains.types.label.Label",
    *,
    config_overrides: Optional[AsyncRoute53DomainsClientConfig] = None,
) -> None:
    """<p> Moves a domain from Amazon Web Services to another registrar. </p> <p>Supported actions:</p> <ul> <li> <p>Changes the IPS tags of a .uk domain, and pushes it to transit. Transit means that the domain is ready to be transferred to another registrar.</p> </li> </ul>

    Args:
        domain_name: <p> Name of the domain. </p>
        target: <p> New IPS tag for the domain. </p>

    Raises:
        capo_route_53_domains.errors.invalid_input.InvalidInput: <p>The requested item is not acceptable. For example, for APIs that accept a domain name, the request might specify a domain name that doesn't belong to the account that submitted the request. For <code>AcceptDomainTransferFromAnotherAwsAccount</code>, the password might be invalid.</p>
        capo_route_53_domains.errors.operation_limit_exceeded.OperationLimitExceeded: <p>The number of operations or jobs running exceeded the allowed threshold for the account.</p>
        capo_route_53_domains.errors.tld_in_maintenance.TLDInMaintenance: <p>The top-level domain is currently undergoing maintenance and the request cannot be processed. Try again later.</p>
        capo_route_53_domains.errors.unsupported_tld.UnsupportedTLD: <p>Amazon Route 53 does not support this top-level domain (TLD).</p>
        capo_route_53_domains.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_route_53_domains.types.push_domain_request.PushDomainRequest]",
    ) -> AsyncOperationResponse[None]:
        import capo_route_53_domains._operations.route53_domains_v20140515.push_domain

        (
            output,
            http_response,
        ) = await capo_route_53_domains._operations.route53_domains_v20140515.push_domain.async_push_domain(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("PushDomain")
    )
    input_: capo_route_53_domains.types.push_domain_request.PushDomainRequest = {
        "domain_name": domain_name,
        "target": target,
    }

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output