APNIC Home

mntner

Object Template

The object template includes information on how to complete the attribute values.

               Status       Instance     Search Status

mntner:        [mandatory]  [single]     [primary/lookup key]
descr:          [mandatory]  [multiple]   [ ]
country:        [optional]   [single]     [ ]
admin-c:        [mandatory]  [multiple]   [inverse key]
tech-c:         [optional]   [multiple]   [inverse key]
upd-to:         [mandatory]  [multiple]   [inverse key]
mnt-nfy:        [optional]   [multiple]   [inverse key]
auth:           [mandatory]  [multiple]   [inverse key]
remarks:        [optional]   [multiple]   [ ]
notify:         [optional]   [multiple]   [inverse key]
abuse-mailbox:  [optional]   [multiple]   [inverse key]
mnt-by:         [mandatory]  [multiple]   [inverse key]
referral-by:    [mandatory]  [single]     [inverse key]
last-modified:  [generated]  [single]     [ ]
source:         [mandatory]  [single]     [ ]

Example

mntner:       MAINT-NZ-EXAMPLENET
descr:        maintainer for Example net Pty Ltd
country:      NZ
admin-c:      DE345-AP
tech-c:       DE345-AP
upd-to:       abc@examplenet.com
mnt-nfy:      abc@examplenet.com
auth:         SSO abc@examplenet.com
notify:       manager@examplenet.com
mnt-by:       MAINT-EXAMPLENET-AP
referral-by:  APNIC-HM
last-modified:2018-08-30T07:50:19Z
source:       APNIC

role:         D EXAMPLENETADMIN
address:      123 Example st.
address:      20097 Exampletown
country:      AU
phone:        +12 34 567890 000
fax-no:       +12 34 567890 010
e-mail:       noc@examplenet.com
admin-c:      ABC123-AP           
tech-c:       ABC123-AP           
nic-hdl:      DE345-AP    
remarks:      http://www.examplenet.com.au
notify:       hostmaster@examplenet.com.au   
mnt-by:       MAINT-EXAMPLENET-AP         
last-modified:2018-08-30T07:50:19Z               
source:       APNIC

Attribute status

Mandatory

Attribute must be included in the object.  Failure to do so will result in errors.

Attribute Description
mntner The unique name of a mntner object. APNIC recommends the following formats: Maintainer for resource registrations:

<maint>-<iso3166-code>-<organization>

EXAMPLE 
MAINT-WF-SPARKYNET

Maintainer for a ‘person’ object:

<maint>-<iso3166-code>-<person>

EXAMPLE
MAINT-WF-ZANE-ULRICH
descr A short description of the mntner object and the name of the organization associated with it.
admin-c The NIC-handle of an on-site contact ‘person’ object. As more than one person often fulfills a role function, there may be more than one admin-c listed.

  • In the web interface, the admin-c attribute contains a link to the ‘person‘ object the NIC-handle belongs to.
  • An administrative contact (admin-c) must be someone who is physically located at the site of the network.
upd-to The email address to be notified when attempts to update objects protected by the mntner are rejected due to a lack of authentication.
auth Defines the authentication scheme to be used to link resources (aut-num, inetnum, inet6num) to this maintainer object. Authentication options available are:

SSO
PGP-KEY
APITOKN (For Registry API users)

EXAMPLE
auth: SSO abc@examplenet.com 
auth: PGP-499E1F0A

Note: Password authentication is being deprecated for IRT and maintainer objects. Password auth attributes in these objects will be replaced by SSO auth attributes that contain the APNIC login email of the user who is authorized to use the maintainer.

For invalid IRTs, please reach out to the owner to add your APNIC login email as an SSO auth attribute to the object.
mnt-by Lists a registered mntner used to authorize and authenticate changes to this object.

  • A mntner object is a database object used to authorize updates to the APNIC database.
  • When your database details are protected by a mntner object, then only persons with access to the security information of that mntner object will be able to change details.
  • In the web interface, the mnt-by attribute contains a link to the specified mntner.
referral-by The maintainer that created this mntner object. Once the mntner object has been created, this attribute cannot be altered. All mntner objects are manually created by APNIC hostmasters, so this attribute will contain:

APNIC-HM
last-modified It is a time stamp that is generated by the system to reflect when the object was last modified.

last-modified: 2018-08-30T07:50:19Z
source The name of the database from which the data was obtained.

  • Use APNIC for objects in the APNIC Database.
  • Please use UPPERCASE letters.

Optional

Attribute may be deleted from the object. To delete an optional attribute you must also remove the attribute from the object template.  Failure to do so will result in errors.

Attribute Description
country Two letter ISO 3166 code of the country or economy where the admin-c is based. Please use UPPERCASE letters.

EXAMPLE
country: WF
tech-c The NIC-handle of a technical contact ‘person’ or ‘role’ object.  As more than one person often fulfills a role function, there may be more than one tech-c listed.

  • In the web interface, the tech-c attribute contains a link to the ‘person’ or ‘role’ object to which the NIC-handle belongs to.
  • A technical contact (tech-c) must be a person responsible for the day-to-day operation of the network, but does not need to be physically located at the site of the network.
mnt-nfy The email address to be notified when an object protected by a mntner is successfully updated.
remarks General remarks. May include a URL or email address.
notify The email address to which notifications of changes to this object should be sent.

Generated

Attribute value is generated by the database.

Updating

This object can be created and updated in MyAPNIC.

Instances of attribute allowed

Single
 Attribute must appear only once in the object.
Multiple
 Attribute may appear multiple times in the object. For example, you may wish to include more than one admin-c attribute.

Attribute search status

Primary key
 Primary keys distinguish an object from all other objects in the database. To update a primary key, you must delete the entire object and them create a new object with the updated information.
Lookup key
 Attribute can be queried in the database to return the object.  Please note, however, that a lookup key does not uniquely identify an object.
Inverse key
 Attribute can be used when performing an inverse query using the -i flag. For example, the query

-i mntner <MNTNER-NAME>

will return all objects with the specified maintainer in the mnt-by attribute.