Review the content here to make sure you're ready to start working with the Cloud Wrapper API.
Get Cloud Wrapper on your contract
Make sure Cloud Wrapper is on your contract:
-
Access Akamai Control Center.
-
Select ☰ > ACCOUNT ADMIN > Contracts.
-
Click your Contract ID in the table.
-
Type
cloud
in the Filter field:-
If you see Cloud Wrapper. You're ready to go.
-
If you don't see Cloud Wrapper. Reach out to your Akamai account team to get it added.
-

Set up authentication credentials
You use the Identity and Access Management tool in Akamai Control Center to set up an API client. An API client consists of several values your API client uses to authenticate calls to Akamai APIs. While you're creating your API client, you'll need to do the following:
-
Verify you have the API service. In Identity and Access Management, you'll come to the API client for you interface. Click Show additional details and look for the Cloud Wrapper entry in the APIs table and make sure its access level is set to READ-WRITE. This gives you access to all operations in this API. If you don't see it, or it's set to READ-ONLY access, talk to your company's Akamai administrator to get your user updated, or reach out to your Akamai account team.
-
Gather values. In the Credentials section, make note of the
client_secret
,host
,access_token
, andclient_token
values.
The
client_secret
is only revealed onceThis value is only revealed after you first create an API client. You can't come back to this interface to get it. So, make sure you make note of it for use. You can use the Download or Copy credential buttons in the interface to save all of your values.
Get your identifiers
Your contractId
contractId
This applies to the contract that includes the Cloud Wrapper product. Several operations in this API require this value. You can find your contractId
using the Contract API:
- List contracts. If you only have one, you’re done. Store this as your
contractId
. If you have more than one, note these values and continue. - List products per contract. Set the
{contractId}
variable to one you’ve noted. - Look for a
marketingProductId
of Cloud Wrapper in the response. If you find it, this contract has Cloud Wrapper enabled, and you can use thiscontractId
.
Your groupId
groupId
You create the objects that make up your delivery workflow with a specific user. This includes your delivery properties and Cloud Wrapper configuration. Your user belongs to a specific group within your contract. You need the unique identifier that Akamai assigns to your group, for various operations in the API.
- Get your
contractId
for the contract that has
Know the workflow
There are several things you can do with the Cloud Wrapper API, key among them is creating a Cloud Wrapper configuration. Here are the basic steps to get this done:
1. Work with your Akamai account team
You'll start by determining your capacity needs and adding that capacity to your contract and the Cloud Wrapper portal.
2. Set up a delivery configuration ("property")
Your property determines how your content is delivered via the Akamai edge network. You can use several Akamai delivery products, based on your need. Media delivery products include Adaptive Media Delivery, Download Delivery, or Object Delivery, while website delivery products include Ion or Dynamic Site Accelerator. You'll need the applicable product on your contract and you'll use the Property Manager API (PAPI) to set up your property.
Store the propertyName
you set for it. You'll need it when creating your Cloud Wrapper configuration.
Cloud Wrapper for web-based products (Ion and Dynamic Site Accelerator) is in beta. Talk to your account team to see if you're eligible to participate in the beta program.
3. Create and activate your Cloud Wrapper configuration
This is the amount of cache space you're allocating in a specific geographic region.
-
Create a configuration. Store the unique
id
Akamai sets for the configuration. -
Activate a configuration. Use the
id
you stored to target the configuration.
4. Add the Cloud Wrapper behavior to your property
Use PAPI to add this behavior to enable it in your property. Select a location
you've established in your Cloud Wrapper configuration to use its cache space.
-
Get a configuration. Run this operation using the
id
you stored to verify that its activationstatus
isACTIVE
. -
Add the behavior. Get the
cloudWrapper
behavior added to your property rule tree.
5. Configure your origin server
Use PAPI once again to configure the origin
behavior in your property to set up the origin server where your deliverable content lives. Cloud Wrapper leverages this information to get your content and store it in its cache.