Create Pull Zone

Configure Tenovos CDN Pull Zone. CDN Pull Zones should be based in a region closest to where your content needs to be served to ensure the lowest latency possible. Consider geo-replication for serving content to global users.

SecurityApiKeyAuth or BasicAuth
Request
header Parameters
X-API-Key
required
string

Customer-specific API key required to invoke API.

Authorization
required
string

Provided by Authentication Token creation operation

AccessToken
required
string

JWT token provided by Authentication Token creation operation.

Content-Type
required
string
Value: "application/json"
Request Body schema: application/json

The Request Body must be a JSON object of the available configuration properties.

id
integer

The unique ID of the Pull Zone.

name
string

The name of the Pull Zone

enabled
boolean

Determines if the Pull Zone is currently enabled, active and running

allowedReferrers
Array of strings

The list of referrer hostnames that are allowed to access the pull zone. Requests containing the header "<Referer: hostname>" that is not on the list will be rejected. If empty, all referrers are allowed.

blockedReferrers
Array of strings

The list of referrer hostnames that are blocked from accessing the pull zone. The CDN will block all requests for content coming from any of the domains listed.

blockedIPs
Array of strings

The list of IPs that are blocked from accessing the Pull Zone. Requests coming from the following IPs will be rejected. If empty, all IPs will be allowed.

enableGeoZoneUS
boolean

Determines if delivery from the North American region is enabled for this Pull Zone.

enableGeoZoneEU
boolean

Determines if delivery from the European region is enabled for this Pull zone.

enableGeoZoneAsia
boolean

Determines if delivery from the Asia region is enabled for this Pull zone.

enableGeoZoneSA
boolean

Determines if delivery from the South American region is enabled for this Pull zone.

enableGeoZoneAF
boolean

Determines if delivery from the Africa region is enabled for this Pull zone.

zoneSecurityEnabled
boolean

True if the URL secure token authentication security is enabled

zoneSecurityKey
string

The security key used for secure URL token authentication.

monthlyBandwidthLimit
integer

The monthly limit of bandwidth in bytes that the pullzone is allowed to use.

monthlyBandwidthUsed
integer

The amount of bandwidth in bytes that the Pull Zone has used this month.

enableAccessControlOriginHeader
boolean

Determines if the CORS headers should be enabled

accessControlOriginHeaderExtensions
Array of strings

Array of file extensions (strings) that specifies which file types should include CORS headers (like Access-Control-Allow-Origin) in the CDN response.

blockedCountries
Array of strings

The list of blocked countries listed using their two-letter Alpha2 ISO codes

cnameDomain
string

The CNAME domain of the pull zone for setting up custom hostnames

enableOptimization
boolean

If true, the CDN will optimize content such as images, css, and javascript in order to serve lighter, faster assets tailored to the requesting device/browser. When true, Tenovos will automatically convert supported image formats to webP on the fly and cache it seperatly to servce to clients that support webP format.

Responses
200

Successful Request. CDN Zone Successfully Created.

400

One or more required parameters are missing or invalid.

401

Authentication failed (unauthorized).

403

Forbidden. You do not have permissions to perform this action, or your connection information is not correct.

503

The server is too busy to handle the request.

post/cdn/pullzone
Request samples
application/json
{
  • "id": 192011,
  • "name": "Hooli Pull Zone US",
  • "enabled": true,
  • "allowedReferrers": [],
  • "blockedReferrers": [],
  • "blockedIPs": [
    ],
  • "enableGeoZoneUS": true,
  • "enableGeoZoneEU": false,
  • "enableGeoZoneAsia": true,
  • "enableGeoZoneSA": true,
  • "enableGeoZoneAF": true,
  • "zoneSecurityEnabled": false,
  • "zoneSecurityKey": "d9f8c7a6e5b4a3f2d1c0b9a8e7f6d5c4",
  • "monthlyBandwidthLimit": 10737418240,
  • "monthlyBandwidthUsed": 7737418240,
  • "enableAccessControlOriginHeader": true,
  • "accessControlOriginHeaderExtensions": [
    ],
  • "blockedCountries": [
    ],
  • "cnameDomain": "https://cdn.cusotmerdomain.net",
  • "enableOptimization": true
}
Response samples
application/json
{
  • "id": 192011,
  • "name": "Hooli Pull Zone US",
  • "enabled": true,
  • "allowedReferrers": [],
  • "blockedReferrers": [],
  • "blockedIPs": [
    ],
  • "enableGeoZoneUS": true,
  • "enableGeoZoneEU": false,
  • "enableGeoZoneAsia": true,
  • "enableGeoZoneSA": true,
  • "enableGeoZoneAF": true,
  • "zoneSecurityEnabled": false,
  • "zoneSecurityKey": "d9f8c7a6e5b4a3f2d1c0b9a8e7f6d5c4",
  • "monthlyBandwidthLimit": 10737418240,
  • "monthlyBandwidthUsed": 7737418240,
  • "enableAccessControlOriginHeader": true,
  • "accessControlOriginHeaderExtensions": [
    ],
  • "blockedCountries": [
    ],
  • "cnameDomain": "https://cdn.cusotmerdomain.net",
  • "enableOptimization": true
}