associate-custom-domain.rst

**To associate a domain name and the www subdomain with a service**

The following ``associate-custom-domain`` example associates a custom domain name that you control with an App Runner service.
The domain name is the root domain ``example.com``, including the special-case subdomain ``www.example.com``. ::

    aws apprunner associate-custom-domain \
        --cli-input-json file://input.json

Contents of ``input.json``::

    {
        "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
        "DomainName": "example.com",
        "EnableWWWSubdomain": true
    }

Output::

    {
        "CustomDomain": {
            "CertificateValidationRecords": [
                {
                    "Name": "_70d3f50a94f7c72dc28784cf55db2f6b.example.com",
                    "Status": "PENDING_VALIDATION",
                    "Type": "CNAME",
                    "Value": "_1270c137383c6307b6832db02504c4b0.bsgbmzkfwj.acm-validations.aws."
                },
                {
                    "Name": "_287870d3f50a94f7c72dc4cf55db2f6b.www.example.com",
                    "Status": "PENDING_VALIDATION",
                    "Type": "CNAME",
                    "Value": "_832db01270c137383c6307b62504c4b0.mzkbsgbfwj.acm-validations.aws."
                }
            ],
            "DomainName": "example.com",
            "EnableWWWSubdomain": true,
            "Status": "CREATING"
        },
        "DNSTarget": "psbqam834h.us-east-1.awsapprunner.com",
        "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa"
    }