Instructions

• Send to the address auto-bulk@nic.uk.
• Use the subject line TAG Bulk (replace TAG with your tag name in capitals)
• Make sure the e-mail is PGP-signed with a registered PGP key.
• Construct the message body using the template given below.

Operation template

BULK REPLACE NAMESERVER operations may include the following:

operation: bulk
update:
filter:
dry-run:

BULK MODIFY operations consist of:

• exactly one

  operation:bulk

• exactly one update clause.
• 0 or 1 filter clause.
• 0 or 1 dry-run clause.

An update clause specifies the change to be applied to the nameservers; in the case of BULK REPLACE NAMESERVER operations, the only update field permitted is nserver. This specifies the name of the nameserver to be replaced, and the name and (optionally) glue of the replacement nameserver.

An optional filter clause chooses which domain names are modified by specifying criteria which they must match; if no filter clause is given, then all domain names on the requesting tag are modified. An optional dry-run clause will return details of the effect of the operation without committing any changes to the register.

Reply template

The reply to the request

operation: bulk
update: nserver 'nsbefore.example.co.uk' = 'nsafter.example.co.uk'

will be in the form

Subject: Re: ACK TAG bulk

Your message has been processed by the UK NIC automated DNS
delegation system. The required additions/changes have been
made to the database and will become visible in the zone file within
thirty minutes.

The following domain names were modified:
nominet.org.uk
Number of domains in the list: 1.

If you have any questions please contact support@nominet.org.uk.

Documentation on the automaton can be found on the Nominet Web
site at http://www.nominet.org.uk/go/automaton

Your original message follows
-------------------------------------------------------------------------------
operation: bulk
update: nserver 'nsbefore.example.co.uk' = 'nsafter.example.co.uk'

Dry-run reply

The reply to the request

operation: bulk
update: nserver 'nsbefore.example.co.uk' = 'nsafter.example.co.uk'
dry-run:

will be in the form

Subject: Re: TAG bulk - DRY-RUN

Domain list before the change:
Domain name|dns0|dns1|dns2|dns3|dns4|dns5|dns6|dns7|dns8|dns9
nominet.org.uk|nsbefore.example.co.uk.|||||||||
Number of domains in the list: 1.


Domain list after the change:
Domain name|dns0|dns1|dns2|dns3|dns4|dns5|dns6|dns7|dns8|dns9|
nominet.org.uk|nsafter.example.co.uk.|||||||||
Number of domains in the list: 1.

If you have any questions please contact support@nominet.org.uk.

Documentation on the automaton can be found on the Nominet Web
site at http://www.nominet.org.uk/go/automaton

Your original message follows
-------------------------------------------------------------------------------
operation: bulk
update: nserver 'nsbefore.example.co.uk' = 'nsafter.example.co.uk'
dry-run:

Errors

After processing the operation the Automaton sends an automated reply. If there is a problem then two different error conditions may occur

• non-fatal errors (warning messages) may be appended to successful replies.
• fatal errors that prevent the operation from being carried out; an error reply is generated.

Details of the template of the error reply and the meaning of the error messages are available.

Examples

Replacing a nameserver

The following modifies all domain names on the requesting tag with the nameserver 'nsbefore.example.co.uk', replacing it with 'nsafter.example.co.uk'.

operation: bulk
update: nserver 'nsbefore.example.co.uk' = 'nsafter.example.co.uk'

Replacing with glue

The following modified all domain names on the requesting tag with the nameserver 'nsbefore.example.co.uk', replacing it with 'nsafter.example.co.uk'.

If the domain name example.co.uk is updated then the nameserver 'nsafter.example.co.uk' will have the glue 123.123.123.123.

update: nserver 'nsbefore.example.co.uk' = 'nsafter.example.co.uk 123.123.123.123'