Manages Akamai Cloud Embed (ACE) and Integrated Cloud Acceleration (ICA).

Learn more:

• Akamai Cloud Embed

• Download this API’s RAML and JSON schema descriptors.

Overview

The Akamai Cloud Embed API lets you, as an Akamai cloud partner, provide Content Delivery Network (CDN) features to your cloud customers, who are also known as subcustomers.

With this API you can configure CDN features per domain and give your subcustomers the ability to purchase, configure, and monitor Akamai’s CDN services directly through your portal.

In most cases, once you create one or more base configurations to support your business needs, you can use this API to support hundreds of thousands of subcustomers per base configuration.

In order to use this API and its core delivery, download, and video streaming capabilities, you need to add Akamai Cloud Embed to your contract. To use the acceleration features, you have to sign up for Integrated Cloud Accelerator (ICA).

NOTE: Akamai Cloud Embed used to be called Wholesale Delivery.

Getting started

To configure this API for the first time:

• Contact Akamai to enable Akamai Cloud Embed for your account. If you want acceleration features, you also need to add ICA.

• If your subcustomers support both HTTP and HTTPS traffic, contact Akamai to create a secure Akamai Cloud Embed base configuration and provision the necessary certificates. This is the preferred configuration for Akamai Cloud Embed. However, you can create this configuration yourself, if desired using the Property manager Editor in the Luna Control Center.

• If your subcustomers only support HTTP traffic, contact Akamai to request a Multi-Domain Edge Hostname and create an InstantConfig property. A Multi-Domain Edge Hostname lets you use a single hostname to represent multiple web assets.

• Create an origin hostname. You need to create a hostname to identify a default origin server that is separate from your subcustomer cloud origins.

• Create an error page. Once you create a hostname to identify a default origin server, configure this default origin to serve an error page when a subcustomer’s domain is not configured correctly.

• Determine the method to use to create subcustomer IDs. Each customer in your billing system who uses your Akamai Cloud Embed implementation needs this ID. You can use any method to generate IDs as long as the IDs are unique. All traffic for a particular subcustomer is rolled up by this ID for billing.

• Add the Sub-Customer Enablement behavior to your base configuration via Property Manager in Luna. Once added, you need to decide which Akamai Cloud Embed features you want to offer to your subcustomers, and enable them accordingly. Your decisions determine the structure of your policy JSON going forward. (Your policy JSON is made up of rules that include both match criteria and behaviors for use with that specific subcustomer.)

• If you are using Integrated Cloud Accelerator, enable the Dynamic Web Content option in the Sub-Customer Enablement behavior.

• If you’re using a non-secure (HTTP), Multi-Domain Edge Hostname, enable the InstantConfig behavior in your base configuration via Property Manager. InstantConfig lets you associate multiple web assets to a single property without adding each hostname to the base configuration.

• Review Get Started with APIs for details on how to set up client tokens to access any Akamai API. These tokens appear as custom hostnames that look like this: https://akzz-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX.luna.akamaiapis.net.

• To enable this API, choose the API service named Wholesale Delivery, and set the access level to READ-WRITE.

Interactions with other Akamai APIs

You can use the Akamai Cloud Embed API in conjunction with the following Akamai APIs:

• Billing Center. This provides access to CSV-based contract usage data for accounts you can access. We provide separate reports for Akamai Cloud Embed and ICA, per billing period. The Akamai Cloud Embed report lists subcustomer usage (hits and bytes) by geography. The ICA report contains billing data for subcustomers that used ICA, without reference to geography.

• Media Reports. This lets you retrieve usage and quality metrics for Akamai Cloud Embed. It does not include billing data. Currently, this API combines Akamai Cloud Embed and ICA data: If a given operation served both Akamai Cloud Embed and ICA traffic during the selected time period, the report does not differentiate between the two. In addition, this API also reports metrics for the following Media Delivery products: Adaptive Media Delivery, Download Delivery, RTMP Media Delivery, and Object Delivery.

• Property Manager API. You can use the Property Manager API to create and update a base configuration for Akamai Cloud Embed. However, you typically only need one base configuration. For ease of use, we recommend that you use Property Manager via the Luna Control Center.

Concepts

• Cloud partners. Akamai resellers or partners who provide delivery services to their customers. You, as a user of this API, are a cloud partner, also referred to simply as “partner” throughout this documentation.

• Subcustomers. A cloud partner’s customers are subcustomers. Akamai does not assign individual Content Provider (CP) codes to subcustomers even though their traffic is sent over the Akamai platform. As a Cloud Partner you have access to usage detail reports for each of your subcustomers, based on the subcustomer IDs you provide Akamai.

• Subcustomer ID. This is a unique ID for each subcustomer within your own billing systems. All traffic for a particular subcustomer is rolled up by this ID for billing purposes.

• Base configuration. An Akamai delivery configuration that includes all of the common rules for processing end-user requests. You use the Property Manager API or GUI application to configure properties used for both Akamai Cloud Embed and ICA.

• Sub-Customer Enablement behavior. In Property Manager, the subCustomer behavior controls which individual Akamai Cloud Embed and ICA features are available to handle your subcustomers’ traffic. You can set up this behavior to provide access to all available features, or you can select a subset of features to define different classes of service.

• Content Characteristics-Dynamic Web Content behavior. Include this behavior if you only want to enable specific ICA optimizations for your subcustomers.

• InstantConfig behavior. If your subcustomers only send HTTP traffic, you have to add the instantConfig behavior to your property. This behavior, also known as Multi-Domain Configuration, lets you to associate multiple web assets to a single property without adding each hostname separately. It applies property settings to all incoming hostnames based on a DNS lookup.

• Policy. Policies determine how Akamai edge servers handle a given subcustomer’s requests. A single policy is bound to a hostname. Your policy JSON is made up of rules, which contain both match criteria and behaviors. When an incoming request meets the match criteria in a rule, it triggers the behaviors listed in that rule. Rules must be unique within a policy: they can’t have identical sets of matches. A policy can also contain up to 100 behaviors.

• Policy rules. Rules include both match criteria and behaviors. When an incoming request meets the match criteria in a rule, it triggers the behaviors listed in that rule. Within a rule you can use each match type and each behavior once. Also, no one rule can contain both a whitelist and blacklist behavior of a given type. For example, you can add an IP whitelist and a referrer blacklist to a rule, but you can’t have both an IP whitelist and IP blacklist in the same rule. Rules are applied from top to bottom and should be listed from least restrictive to most restrictive. For example, you would list a match on url-wildcard value /* first because it would apply to all requests, where /images/* would only apply to a subset of requests.

• Policy matches. Within a rule, a match defines which subcustomer requests receive the behaviors within the rule. All match conditions for a rule must evaluate to true in order for the behaviors to apply. When constructing the matches array in a rule, the type of data you enter depends on the type of match. For example, if you use the query string match, you have to enter the exact string and keep case sensitivity in mind. If you use the url-scheme match, you enter either HTTP or HTTPS. Within a match, you cannot repeat entries in the value string.

• Policy behaviors. Like Property Manager, the Akamai Cloud Embed API uses behaviors to encapsulate customizable settings. Behaviors are a part of a policy’s rules. A rule can have many behaviors or only one. For the Akamai Cloud Embed API, you group rules into policies. You can have a maximum of 100 behaviors in a subcustomer policy. Policies exceeding 100 behaviors are rejected upon submission. Within a behavior, you cannot repeat entries in the value string.

Resources

The Akamai Cloud Embed API allows you as our “partner” to manage the Content Delivery Network (CDN) features available to your customers (“subcustomers”) when using Akamai Cloud Embed or Integrated Cloud Acceleration (ICA). With this API, you can create and manage subcustomer policies and IDs.

Follow this basic workflow to create a subcustomer ID and policy:

1. Complete the prerequisites in Getting started.

2. If not completed already, use Property Manager in Luna to create a “base configuration,” and ensure that the Sub-Customer Enablement behavior is configured to meet your needs. This configuration and behavior determine baseline settings for use. (It serves as a “limiter.” It states what settings can and can’t be used for all subcustomers associated with the configuration).

3. Run the Add a new subcustomer operation to apply and register a “subcustomer ID” for each of your customers.

4. Run the Create or update a policy operation for each subcustomer ID you need to add to your base configuration. Setup the policy with individual rules and behaviors that you want applied when a request is received for that subcustomer’s content.

5. Test the end-to-end CDN functionality with each subcustomer. You should use a test domain to validate both the functionality and the configuration.

6. For the final step to go live, change applicable DNS to switch Cloud Partner websites to the Akamai platform.

API summary

Download the RAML descriptors for this API.

List all subcustomers

Returns a list of all subcustomers associated with the selected base configuration (propertyId).

[
    {
        "customerID": "abc-123",
        "geo": "FR",
        "subPropertyIDs": [
            "www.example.com",
            "www.example.biz",
            "www.example.net",
            "www.example.co.uk"
        ]
    }
]

Get a subcustomer

Returns policy information for the selected subcustomer and activation network.

{
    "geo": "FR"
}

Add a new subcustomer

Add a new subcustomer ID to the selected base configuration (propertyId).

{
    "geo": "FR"
}

{
    "geo": "FR"
}

Remove a subcustomer

Remove a specific subcustomer using its unique subcustomerId

{
    "description": "The subcustomer for property_id '251922' and subcustomer_id '0004-propertyfolks' was successfully deleted.",
    "message": "Successfully deleted"
}

List all sub-properties for a base configuration

Returns all of the domains (subPropertyID values) for subcustomers associated with a selected base configuration (propertyId) and activation network.

[
    {
        "subPropertyID": "www.example.com",
        "customerID": "abc-123"
    },
    {
        "subPropertyID": "www.example.biz",
        "customerID": "abc-123"
    },
    {
        "subPropertyID": "www.example.com.net",
        "customerID": "def-456"
    },
    {
        "subPropertyID": "www.example.com.co.uk",
        "customerID": "def-456"
    }
]

List all subcustomer domains

Returns domain-specific information for the selected subcustomer domain (subPropertyID) and activation network.

[
    {
        "customerID": "abc-123",
        "geo": "FR",
        "subPropertyIDs": [
            "www.example.com",
            "www.example.biz",
            "www.example.net",
            "www.example.co.uk"
        ]
    }
]

Get a policy

Returns the policy for the selected subcustomer domain, base configuration (propertyId), and activation network.

{
    "rules": [
        {
            "matches": [
                {
                    "name": "http-method",
                    "value": "GET"
                }
            ],
            "behaviors": [
                {
                    "params": {
                        "originBasePath": "-",
                        "cacheKeyValue": "-",
                        "digitalProperty": "www.example.com",
                        "cacheKeyType": "origin",
                        "httpPort": 80,
                        "hostHeaderValue": "-",
                        "originDomain": "www.example.com",
                        "hostHeaderType": "origin"
                    },
                    "name": "origin",
                    "value": "-"
                },
                {
                    "type": "fixed",
                    "name": "caching",
                    "value": "1m"
                }
            ]
        }
    ]
}

Create or update a policy

Create a new subcustomer policy or update an existing one.

X-Customer-ID: 100-example.com
X-Custom-Metadata: 100

{
    "rules": [
        {
            "matches": [
                {
                    "name": "http-method",
                    "value": "GET"
                }
            ],
            "behaviors": [
                {
                    "params": {
                        "originBasePath": "-",
                        "cacheKeyValue": "-",
                        "digitalProperty": "www.example.com",
                        "cacheKeyType": "origin",
                        "httpPort": 80,
                        "hostHeaderValue": "-",
                        "originDomain": "www.example.com",
                        "hostHeaderType": "origin"
                    },
                    "name": "origin",
                    "value": "-"
                },
                {
                    "type": "fixed",
                    "name": "caching",
                    "value": "1m"
                }
            ]
        }
    ]
}

{
    "rules": [
        {
            "matches": [
                {
                    "name": "http-method",
                    "value": "GET"
                }
            ],
            "behaviors": [
                {
                    "params": {
                        "originBasePath": "-",
                        "cacheKeyValue": "-",
                        "digitalProperty": "www.example.com",
                        "cacheKeyType": "origin",
                        "httpPort": 80,
                        "hostHeaderValue": "-",
                        "originDomain": "www.example.com",
                        "hostHeaderType": "origin"
                    },
                    "name": "origin",
                    "value": "-"
                },
                {
                    "type": "fixed",
                    "name": "caching",
                    "value": "1m"
                }
            ]
        }
    ]
}

Delete a policy

Deletes the currently active policy file for the selected subcustomer domain and activation network.

{
    "message": "Successfully deleted",
    "description": "The policy was successfully deleted.",
    "successInstanceId": "a123bcedfg45"
}

Get policy history

Returns policy change information for the selected subcustomer domain, base configuration (propertyId), and activation network.

[
    {
        "papi_version": "1.3",
        "policy": {
            "rules": [
                {
                    "behaviors": [
                        {
                            "name": "origin",
                            "params": {
                                "cacheKeyType": "digital_property",
                                "cacheKeyValue": "-",
                                "digitalProperty": "sportsguys.wsdtest.akalab.com",
                                "hostHeaderType": "digital_property",
                                "hostHeaderValue": "-",
                                "originDomain": "sportsguys.wsdtest.akalab.com.s3-website-us-west-1.amazonaws.com"
                            },
                            "value": "-"
                        }
                    ],
                    "matches": [
                        {
                            "name": "http-method",
                            "value": "GET"
                        }
                    ]
                },
                {
                    "behaviors": [
                        {
                            "name": "caching",
                            "type": "fixed",
                            "value": "1h"
                        }
                    ],
                    "matches": [
                        {
                            "name": "url-extension",
                            "value": "jpg"
                        }
                    ]
                },
                {
                    "behaviors": [
                        {
                            "name": "caching",
                            "type": "fixed",
                            "value": "1d"
                        }
                    ],
                    "matches": [
                        {
                            "name": "url-extension",
                            "value": "mp4"
                        }
                    ]
                }
            ]
        },
        "update_timestamp": 1440722458,
        "version": 1
    },
    {
        "papi_version": "1.3",
        "policy": {
            "rules": [
                {
                    "behaviors": [
                        {
                            "name": "origin",
                            "params": {
                                "cacheKeyType": "digital_property",
                                "cacheKeyValue": "-",
                                "digitalProperty": "www.example.akalab.com",
                                "hostHeaderType": "digital_property",
                                "hostHeaderValue": "-",
                                "originDomain": "www.example.com"
                            },
                            "value": "-"
                        }
                    ],
                    "matches": [
                        {
                            "name": "http-method",
                            "value": "GET"
                        }
                    ]
                },
                {
                    "behaviors": [
                        {
                            "name": "caching",
                            "type": "fixed",
                            "value": "1h"
                        }
                    ],
                    "matches": [
                        {
                            "name": "url-extension",
                            "value": "jpg"
                        }
                    ]
                },
                {
                    "behaviors": [
                        {
                            "name": "caching",
                            "type": "fixed",
                            "value": "1d"
                        }
                    ],
                    "matches": [
                        {
                            "name": "url-extension",
                            "value": "mp4"
                        }
                    ]
                }
            ]
        },
        "update_timestamp": 1440722462,
        "version": 2
    }
]

Data

This section shows you the data model for the Akamai Cloud Embed API. The main “{Object}” sections reveal an example of the JSON returned for a GET call. The “{Object} Members” sub-sections illustrate elements that are required or optional, based on the call method. For example, “required” indicates the element must be used in the request body for a PUT method call, and it is always included in the response for a GET call.

Download the JSON schemas for this API.

The data schema tables below list membership requirements as follows:

SubCustomer

Allows you to add or update a subcustomer.

Download schema: subcustomerID-add-get.json

Sample GET response:

[
    {
        "customerID": "abc-123",
        "geo": "FR",
        "subPropertyIDs": [
            "www.example.com",
            "www.example.biz",
            "www.example.net",
            "www.example.co.uk"
        ]
    }
]

SubCustomer members

SubProperty

Lists ID, domain, and geographic information for a subproperty, which is the subcustomer’s domain.

Download schema: subproperty-get-all-for-subcustomer.json

Sample GET response:

[
    {
        "subPropertyID": "www.example.com",
        "customerID": "abc-123"
    },
    {
        "subPropertyID": "www.example.biz",
        "customerID": "abc-123"
    },
    {
        "subPropertyID": "www.example.com.net",
        "customerID": "def-456"
    },
    {
        "subPropertyID": "www.example.com.co.uk",
        "customerID": "def-456"
    }
]

SubProperty members

Policy

Encapsulates rules consisting of match criteria and resulting behavior settings to be applied for a specific subcustomer

Download schema: policy-rule.json

Sample GET response:

{
    "rules": [
        {
            "matches": [
                {
                    "name": "http-method",
                    "value": "GET"
                }
            ],
            "behaviors": [
                {
                    "params": {
                        "originBasePath": "-",
                        "cacheKeyValue": "-",
                        "digitalProperty": "www.example.com",
                        "cacheKeyType": "origin",
                        "httpPort": 80,
                        "hostHeaderValue": "-",
                        "originDomain": "www.example.com",
                        "hostHeaderType": "origin"
                    },
                    "name": "origin",
                    "value": "-"
                },
                {
                    "type": "fixed",
                    "name": "caching",
                    "value": "1m"
                }
            ]
        }
    ]
}

Policy members

Matches and Behaviors

A match defines the criteria that must be met in a request for subcustomer content in order to apply the behaviors set in a rule.

Behaviors determine the settings that should be applied to the delivery of subcustomer content. (A behavior’s settings are applied when a request is received for a subcustomer’s content, that meets the rule’s match criteria.)

client-ip

Used as a match criteria when creating or updating a policy. The IP address associated with the requesting client is used to determine the match. You can specify individual IP addresses, or CIDR blocks (that express a range of addresses).

Download schema: client-ip-match.json

client-ip members

cookie

Used as a match criteria when creating or updating a policy. It lets you include specific cookie names for use when matching on an incoming request.

Download schema: cookie-match.json

cookie members

header

Used as a match criteria when creating or updating a policy. Associated behaviors are applied if a header or header value you specify in this match criteria are included with a request.

Download schema: header-match.json

header members

host-name

Used as a match criteria when creating or updating a policy. Include this to match on hostnames listed in the incoming request’s Host header.

Download schema: host-name-match.json

host-name members

http-method

Used as a match criteria when creating or updating a policy. Include this to match on a set of HTTP methods.

Download schema: http-method-match.json

http-method members

url-extension

Used as a match criteria when creating or updating a policy. It lets match on the extension in the incoming request. This match criteria has no effect on URL paths that do not include a file extension.

Download schema: url-extension-match.json

url-extension members

url-filename

Used as a match criteria when creating or updating a policy. It lets you match on the filename and extension included in the incoming request.

Download schema: url-filename-match.json

url-filename members

url-path

Used as a match criteria when creating or updating a policy. It lets you match on the first path component in the incoming request. The first path component is the section directly after the base URL.

Download schema: url-path-match.json

url-path members

url-querystring

Used as a match criteria when creating or updating a policy. It lets you match on a combination of query string parameters and their values.

Download schema: url-querystring-match.json

url-querystring members

url-scheme

Used as a match criteria when creating or updating a policy. It lets you match on the protocol or scheme (HTTP or HTTPS) of an incoming request.

Download schema: url-scheme-match.json

url-scheme members

url-wildcard

Used as a match criteria when creating or updating a policy. It lets you use wildcards when matching on the incoming request path, minus any query strings. This match type only supports the * wildcard.

Download schema: url-wildcard-match.json

url-wildcard members

access-control

Used as a behavior when creating or updating a policy. It lets you deny client requests based on the selected match conditions.

Download schema: access-control-behavior.json

access-control members

cachekey-query-args

Used as a behavior when creating or updating a policy. It specifies how to handle query-string arguments in incoming requests.

Download schema: cachekey-query-args-behavior.json

cachekey-query-args members

caching

Used as a behavior when creating or updating a policy. Include it to provide time-to-live (TTL) cache settings for subcustomers.

Download schema: caching-behavior.json

caching members

content-char-dynamic-web

Used as a behavior when creating or updating a policy. If you’re using Integrated Cloud Acceleration, this uses SureRoute to optimize the forward path to the origin server. It controls embedded object pre-fetching, situational image compression, and Real User Monitoring (RUM) capabilities.

Download schema: content-char-dynamic-web-behavior.json

content-char-dynamic-web members

content-char-large-file

Used as a behavior when creating or updating a policy. Include it to optimize the delivery of large file downloads of up to 1.8 GB. This behavior uses partial object caching with pre-fetched object data.
As a best practice, only use this behavior if you serve large files. Otherwise, the Akamai platform may send additional requests to your origin. When using Large File Optimization, if an object doesn’t meet the minimum size criterion of 10 MB, the platform requests the entire object from the origin.

Download schema: content-char-large-file-behavior.json

content-char-large-file members

content-char-streaming

Used as a behavior when creating or updating a policy. Include it to optimize cache and network timeout conditions for on-demand video content. The Akamai platform examines the URI file extension and path for the media format then automatically optimizes: cache efficiency, time-to-live, automated failover, downstream Content-Type headers, and network timeout settings.

Download schema: content-char-streaming-behavior.json

content-char-streaming members

content-compression

Used as a behavior when creating or updating a policy to provide compression settings. You can enable gzip compression, decompress objects before delivering them to the client, or maintain the origin’s compression settings.

Download schema: content-compression-behavior.json

content-compression members

content-refresh

Used as a behavior when creating or updating a policy. Lets you invalidate CDN cache at an explicit date and time. This behavior uses epoch time to denote when a request should receive a new copy of the object or a revalidated one.

Download schema: content-refresh-behavior.json

content-refresh members

downstream-caching

Used as a behavior when creating or updating a policy. Include this to control downstream caching of alternate content. Only use this behavior if site failover is enabled for the alternate hostname property. If you do not include this behavior, your subcustomer policy uses the downstream caching settings specified in the alternate hostname property. To enable site failover, use the Subcustomer Enablement behavior in Property Manager.

Download schema: downstream-caching-behavior.json

downstream-caching members

geo-blacklist

Used as a behavior when creating or updating a policy. Include this to block access to content based on the continent, country, region/state, or designated marketing area (DMA) of the requesting IP address. All other geographic areas are allowed.

Download schema: geo-blacklist-behavior.json

geo-blacklist members

geo-whitelist

Used as a behavior when creating or updating a policy. Include this to allow access to content based on the continent, country, region/state, or designated marketing area (DMA) of the requesting IP address. All other geographic areas are denied.

Download schema: geo-whitelist-behavior.json

geo-whitelist members

ip-blacklist

Used as a behavior when creating or updating a policy. Include this to block access based on the requesting IP address.

Download schema: ip-blacklist-behavior.json

ip-blacklist members

ip-whitelist

Used as a behavior when creating or updating a policy. Include this to allow access based on the requesting IP address. Only the IP addresses listed are allowed access.

Download schema: ip-whitelist-behavior.json

ip-whitelist members

modify-outgoing-request-path

Used as a behavior when creating or updating a policy. Include this to provide options for altering the request URL before it is sent to origin.

Download schema: modify-outgoing-request-path-behavior.json

modify-outgoing-request-path members

origin

Used as a required behavior when creating or updating a policy. It provides origin settings for the specific subcustomer. You need to include: origin DNS hostname, forward host header, and cache key. Optional settings include the origin base path and ports.

Download schema: origin-behavior.json

origin members

origin-characteristics

Used as a behavior when creating or updating a policy. Include this if you have Integrated Cloud Acceleration (ICA), to select the type of origin supporting your Akamai Cloud Embed implementation. Use the origin behavior to configure origin settings for your subcustomers at the policy level.

Download schema: origin-characteristics-behavior.json

origin-characteristics members

referer-blacklist

Used as a behavior when creating or updating a policy. Include this to block access based on the Referer request header. This behavior helps verify that the client is a browser that supports RFC 2616, section 14.36, and that the referring HTML page is served from a domain trusted by the content owner.

Download schema: referer-blacklist-behavior.json

referer-blacklist members

referer-whitelist

Used as a behavior when creating or updating a policy. Include this to allow access based on the Referer request header. This behavior helps verify that the client is a browser that supports RFC 2616, section 14.36, and that the referring HTML page is served from a domain trusted by the content owner.

Download schema: referer-whitelist-behavior.json

referer-whitelist members

site-failover

Used as a behavior when creating or updating a policy. Include this to define the alternate hostname and path to use when the edge server can’t contact the origin server.

Download schema: site-failover-behavior.json

site-failover members

token-auth

Used as a behavior when creating or updating a policy. This lets you use tokens to control access to content. You can choose to transmit the token in a cookie, header, or query parameter.

Download schema: token-auth-behavior.json

token-auth members

Errors

This section shows you how to handle various kinds of errors this API generates, and lists the range of HTTP status codes along with their likely causes.

Error responses

The following example shows an error response for a request processed by this API:

{
    "errorCode" : 403,
    "message" : "Authorization failed",
    "description" : "The user is not authorized to access the policies or subcustomers associated with the given property id",
    "helpLink" : "https://developer.akamai.com/api/delivery-policies/errors.html#403",
    "errorInstanceId" : "31f1a7532f",
}

You would expect to see a message like this if the property ID is not valid or is not configured correctly.

HTTP status codes

This section lists the full range of response codes the API may generate.

Last modified: 11/12/2018