Migrate to a multi-tenant distribution

To migrate from a standard distribution to a multi-tenant distribution

1. Review the Unsupported features.

2. Create a multi-tenant distribution with the same configuration as your standard distribution, minus the unsupported features. For more information, see Create a CloudFront distribution in the console.

3. Create a distribution tenant and add an alternative domain name that you own.

   Warning

   Do not use the current domain name that's associated with your standard distribution. You will move your domain over later.

   For more information about creating a distribution tenant, see Create a CloudFront distribution in the console.

4. Provide a certificate for the distribution tenant domain or have CloudFront issue one for you. For more information, see Request certificates for your CloudFront distribution tenant.

5. When your changes have propagated, update your distribution tenant to use the domain that you previously used for your standard distribution. You must also provide a certificate for this domain or have CloudFront issue one for you.

   • Console – For detailed instructions, see Add a domain and certificate (distribution tenant).

   • API – Use the UpdateDomainAssociation API action in the Amazon CloudFront API Reference.

   Important

   This resets the cache key for your content. After this, CloudFront starts caching your content using the new cache key. For more information, see Understand the cache key.

6. Copy your distribution tenant's CloudFront routing endpoint from the distribution tenant detail page in the console. Alternatively, find it by using the ListConnectionGroups API action in the Amazon CloudFront API Reference.

7. Point your domain to your distribution tenant's CloudFront routing endpoint. For more information, see Point domains to CloudFront.