Show search and navigation.

 

Get Customer Origin - FMS - Discontinued

The Flash Media StreamingThis service was discontinued on 5/31/2017. The Flash Media Streaming platform streamed live and on-demand content via a Flash media player over a RTMP-based protocol., HLSAllows the creation of a customized report data., and HDS services were discontinued on May 31, 2017. The information in this article is solely provided as a reference for the migration of automation scripts to a different streaming technology (e.g., Dynamic Cloud Packaging).

Retrieves the properties of a Flash Media Streaming customer origin configuration.

Request

A request to retrieve a customer origin configuration is described below.

HTTP Method Request URI

GET

https://api.edgecast.com/v2/mcc/customers/AccountNumber/origins/flash/CustomerOriginID

Define the following variables 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

AccountNumber

Required

Replace this variable with a customer account number. This account number may be found in the upper right-hand corner of the MCC.

CustomerOriginID

Required

Replace this variable with the system-defined ID of the customer origin configuration that you would like to retrieve.

A list of FMS customer origin configurations and their corresponding system-defined IDs can be retrieved through the following endpoint:

Request Headers

This endpointIdentifies a request's connection point to our REST API service. only takes advantage of common request headers.

Request Body

Request body parameters are not required by this endpoint.

Response

The response to the above request includes an HTTP status code, response headers, and a response body.

Status Code

A status code indicates whether the request was successfully performed.

Response Headers

The response for this endpoint only includes standard HTTP response headers.

View common response headers.

Response Body

The response body for a successful request contains the following response parameters:

Name Data Type Description

DirectoryName

String

Identifies the directory name assigned to the customer origin configuration. This alphanumeric name is appended to the end of the base CDN URL that points to the customer origin server.

Example:

rtmp://fms.0001.edgecastcdn.net/800001/CustomerOriginThis variable represents the directory name assigned to your customer origin configuration.

HostHeader

String

Identifies the value that will be assigned to the Host header for all requests to this customer origin configuration.

HttpFullUrl

String

Indicates the CDN URL for RTMP requests to this customer origin server.

HttpHostnames

Array

This response parameter contains the hostnames/IP addresses that will handle requests.

IsPrimary

Integer

HttpHostnames

Indicates whether a particular hostname/IP address is the primary one.

Valid values are:

  • 0: Indicates that the current hostname/IP address is not the primary one. This value will always be reported for the Round-Robin load balancing mode.
  • 1: Indicates that the current hostname/IP address is the primary one.

Name

String

HttpHostnames

Reports the URL for the current hostname/IP address. This URL consists of the protocol, hostname/IP address, and the port.

Ordinal

Integer

HttpHostnames

Indicates the position in the ordered list for the current hostname/IP address. This position is primarily used by "Primary and Failover" load balancing mode to determine which hostname/IP address will take over when a hostname/IP address higher on the list is unreachable.

HttpLoadBalancing

String

Indicates how requests will be load balanced for the specified hostnames/IP addresses.

Valid values are:

  • PF: This value indicates that "Primary and Failover" mode will be used to load balance requests for this customer origin. In this mode, the specified hostnames/IP addresses form an ordered failover list. All requests will first be sent to the first hostname/IP address in the list. If that server is unavailable (i.e., TCP connection is refused or a timeout occurs), then the request will be sent to the next hostname/IP address.
  • RR: This value indicates that "Round Robin" mode will be used to load balance requests for this customer origin. In this mode, our servers will send a balanced numbers of requests to each hostname/IP address.

The load balancing mode indicated for your customer origin configuration is independent from any load balancing configuration that may exist at the origin server.

HttpsFullUrl

String

This response body parameter is not applicable for the Flash Media Streaming platform and will always return a null value.

HttpsHostnames

Array

This response body parameter is not applicable for the Flash Media Streaming platform and will always return a null value.

HttpsLoadBalancing

String

This response body parameter is not applicable for the Flash Media Streaming platform and will always return a null value.

Id

Integer

Indicates the unique ID assigned to this customer origin configuration.

MediaTypeId

Integer

Identifies the platform on which the customer origin configuration resides. This response parameter will always report "2," which is the value assigned to the Flash Media Streaming platform.

ShieldPOPs

Array

This response body parameter is not applicable for the Flash Media Streaming platform and will always return a null value.

UseOriginShield

Integer

This response body parameter is not applicable for the Flash Media Streaming platform and will always return a null value.

networkConfiguration

Integer

Indicates how hostnames associated with a customer origin configuration will be resolved to an IP address.

Valid values are:

  • 1: Default. Indicates that the IP preference for this customer origin will be system-defined. Currently, this configuration causes hostnames to be resolved to IPv4 only.
  • 2: IPv6 Preferred over IPv4. Indicates that although hostnames for this customer origin can be resolved to either IP version, a preference will be given to IPv6.
  • 3: IPv4 Preferred over IPv6. Indicates that although hostnames for this customer origin can be resolved to either IP version, a preference will be given to IPv4.
  • 4: IPv4 Only. Indicates that hostnames for this customer origin can only be resolved to IPv4.
  • 5: IPv6 Only. Indicates that hostnames for this customer origin can only be resolved to IPv6.

Errors

The response body for an unsuccessful request may contain an error parameter that provides additional information.

View common error messages.

Sample Request and Response (JSON)

A sample JSON request is shown below.

GET https://api.edgecast.com/v2/mcc/customers/0001/origins/flash/123456 HTTP/1.1

Authorization: TOK:12345678-1234-1234-1234-1234567890ab

Accept: application/json

Host:api.edgecast.com

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: 483

{
	"DirectoryName" : "videos.example.com",
	"HostHeader" : "videos.example.com",
	"HttpFullUrl" : "rtmp:\/\/fms.0001.edgecastcdn.net\/800001\/videos.example.com",
	"HttpHostnames" : [{
			"IsPrimary" : 1,
			"Name" : "http:\/\/videos.example.com:80",
			"Ordinal" : 0
		}
	],
	"HttpLoadBalancing" : "PF",
	"HttpsFullUrl" : null,
	"HttpsHostnames" : [],
	"HttpsLoadBalancing" : "",
	"Id" : 123456,
	"MediaTypeId" : 2,
	"ShieldPOPs" : [],
	"UseOriginShield" : 0,
	"networkConfiguration" : 1
}

Sample Request and Response (XML)

A sample XML request is shown below.

GET https://api.edgecast.com/v2/mcc/customers/0001/origins/flash/123456 HTTP/1.1

Authorization: TOK:12345678-1234-1234-1234-1234567890ab

Accept: application/xml

Host:api.edgecast.com

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: 771

<CustomerOrigin xmlns="http://www.whitecdn.com/schemas/apiservices/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
	<DirectoryName>videos.example.com</DirectoryName>
	<HostHeader>videos.example.com</HostHeader>
	<HttpFullUrl>rtmp://fms.0001.edgecastcdn.net/800001/videos.example.com</HttpFullUrl>
	<HttpHostnames>
		<Hostname>
			<IsPrimary>1</IsPrimary>
			<Name>http://videos.example.com:80</Name>
			<Ordinal>0</Ordinal>
		</Hostname>
	</HttpHostnames>
	<HttpLoadBalancing>PF</HttpLoadBalancing>
	<HttpsFullUrl i:nil="true" />
	<HttpsHostnames />
	<HttpsLoadBalancing />
	<Id>123456</Id>
	<MediaTypeId>2</MediaTypeId>
	<ShieldPOPs />
	<UseOriginShield>0</UseOriginShield>
	<networkConfiguration>1</networkConfiguration>
</CustomerOrigin>