APNIC Home

inetnum

Object Template

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

                Status       Instance     Search Status

inetnum:        [mandatory]  [single]     [primary/lookup key]
netname:        [mandatory]  [single]     [lookup key]
descr:          [mandatory]  [multiple]   [ ]
country:        [mandatory]  [multiple]   [ ]
geofeed:        [optional]   [single]     [ ]
geoloc:         [optional]   [single]     [ ]
language:       [optional]   [multiple]   [ ]
org:            [optional]   [single]     [inverse key]
admin-c:        [mandatory]  [multiple]   [inverse key]
tech-c:         [mandatory]  [multiple]   [inverse key]
abuse-c:        [optional]   [single]     [inverse key]
status:         [mandatory]  [single]     [ ]
remarks:        [optional]   [multiple]   [ ]
notify:         [optional]   [multiple]   [inverse key]
mnt-by:         [mandatory]  [multiple]   [inverse key]
mnt-lower:      [optional]   [multiple]   [inverse key]
mnt-routes:     [optional]   [multiple]   [inverse key]
mnt-irt:        [mandatory]  [multiple]   [inverse key]
last-modified:  [generated]  [single]     [ ]
source:         [mandatory]  [single]     [ ]

Example

inetnum:        192.168.1.0 - 192.168.1.255
netname:        EXAMPLENET-AP
descr:          Example net Pty Ltd
country:        AP
admin-c:        DE345-AP
tech-c:         DE345-AP
status:         ASSIGNED NON-PORTABLE
mnt-by:         MAINT-EXAMPLENET-AP
mnt-irt:        IRT-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
inetnum The range of IP address space described by the object.
netname The name of a range of IP address space.
descr Description of the organization allocated or assigned the address space shown in the inetnum.
country Two letter ISO 3166 code of the country or economy where the admin-c is based.

Please use UPPERCASE letters.

EXAMPLE
country: WF
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.
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.
abuse-c References an abuse contact. This can only be a ROLE object containing an “abuse-mailbox:” attribute. Making this reference will remove any query limits for the ROLE object. These ROLE objects are considered to include only commercial data.

  • From 2 to 4 characters optionally followed by up to 5 digits with the suffix “-AP”. The first digit must not be “0”.
status All inetnum objects under APNIC Whois Database must have a status attribute. The status attribute must be one of the following values:

Status Definition
Allocated
Portable		 Value set by: APNIC/NIR Only

Address space allocated by APNIC or NIRs to LIRs for the purpose of subsequent distribution by LIRs to their customers.  These allocations remain valid if the network changes upstream provider.
Allocated
Non-Portable		 Value set by: LIR/ISP

Address space allocated by LIRs to their customers for subsequent assignment by those customers.  These allocations (and assignments made from these allocations) must be returned if the network changes upstream provider.
Assigned
Portable		 Value set by: APNIC/NIR Only

Assignments made by APNIC or NIRs, for example, small multihoming assignments or IXP assignments. These assignments remain valid if the network changes upstream provider.
Assigned
Non-Portable		 Value set by: LIR/ISP

Assignments made by LIRs to their customers for specific use within the Internet infrastructure they operate. Assignments must only be made for specific, documented purposes and may not be sub-assigned.; These assignments must be returned if the network changes upstream provider.
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’.
mnt-irt The identifier of a registered ‘mntner’ object used to provide information about a Computer Security Incident Response Team (CSIRT).
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 database where the object is registered.

  • 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
org Points to an existing organisation object representing the entity that holds the resource.

  • The ‘ORG-‘ string followed by 2 to 4 characters, followed by up to 5 digits followed by a source specification. The first digit must not be “0”. Source specification starts with “-” followed by source name up to 9-character length.
geofeed A URL referencing a CSV file containing geolocation data for the resource (see RFC 8805).

  • Geofeed is a self-published format for IP geolocation data (see RFC 8805).
  • A URL referencing a CSV file containing geolocation data for the resource.
  • The URL must be valid and it must specify the HTTPS protocol.
EXAMPLE
inetnum: 192.0.2.0/24 # example
geofeed: https://example.com/geofeed.csv
geoloc A latitude/longitude coordinate indicating where users of this network are located. Provides a hint to content and geolocation service providers. A blank space should be used as a separator between the two coordinates.

EXAMPLE
geoloc: -27.472834 153.014264
language A two-letter ISO 639-1 language code indicating a language users of this network could be expected to understand. Provides a hint to content providers.

Multiple language attributes can be provided to suggest several languages.
remarks General remarks. May include a URL or instructions on where to send abuse complaints.
notify The email address to which notifications of changes to this object should be sent.
mnt-lower Sometimes there is a hierarchy of maintainers. In these cases, mnt-lower is used as well as ‘mnt-by.’
mnt-routes The identifier of a registered ‘mntner’ object used to control the creation of ‘route’ objects associated with the address range specified by the inetnum object.

Generated

Attribute value is generated by the database.

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.