BULK MODIFY applies a given changeset to all domain names matching given filter. It is a flexible method for maintaining large numbers of existing domain names in a single, terse request.

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 MODIFY 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 changeset to be applied to the domain names; in the case of BULK MODIFY operations, any update field except registrar-tag can be modified. 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: notes = 'Example notes'

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:
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: notes = 'Example notes'

Dry-run reply

The reply to the request

operation: bulk
update: notes = 'Example notes'
dry-run:

will be in the form

Subject: Re: TAG bulk - DRY-RUN

Domain list before the change:
Domain name|notes
example.co.uk|Old notes
Number of domains in the list: 1.


Domain list after the change:
Domain name|notes
example.co.uk|New notes
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: notes = 'New notes'
dry-run:

Errors

After processing the operation the Automaton sends an automated reply. If there is a problem then one of 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

Modify all domains

Omitting a filter clause modifies all domain names on the requesting tag. This example will set the notes field.

operation: bulk
update: notes = 'Example notes'

Modify all domain names on an account

This sets the notes field for all domain names on account '100001'.

operation: bulk
filter: account-id = '100001'
update: notes = 'Example notes'

Dry-run

This will return the outcome of the operation without committing any changes to the register

operation: bulk
update: notes = 'Example notes'
dry-run:

Filter out domain names

This sets the auto-bill field to '1' for each domain on the requesting tag except 'example1.co.uk' and 'example2.co.uk'

filter: not (key = 'example1.co.uk' or key = 'example2.co.uk')
update: auto-bill = '1'

Modify billing fields

This modifies the billing fields for all domain names on the account '100001'.

filter: account = '100001'
update: auto-bill = '1', recur-bill = 'NULL', 
        first-bill = 'bc', next-bill = 'bc'

Attach nameservers

This sets the nameserver list for all domain names on the requesting tag.

operation: bulk
update: nservers = [ 'ns0.nserver.co.uk 121.121.121.121', 
                     'ns1.nserver.co.uk 101.101.101.101' ]

Filter and attach nameservers

This sets the nameserver list for all domain names on the requesting tag which are attached to the nameserver 'ns1.example.co.uk'.

operation: bulk
filter: 'ns1.example.co.uk' in nservers
update: nservers = [ 'ns0.nserver.co.uk', 'ns1.nserver.co.uk' ]

Merge accounts

This will move onto account '100001' all domain names on the requesting tag with account name 'Ms Example' - this will only succeed if account '100001' also has the name 'Ms Example' and is on the requesting tag.

filter: account-name = 'Ms Example'
update: account-id = '100001'