This endpoint is currently available as a BETA. Business-critical processes should not depend on this functionality.
Updates a master name server's name and IP address. Route submits zone transfer requests to the specified IP address.
A request to update a master name server is described below.
HTTP Method | Request URI |
---|---|
PUT |
https://api.edgecast.com/v2/mcc/customers/AccountNumber/dns/masterservers |
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.
Pass the following request body parameters:
Name | Data Type | Description |
---|---|---|
IPAddress Required |
String |
Assigns an IP address to a master name server. |
Id Required |
Integer |
Identifies a master name server by its system-defined ID. |
Name Required |
String |
Assigns a name to a master name server. |
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:
Name | Data Type | Description |
---|---|---|
IPAddress |
String |
Indicates the IP address assigned to the master name server. |
Id |
Integer |
Indicates the system-defined ID for the updated master name server. |
Name |
String |
Indicates the name assigned to the master name server. |
The response body for an unsuccessful request may contain an error parameter that provides additional information.
A sample JSON request is shown below.
PUT https://api.edgecast.com/v2/mcc/customers/0001/dns/masterservers HTTP/1.1
Authorization: TOK:12345678-1234-1234-1234-1234567890ab
Accept: application/json
Content-Type: application/json
Host: api.edgecast.com
Content-Length: 90
[{ "Id": 1246, "IPAddress": "10.22.22.50", "Name": "My Master Name Server" } ]
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: 109
[{ "IPAddress": "10.22.22.50", "Id": 1246, "Name": "My Master Name Server" } ]