AppRunner / Client / disassociate_custom_domain



Disassociate a custom domain name from an App Runner service.

Certificates tracking domain validity are associated with a custom domain and are stored in AWS Certificate Manager (ACM). These certificates aren’t deleted as part of this action. App Runner delays certificate deletion for 30 days after a domain is disassociated from your service.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_custom_domain(
  • ServiceArn (string) –


    The Amazon Resource Name (ARN) of the App Runner service that you want to disassociate a custom domain name from.

  • DomainName (string) –


    The domain name that you want to disassociate from the App Runner service.

Return type:



Response Syntax

    'DNSTarget': 'string',
    'ServiceArn': 'string',
    'CustomDomain': {
        'DomainName': 'string',
        'EnableWWWSubdomain': True|False,
        'CertificateValidationRecords': [
                'Name': 'string',
                'Type': 'string',
                'Value': 'string',
                'Status': 'PENDING_VALIDATION'|'SUCCESS'|'FAILED'
    'VpcDNSTargets': [
            'VpcIngressConnectionArn': 'string',
            'VpcId': 'string',
            'DomainName': 'string'

Response Structure

  • (dict) –

    • DNSTarget (string) –

      The App Runner subdomain of the App Runner service. The disassociated custom domain name was mapped to this target name.

    • ServiceArn (string) –

      The Amazon Resource Name (ARN) of the App Runner service that a custom domain name is disassociated from.

    • CustomDomain (dict) –

      A description of the domain name that’s being disassociated.

      • DomainName (string) –

        An associated custom domain endpoint. It can be a root domain (for example,, a subdomain (for example, or, or a wildcard (for example, *

      • EnableWWWSubdomain (boolean) –

        When true, the subdomain www.DomainName is associated with the App Runner service in addition to the base domain.

      • CertificateValidationRecords (list) –

        A list of certificate CNAME records that’s used for this domain name.

        • (dict) –

          Describes a certificate CNAME record to add to your DNS. For more information, see AssociateCustomDomain.

          • Name (string) –

            The certificate CNAME record name.

          • Type (string) –

            The record type, always CNAME.

          • Value (string) –

            The certificate CNAME record value.

          • Status (string) –

            The current state of the certificate CNAME record validation. It should change to SUCCESS after App Runner completes validation with your DNS.

      • Status (string) –

        The current state of the domain name association.

    • VpcDNSTargets (list) –

      DNS Target records for the custom domains of this Amazon VPC.

      • (dict) –

        DNS Target record for a custom domain of this Amazon VPC.

        • VpcIngressConnectionArn (string) –

          The Amazon Resource Name (ARN) of the VPC Ingress Connection that is associated with your service.

        • VpcId (string) –

          The ID of the Amazon VPC that is associated with the custom domain name of the target DNS.

        • DomainName (string) –

          The domain name of your target DNS that is associated with the Amazon VPC.


  • AppRunner.Client.exceptions.InvalidRequestException

  • AppRunner.Client.exceptions.InternalServiceErrorException

  • AppRunner.Client.exceptions.ResourceNotFoundException

  • AppRunner.Client.exceptions.InvalidStateException