Configure hostnames in a bucket

๐Ÿšง

Hostname buckets are BETA

This feature is still in BETA. If you're interested and would like to use hostname buckets now, contact your Akamai account team.

Some products such as Adaptive Media Delivery, IoT Edge Connect Message Store, IoT Edge Connect Message Store, and Akamai Cloud Embed are not supported with hostname buckets yet.

Hostname buckets are primarily intended for SaaS/PaaS providers who manage tens of thousands custom domain hostnames. If you enable buckets while creating a property, you can add or remove hostnames from the property level, without incrementing the property version. You also can safely make changes to the property configuration logic and roll them back without the risk of accidentally removing hostnames and disturbing the traffic to your sites.

You may want to create multiple hostname bucket properties if you have various types of application instances with different delivery needs.

Initial setup

Before you start provisioning thousands of your hostnames, you need to set up a common configuration they'll all share.

  1. On your DNS server, set up a DNS zone to manage the origin hostnames. Typically, you'll need a separate origin hostname for each property hostname you add to the bucket, so that each property hostname has its own SaaS application backend instance. You can also use Akamai Edge DNS for that purpose.

  2. Create a brand-new property, selecting the Hostname bucket checkbox.

    a. In the Property Manager Editor, configure the property to suit your delivery needs. In the Origin Server behavior, define a pattern that you'll use for naming your origin hostnames. For example, prepend origin- and append the .saas.com domain to the property hostname, for which you'll use the AK_HOST built-in variable.

    ๐Ÿ“˜

    If you set SaaS Dynamic Origin as your Origin Type, you can use other parts of the request to identify the origin in your pattern, such as cookie, path or query string.

    b. You just need a single CP code for all the hostnames you add to the bucket. You can create a new CP code or use an existing one.

  3. Activate your property on both staging and production.