Get Master Server Groups - BETA

This endpoint is currently available as a BETA. Business-critical processes should not depend on this functionality.

Returns a specific or all master server groups. The response will also describe the master name servers associated with each master server group.

Request

Requests to retrieve a specific or all master server groups is described below.

HTTP Method	Request URI
GET	Retrieve all master server groups: https://api.edgecast.com/v2/mcc/customers/AccountNumber/dns/mastergroups Retrieve a specific master server group: https://api.edgecast.com/v2/mcc/customers/AccountNumber/dns/mastergroups?id=MasterServerGroupID

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
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.
MasterServerGroupID	Replace this variable with the system-defined ID of the desired master server group.

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 for each master server group returned by this endpoint:

Name	Data Type	Description
MasterGroupId	Integer	Indicates the system-defined ID assigned to a master server group.
Name	String	Indicates the name assigned to a master server group.
Masters	Array	Contains the master name servers associated with a master server group.
Id	Integer	Masters array Indicates the system-defined ID assigned to a master name server.
IpAddress	String	Masters array Indicates the IP address assigned to a master name server.
Name	String	Masters array Indicates the name assigned to a master name server.

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.

A sample JSON response is shown below.

[{
		"MasterGroupId": 123,
		"Name": "My Master Server Group",
		"Masters": [{
				"Id": 1244,
				"IpAddress": "101.101.0.21",
				"Name": "MNS 1 for external sites"
			}, {
				"Id": 1245,
				"IpAddress": "10.55.55.123",
				"Name": "MNS 2 for external sites"
			}
		]
	}
]