Add Master Server Group - BETA

Applies To:

Route

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

Creates a master server group.

Request

A request to create a master server group is described below.

HTTP Method	Request URI
POST	https://api.edgecast.com/v2/mcc/customers/AccountNumber/dns/mastergroup

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.

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.

Request Headers

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

Request Body

The Pass the following request body parameters:

Name	Data Type	Description
MasterServers Required	Array	Assign one or more master name servers to the new master server group by either: Adding a new master name server. Include an element that only contains the IPAddress and Name name/value pairs. Associating it with an existing master name server. Include an element that only contains the ID name/value pair. Master name servers may only be added using one of the above methods (i.e., creating or adding an existing one).
IPAddress	String	MasterServers array Indicates the IP address that will be assigned to a new master name server that will be associated with the master server group being created. Use this parameter to add a new master name server to the master server group. Please also include the Name name/value pair and exclude the Id name/value pair when adding a new master name server.
Id	Integer	MasterServers array Indicates the system-defined ID assigned to an existing master name server that will be associated with the master server group being created. Use this parameter to add an existing master name server to the master server group. Please exclude the IPAddress and Name name/value pairs when adding an existing master name server.
Name	String	MasterServers array Indicates the name that will be assigned to a new master name server that will be associated with the master server group being created. Use this parameter to add a new master name server to the master server group. Please also include the IPAddress name/value pair and exclude the Id name/value pair when adding a new master name server.
Name Required	String	Indicates the name that will be assigned to the new master server group.

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
MasterGroupId	Integer	Indicates the system-defined ID assigned to the new master server group.
Masters	Array	Contains the master name servers associated with the new master server group.
IPAddress	String	Masters array Indicates the IP address assigned to a master name server.
Id	Integer	Masters array Indicates the system-defined ID assigned to a master name server.
Name	String	Masters array Indicates the name assigned to a master name server.
Name	String	Indicates the name assigned to a master server group.

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.

POST https://api.edgecast.com/v2/mcc/customers/0001/dns/mastergroup HTTP/1.1

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

Accept: application/json

Content-Type: application/json

Host: api.edgecast.com

Content-Length: 162

{
	"MasterServers": [{
			"IPAddress": "10.22.36.48",
			"Name": "My Master Name Server"
		}, {
			"Id": 1234
		}
	],
	"Name": "My Master Server Group"
}

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

[{
		"MasterGroupId": 380,
		"Masters": [{
				"IPAddress": "10.22.36.48",
				"Id": 1246,
				"Name": "My Master Name Server"
			}, {
				"IPAddress": "10.22.36.49",
				"Id": 1234,
				"Name": "My Master Name Server 2"
			}
		],
		"Name": "My Master Server Group"
	}
]