delete_domain `async` ¶

delete_domain(
    domain_name: DomainName,
    *,
    config_overrides: Optional[AsyncRoute53DomainsClientConfig] = None,
) -> DeleteDomainResponse

This operation deletes the specified domain. This action is permanent. For more information, see Deleting a domain name registration.

To transfer the domain registration to another registrar, use the transfer process that’s provided by the registrar to which you want to transfer the registration. Otherwise, the following apply:

You can’t get a refund for the cost of a deleted domain registration.
The registry for the top-level domain might hold the domain name for a brief time before releasing it for other users to register (varies by registry).
When the registration has been deleted, we'll send you a confirmation to the registrant contact. The email will come from [email protected] or [email protected] or [email protected].

Parameters:

domain_name (DomainName) –

Name of the domain to be deleted.

Raises:

DuplicateRequest –

The request is already in progress for the domain.
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.
TLDRulesViolation –

The top-level domain does not support this operation.
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 delete_domain(
    self,
    domain_name: "capo_route_53_domains.types.domain_name.DomainName",
    *,
    config_overrides: Optional[AsyncRoute53DomainsClientConfig] = None,
) -> "capo_route_53_domains.types.delete_domain_response.DeleteDomainResponse":
    """<p>This operation deletes the specified domain. This action is permanent. For more information, see <a href="https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-delete.html">Deleting a domain name registration</a>.</p> <p>To transfer the domain registration to another registrar, use the transfer process that’s provided by the registrar to which you want to transfer the registration. Otherwise, the following apply:</p> <ol> <li> <p>You can’t get a refund for the cost of a deleted domain registration.</p> </li> <li> <p>The registry for the top-level domain might hold the domain name for a brief time before releasing it for other users to register (varies by registry). </p> </li> <li> <p>When the registration has been deleted, we'll send you a confirmation to the registrant contact. The email will come from <code>[email protected]</code> or <code>[email protected]</code> or <code>[email protected]</code>.</p> </li> </ol>

    Args:
        domain_name: <p>Name of the domain to be deleted.</p>

    Raises:
        capo_route_53_domains.errors.duplicate_request.DuplicateRequest: <p>The request is already in progress for the domain.</p>
        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.tld_rules_violation.TLDRulesViolation: <p>The top-level domain does not support this operation.</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.delete_domain_request.DeleteDomainRequest]",
    ) -> AsyncOperationResponse[
        "capo_route_53_domains.types.delete_domain_response.DeleteDomainResponse"
    ]:
        import capo_route_53_domains._operations.route53_domains_v20140515.delete_domain

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

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("DeleteDomain")
    )
    input_: capo_route_53_domains.types.delete_domain_request.DeleteDomainRequest = {
        "domain_name": domain_name
    }

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

delete_domain async ¶

delete_domain `async` ¶