AppRunner / Client / disassociate_custom_domain

disassociate_custom_domain#

AppRunner.Client.disassociate_custom_domain(**kwargs)#

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',
    DomainName='string'
)
Parameters:
  • ServiceArn (string) –

    [REQUIRED]

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

  • DomainName (string) –

    [REQUIRED]

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

Return type:

dict

Returns:

Response Syntax

{
    'DNSTarget': 'string',
    'ServiceArn': 'string',
    'CustomDomain': {
        'DomainName': 'string',
        'EnableWWWSubdomain': True|False,
        'CertificateValidationRecords': [
            {
                'Name': 'string',
                'Type': 'string',
                'Value': 'string',
                'Status': 'PENDING_VALIDATION'|'SUCCESS'|'FAILED'
            },
        ],
        'Status': 'CREATING'|'CREATE_FAILED'|'ACTIVE'|'DELETING'|'DELETE_FAILED'|'PENDING_CERTIFICATE_DNS_VALIDATION'|'BINDING_CERTIFICATE'
    },
    '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.

Exceptions