PUT api/NameServer/{id}?user={user}

Change the ip addresses of a name server

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

Name server id

decimal number

Required

user

Optional user handle - if empty logged in user will be used

string

None.

Body Parameters

Ip addresses

UpdateNameServer
NameDescriptionTypeAdditional information
Ip1

Primary ip address

string

Required

Ip2

Second ip address

string

None.

Name

string

None.

Registry

Registry info

string

None.

Request Formats

application/json, text/json

Sample:
{
  "Ip1": "sample string 1",
  "Ip2": "sample string 2",
  "Name": "sample string 3",
  "Registry": "sample string 4"
}

application/xml, text/xml

Sample:
<UpdateNameServer xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models.Domain">
  <Ip1>sample string 1</Ip1>
  <Ip2>sample string 2</Ip2>
  <Name>sample string 3</Name>
  <Registry>sample string 4</Registry>
</UpdateNameServer>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Nameserver object on success
Collection of errors on failure
Return codes
200 - ok
300 - ambiguous
400 - bad request
401 - unauthorized
404 - not found
500 - internal server error
510 - object does not exist
525 - object already registered
530 - invalid attribute value
550 - parameter value policy error
570 - object status does not allow for operation
581 - command failed

NameServer
NameDescriptionTypeAdditional information
Id

decimal number

None.

Name

string

Required

Ip1

Primary ip address

string

None.

Ip2

Second ip address

string

None.

Registries

Registry info

Collection of NSHandle

None.

Response Formats

application/json, text/json

Sample:
{
  "Id": 1.0,
  "Name": "sample string 2",
  "Ip1": "sample string 3",
  "Ip2": "sample string 4",
  "Registries": [
    {
      "Registry": "sample string 1",
      "Handle": "sample string 2",
      "RegisterDate": "2025-04-04T00:07:57.242234+02:00"
    }
  ]
}

application/xml, text/xml

Sample:
<NameServer xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models.Domain">
  <Id>1</Id>
  <Ip1>sample string 3</Ip1>
  <Ip2>sample string 4</Ip2>
  <Name>sample string 2</Name>
  <Registries>
    <NSHandle>
      <Handle>sample string 2</Handle>
      <RegisterDate>2025-04-04T00:07:57.242234+02:00</RegisterDate>
      <Registry>sample string 1</Registry>
    </NSHandle>
  </Registries>
</NameServer>