Examples

An "out of the box" origin strategy provided by the DLCS:

http://dlcs.azurewebsites.net/originStrategies/basic_https

A customer's configured CustomerOriginStrategy resources (these are created by a customer using the API or portal - the association of a customer's URI pattern with an out of the box origin strategy:

http://dlcs.azurewebsites.net/customers/4/originStrategies

OriginStrategy

As a customer you can provide information to the DLCS to allow it to fetch your images from their origin endpoints. Every customer is given a default origin strategy, which is for the DLCS to attempt to fetch the image from its origin URL without presenting credentials. This is fine for images that are publicly available, but is unlikely to be appropriate for images you are exposing from your asset management system. You might have a service that is available only to the DLCS, or an FTP site.

/originStrategies/{0}

Supported operations

Supported properties

name

The human readable name of the origin strategy

requiresCredentials

Whether the DLCS needs stored credentials to fetch images with this strategy

CustomerOriginStrategy

As a customer you can provide information to the DLCS to allow it to fetch your images from their origin endpoints. Every customer has a default origin strategy, which is for the DLCS to attempt to fetch the image from its origin URL without presenting credentials. This is fine for images that are publicly available, but is unlikely to be appropriate for images you are exposing from your asset management system. You might have a service that is available only to the DLCS, or an FTP site. The DLCS has a predefined set of mechanisms for obtaining resources over HTTP, FTP, S3 etc. In your customer origin strategies you match these predefined strategies to regexes that match your origin URLs and credentials that the DLCS can use when requesting your assets.

/customers/{0}/originStrategies/{1}

Supported operations

Supported properties

regex

Regex for matching origin. When the DLCS tries to work out how to fetch from your origin, it uses this regex to match to find the correct strategy.

originStrategy (🔗)

Link to the origin strategy definition that will be used if the regex is matched.

/customers/{0}/originStrategies/{1}/originStrategy

credentials (🔗)

JSON object - credentials appropriate to the protocol, will vary. These are stored in S3 and are not available via the API.

/customers/{0}/originStrategies/{1}/credentials