BULK RELEASE changes the tag of the domain names matching given filter. It is a flexible method for releasing large numbers of 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 RELEASE operations may include the following:

operation: bulk
update:
filter:
dry-run:

BULK RELEASE 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 RELEASE operations, changes must be made to registar-tag, and optionally to account-id; no other fields can be modified. An optional filter clause chooses which domain names are released by specifying criteria which they must match; if no filter clause is given, then all domain names on the requesting tag are released. An optional dry-run clause will return details of the outcome of the operation without committing any changes to the register.

Reply template

The reply to the request

operation: bulk
update: registrar-tag='OTHERTAG'

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 released:
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: registrar-tag='OTHERTAG'

 

Dry-run

The reply to the request

operation: bulk
update: registrar-tag='OTHERTAG'
dry-run:

will be in the form

Subject: Re: TAG bulk - DRY-RUN

Domain list before the change:
Domain name|registrar-tag
example.co.uk|TAG
Number of domains in the list: 1.


Domain list after the change:
Domain name|registrar-tag
example.co.uk|OTHERTAG
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: registrar-tag='OTHERTAG'
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

Release all domain names

Omitting a filter clause releases all domain names on the requesting tag.

operation: bulk
update: registrar-tag='OTHERTAG'

Release domain names filtered by key

This releases all domain names on the requesting tag that match a wildcard search string.

operation: bulk
filter: key like 'example.%.uk'
update: registrar-tag = 'OTHERTAG'

Dry-run

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

operation:bulk
update: registrar-tag = 'OTHERTAG'
dry-run:

Release to specified account id

This releases all domain names on the requesting tag to the account with id '100001' on the target tag 'OTHERTAG'

operation: bulk
update: registrar-tag ='OTHERTAG', account-id='100001'

Releasing an account

If all domains on an account are released, the account itself is also moved to the target tag. This moves account with id '100002' onto the tag 'OTHERTAG', along with all its domain names.

filter: account-id = '100002'
update: registrar-tag = 'OTHERTAG'

Release multiple accounts with same name

This will release all the domain names on all accounts with account name 'Miss Example':

filter: account-name = 'Miss Example'
update: registrar-tag = 'OTHERTAG'