Origins - BETA

The Origins API is currently available as a BETA. Business-critical processes should not depend on this functionality.

What are the differences between the Customer Origins and the Origins API?

An overview of the differences between the Customer Origins and the Origins API is provided below.

API	TLS	Functions	Dedicated Origin Entry Endpoints
Customer Origins API
Origins API

Customer Origins API

The Customer Origins API, which is our initial API implementation, does not support managing a customer origin group's TLS configuration. It also does not support the retrieval of the Function@Edge functions associated with your customer origin groups. Finally, it requires that you manage a customer origin and all of its entries within a single request. For example, you can create a customer origin group and all of its origin entries through the Add Customer Origin endpoint.

Origins API

The Origins API, which is our latest implementation, uses dedicated endpoints to manage a customer origin group and origin entries. For example, setting up a customer origin group consists of requesting the following endpoints:

Additionally, it allows you to retrieve the Function@Edge functions associated with your customer origin groups.

Use the Origins API to perform the following tasks:

Category	Description
Customer Origin Group Management	Manage your customer origin groups Add Customer Origin Group (HTTP Large \| ADN) Delete Customer Origin Group (HTTP Large \| ADN) Get All Customer Origin Groups (HTTP Large \| ADN) Get Customer Origin Group (HTTP Large \| ADN) Get Customer Origin Group Status (HTTP Large \| ADN) Update Customer Origin Group (HTTP Large \| ADN) Use the origin entry management endpoints to manage a customer origin group's origin entries.
Origin Entry Management	Manage your origin entries Add Origin Entry (HTTP Large \| ADN) Delete Origin Entry (HTTP Large \| ADN) Get All Origin Entries (HTTP Large \| ADN) Get Origin Entries by Customer Origin Group (HTTP Large \| ADN) Get Origin Entry (HTTP Large \| ADN) Update Origin Entry (HTTP Large \| ADN)
Load Balancing	Manage your load balancing configuration Update Failover Order (HTTP Large \| ADN) Use the Update Origin Entry endpoint to determine whether a specific origin entry identifies the primary hostname or IP address for the protocol that corresponds to it.
Functions@Edge	Get All Functions (HTTP Large \| ADN)
Reference	Get Available Protocols Get Available Hostname Resolution Methods Get Origin Shield POPs

Base URL

Use the following base URL:

https://api.vdms.io/cdn/origins/v0.5

Scope

Use the following scope to authenticate and authorize requests for the Origins API:

cdn.origins

Customer Origin Group Creation Workflow

Create a customer origin group through the following steps:

Create a customer origin group through either of the following platform-specific endpoints:
- Add Customer Origin Group (HTTP Large)
- Add Customer Origin Group (ADN)
These endpoints do not support Azure Block Blob origin groups.
Add an origin entry to your new customer origin group through either of the following platform-specific endpoints:
- Add Origin Entry (HTTP Large)
- Add Origin Entry (ADN)
Repeat the previous step as needed.