API workflow for conditional origins

The following is the workflow you need to follow when creating a new Cloudlet policy that uses Conditional Origins.

1. Using the Property Manager API (PAPI), set up the rules for any Cloudlets Origins that will support the Cloudlets policy.

2. Run a GET request on the /cloudlets/api/v2/cloudlet-info endpoint to retrieve the ID (cloudletId) for the Cloudlet you are working with. You need the cloudletId when creating a new policy.

3. Run a GET request on the /cloudlets/api/v2/group-info endpoint to retrieve information about which Cloudlets are associated with the groups you have edit privileges for. You will need the group IDs (groupId) returned when creating a Cloudlet policy.

4. Using the /cloudlets/api/v2/policies endpoint, run a POST to create a Cloudlet policy using the cloudletId and groupId you retrieved from the previous steps. The policy created is version 1. However, this new version does not have a description and does not include match rules (matchRules) attributes.

📘

You have the option of using query parameters to clone an existing policy.

5. Update the new policy version 1 by running a PUT request on the /cloudlets/api/v2/policies/{policyId}/versions/{version} endpoint that includes a version description and match rules. The policyId is returned in the response when the Cloudlet policy is created.

6. If you are setting up a load balancing configuration for Application Load Balancer complete the following tasks:

   1. Make a POST request to /cloudlets/api/v2/origins.

   2. Make a POST request to /cloudlets/api/v2/origins/{originId}/versions.

7. If you need to review the current property associations for the policy version before activating, run a GET request on the /cloudlets/api/v2/policies/{policyId}/properties endpoint.

📘

This operation also returns information about any Conditional Origins configured on an associated property.

8. Using the Property Manager API (PAPI), set up the behavior for each Cloudlet you are configuring:

   • Application Load Balancer
   • Audience Segmentation
   • Forward Rewrite
   • Phased Release

9. Using PAPI, activate the property version that includes your Cloudlets behavior changes.

10. If you are setting up a load balancing configuration for Application Load Balancer, make a POST request to
    /cloudlets/api/v2/origins/{originId}/activations to activate the load balancing version.

11. Activate the policy by executing a POST request to the /cloudlets/api/v2/policies/{policyId}/versions/{version}/activations endpoint.