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, example.com ), a subdomain (for example, login.example.com or admin.login.example.com ), or a wildcard (for example, *.example.com ).

      • 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