When working with Cloudlets, you need to be familiar with these terms:
Policies. For each Cloudlet on your contract, there can be any number of policies. Policies are versioned. Within a policy version you define the rules that determine when the Cloudlet executes. Each policy is assigned a unique ID
policyId. A legacy policy, or a non-shared policy, can only be assigned to one property in Property Manager.
Shared policies. A shared policy can be used for an unlimited number of properties. This is the only policy type that API version 3 supports. The only interaction with a legacy (non-shared) policy in this API version is to upgrade it to a shared policy. Unlike legacy policies, once a shared policy is activated it's available on your network for any property. See the the response object from the Get a policy operation.
Properties. A property configuration includes all the rules for how to process end-user requests for either a specific web asset or a set of assets. For more information about properties, see the Property Manager API.
Policy version. A specific revision of a given policy (
policyId). Policy version numbers start at 1 and increment as new versions are created for a policy. You may want to create a new version of a policy to support a different business requirement, or to test new functionality. When you activate a Cloudlet, you're activating a specific version of a Cloudlet policy. See the response object from the Get a policy version operation. If a policy version is being activated or has been activated it is immutable, meaning you can't modify it.
Groups. Within an account, there's a hierarchy of groups that control access to both properties and Cloudlets policies. If your Akamai username isn't associated with the group ID (
groupId) being used with this API, then the request fails. In addition, you can only associate a Cloudlet policy with a property that's in a compatible group, which can either be the same group, or be an ancestor of the policy's group.
Activation. Make a policy version available for use on a given network and across any property in the account. You can only activate shared policies with this API. See the response objects from the List policy activations operation.