Lists the available Origin Shield locations for the HTTP Large platform. This list consists of the name, POP code, and region for each POP that can provide Origin Shield protection to a customer origin server. These abbreviations can then be used to set or to interpret Origin Shield settings for a customer origin.
This endpoint does not return data for bypass region settings.
Learn more.
A request to find out the available Origin Shield locations (HTTP Large) is described below.
HTTP Method | Request URI |
---|---|
GET |
https://api.edgecast.com/v2/mcc/customers/AccountNumber/origins/httplarge/shieldpops |
Define the following variable when submitting the above request.
VariableA variable represents a value that must be replaced. A variable consists of either a URL segment (e.g., "0001" in /0001/) or a query string value (e.g., "3" in mediaTypes=3). | Description |
---|---|
Required |
|
This endpointIdentifies a request's connection point to our REST API service. only takes advantage of common request headers.
Request body parameters are not required by this endpoint.
The response to the above request includes an HTTP status code, response headers, and a response body.
A status code indicates whether the request was successfully performed.
The response for this endpoint only includes standard HTTP response headers.
The response body for a successful request contains the following response parameters for each Origin Shield POP returned by this endpoint:
Name | Data Type | Description |
---|---|---|
Name |
String |
Indicates the name of the POP location where Origin Shield servers reside. |
POPCode |
String |
Indicates the three-letter abbreviation corresponding to the POP location identified by the Name response body parameter. |
Region |
String |
Indicates the region corresponding to the POP location identified by the Name response body parameter. The region associated with a POP is relevant when configuring an origin server to bypass Origin Shield protection on certain regions. |
The response body for an unsuccessful request may contain an error parameter that provides additional information.
A sample JSON request is shown below.
GET https://api.edgecast.com/v2/mcc/customers/0001/origins/httplarge/shieldpops HTTP/1.1
Authorization: TOK:12345678-1234-1234-1234-1234567890ab
Accept: application/json
Content-Type: application/json
Host:api.edgecast.com
Content-Length: 0
A sample JSON response is shown below.
HTTP/1.1 200 OK
Cache-Control: private
Content-Type: application/json; charset=utf-8
Date: Thu, 15 Apr 2021 12:00:00 GMT
Content-Length: 2761
[{ "Name" : "Ashburn", "POPCode" : "DCA", "Region" : "US East" }, { "Name" : "Los Angeles", "POPCode" : "OXR", "Region" : "US West" }, { "Name" : "Seattle", "POPCode" : "SEA", "Region" : "US West" }, { "Name" : "Dallas", "POPCode" : "DFW", "Region" : "US West" }, { "Name" : "Chicago", "POPCode" : "ORD", "Region" : "US East" }, { "Name" : "Atlanta", "POPCode" : "ATL", "Region" : "US East" }, { "Name" : "Frankfurt", "POPCode" : "FRA", "Region" : "Europe" }, { "Name" : "London", "POPCode" : "LHR", "Region" : "Europe" }, { "Name" : "Sydney", "POPCode" : "SYD", "Region" : "Asia & South America" }, { "Name" : "Tokyo", "POPCode" : "NRT", "Region" : "Asia & South America" }, { "Name" : "New York", "POPCode" : "JFK", "Region" : "US East" }, { "Name" : "Amsterdam", "POPCode" : "AMS", "Region" : "Europe" }, { "Name" : "Singapore", "POPCode" : "SIN", "Region" : "Asia & South America" }, { "Name" : "Paris", "POPCode" : "CDG", "Region" : "Europe" }, { "Name" : "Miami", "POPCode" : "MIA", "Region" : "US East" }, { "Name" : "Madrid", "POPCode" : "MAD", "Region" : "Europe" }, { "Name" : "San Jose", "POPCode" : "SJC", "Region" : "US West" }, { "Name" : "Osaka", "POPCode" : "KIX", "Region" : "Asia & South America" }, { "Name" : "Vienna", "POPCode" : "VIE", "Region" : "Europe" }, { "Name" : "Stockholm", "POPCode" : "ARN", "Region" : "Europe" }, { "Name" : "Hong Kong", "POPCode" : "HHP", "Region" : "Asia & South America" }, { "Name" : "Frankfurt", "POPCode" : "FCN", "Region" : "Europe" }, { "Name" : "Los Angeles", "POPCode" : "CPM", "Region" : "US West" }, { "Name" : "New York", "POPCode" : "EWR", "Region" : "US East" }, { "Name" : "Chicago", "POPCode" : "MDW", "Region" : "US East" }, { "Name" : "Dallas", "POPCode" : "FTW", "Region" : "US West" }, { "Name" : "Paris", "POPCode" : "ORY", "Region" : "Europe" }, { "Name" : "Ashburn", "POPCode" : "IAD", "Region" : "US East" }, { "Name" : "Batam", "POPCode" : "BTH", "Region" : "Asia & South America" }, { "Name" : "Jakarta", "POPCode" : "CGK", "Region" : "Asia & South America" }, { "Name" : "Tokyo", "POPCode" : "HND", "Region" : "Asia & South America" }, { "Name" : "Miami", "POPCode" : "FLL", "Region" : "US East" }, { "Name" : "Stockholm", "POPCode" : "STO", "Region" : "Europe" }, { "Name" : "Helsinki", "POPCode" : "HEL", "Region" : "Europe" }, { "Name" : "Copenhagen", "POPCode" : "CPH", "Region" : "Europe" } ]
A sample XML request is shown below.
GET https://api.edgecast.com/v2/mcc/customers/0001/origins/httplarge/shieldpops HTTP/1.1
Authorization: TOK:12345678-1234-1234-1234-1234567890ab
Accept: application/xml
Content-Type: application/xml
Host:api.edgecast.com
Content-Length: 0
A sample XML response is shown below.
HTTP/1.1 200 OK
Cache-Control: private
Content-Type: application/xml; charset=utf-8
Date: Thu, 15 Apr 2021 12:00:00 GMT
Content-Length: 4020
<ArrayOfShieldPOP xmlns="http://www.whitecdn.com/schemas/apiservices/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <ShieldPOP> <Name>Ashburn</Name> <POPCode>DCA</POPCode> <Region>US East</Region> </ShieldPOP> <ShieldPOP> <Name>Los Angeles</Name> <POPCode>OXR</POPCode> <Region>US West</Region> </ShieldPOP> <ShieldPOP> <Name>Seattle</Name> <POPCode>SEA</POPCode> <Region>US West</Region> </ShieldPOP> <ShieldPOP> <Name>Dallas</Name> <POPCode>DFW</POPCode> <Region>US West</Region> </ShieldPOP> <ShieldPOP> <Name>Chicago</Name> <POPCode>ORD</POPCode> <Region>US East</Region> </ShieldPOP> <ShieldPOP> <Name>Atlanta</Name> <POPCode>ATL</POPCode> <Region>US East</Region> </ShieldPOP> <ShieldPOP> <Name>Frankfurt</Name> <POPCode>FRA</POPCode> <Region>Europe</Region> </ShieldPOP> <ShieldPOP> <Name>London</Name> <POPCode>LHR</POPCode> <Region>Europe</Region> </ShieldPOP> <ShieldPOP> <Name>Sydney</Name> <POPCode>SYD</POPCode> <Region>Asia & South America</Region> </ShieldPOP> <ShieldPOP> <Name>Tokyo</Name> <POPCode>NRT</POPCode> <Region>Asia & South America</Region> </ShieldPOP> <ShieldPOP> <Name>New York</Name> <POPCode>JFK</POPCode> <Region>US East</Region> </ShieldPOP> <ShieldPOP> <Name>Amsterdam</Name> <POPCode>AMS</POPCode> <Region>Europe</Region> </ShieldPOP> <ShieldPOP> <Name>Singapore</Name> <POPCode>SIN</POPCode> <Region>Asia & South America</Region> </ShieldPOP> <ShieldPOP> <Name>Paris</Name> <POPCode>CDG</POPCode> <Region>Europe</Region> </ShieldPOP> <ShieldPOP> <Name>Miami</Name> <POPCode>MIA</POPCode> <Region>US East</Region> </ShieldPOP> <ShieldPOP> <Name>Madrid</Name> <POPCode>MAD</POPCode> <Region>Europe</Region> </ShieldPOP> <ShieldPOP> <Name>San Jose</Name> <POPCode>SJC</POPCode> <Region>US West</Region> </ShieldPOP> <ShieldPOP> <Name>Osaka</Name> <POPCode>KIX</POPCode> <Region>Asia & South America</Region> </ShieldPOP> <ShieldPOP> <Name>Vienna</Name> <POPCode>VIE</POPCode> <Region>Europe</Region> </ShieldPOP> <ShieldPOP> <Name>Stockholm</Name> <POPCode>ARN</POPCode> <Region>Europe</Region> </ShieldPOP> <ShieldPOP> <Name>Hong Kong</Name> <POPCode>HHP</POPCode> <Region>Asia & South America</Region> </ShieldPOP> <ShieldPOP> <Name>Frankfurt</Name> <POPCode>FCN</POPCode> <Region>Europe</Region> </ShieldPOP> <ShieldPOP> <Name>Los Angeles</Name> <POPCode>CPM</POPCode> <Region>US West</Region> </ShieldPOP> <ShieldPOP> <Name>New York</Name> <POPCode>EWR</POPCode> <Region>US East</Region> </ShieldPOP> <ShieldPOP> <Name>Chicago</Name> <POPCode>MDW</POPCode> <Region>US East</Region> </ShieldPOP> <ShieldPOP> <Name>Dallas</Name> <POPCode>FTW</POPCode> <Region>US West</Region> </ShieldPOP> <ShieldPOP> <Name>Paris</Name> <POPCode>ORY</POPCode> <Region>Europe</Region> </ShieldPOP> <ShieldPOP> <Name>Ashburn</Name> <POPCode>IAD</POPCode> <Region>US East</Region> </ShieldPOP> <ShieldPOP> <Name>Batam</Name> <POPCode>BTH</POPCode> <Region>Asia & South America</Region> </ShieldPOP> <ShieldPOP> <Name>Jakarta</Name> <POPCode>CGK</POPCode> <Region>Asia & South America</Region> </ShieldPOP> <ShieldPOP> <Name>Tokyo</Name> <POPCode>HND</POPCode> <Region>Asia & South America</Region> </ShieldPOP> <ShieldPOP> <Name>Miami</Name> <POPCode>FLL</POPCode> <Region>US East</Region> </ShieldPOP> <ShieldPOP> <Name>Stockholm</Name> <POPCode>STO</POPCode> <Region>Europe</Region> </ShieldPOP> <ShieldPOP> <Name>Helsinki</Name> <POPCode>HEL</POPCode> <Region>Europe</Region> </ShieldPOP> <ShieldPOP> <Name>Copenhagen</Name> <POPCode>CPH</POPCode> <Region>Europe</Region> </ShieldPOP> </ArrayOfShieldPOP>