Object Class types

Object Class types

1 as-set | 2 aut-num | 3 filter-set | 4 inet-rtr | 5 key-cert | 6 mntner | 7 peering-set | 8 person | 9 role | 10 route | 11 route6 | 12 route-set | 13 rtr-set

Each Object class has a number of attributes associated with it. These attributes are also documented here - Object Attributes. For a full reference on the standard, please refer to RFC 2622: Routing Policy Specification Language.

as-set

Purpose:
Defines a named group of AS numbers or other as-sets. Commonly used to simplify import/export filters or build hierarchical groupings of autonomous systems.

Typical Usage:

  • To define all ASNs used by a customer, peer, or organization.

  • To reference in routing policy (e.g., in import/export statements).

Required attributes:

  • as-set

  • members

  • mnt-by

  • changed

  • source

Example:

as-set: as-mycustomers members: AS64501, AS64502, as-customer-downstreams mnt-by: MAINT-EXAMPLE changed: noc@example.net 20240101 source: RADB

aut-num

Purpose:
Defines routing policy for an Autonomous System (AS). Describes how the AS interacts with upstream, downstream, and lateral peers.

Typical Usage:

  • To register your AS and define BGP policies.

  • Referenced in route/route6 objects via origin.

Required attributes:

  • aut-num

  • as-name

  • import

  • export

  • mnt-by

  • changed

  • source

Example:

aut-num: AS64500 as-name: EXAMPLE-AS import: from AS64501 accept ANY export: to AS64501 announce AS64500 mnt-by: MAINT-EXAMPLE changed: routing@example.net 20240101 source: RADB

filter-set

Purpose:
Represents a reusable named filter for route expressions, such as IP prefixes, as-paths, or communities.

Typical Usage:

  • To define custom routing filters in a reusable object.

  • Used in import/export policies or tools like bgpq3.

Required attributes:

  • filter-set

  • filter

  • mnt-by

  • changed

  • source

Example:

filter-set: fltr-peers filter: { 192.0.2.0/24^+ } mnt-by: MAINT-EXAMPLE changed: noc@example.net 20240101 source: RADB

inet-rtr

Purpose:
Describes a specific router (by name), its interfaces, local AS, and BGP peerings.

Typical Usage:

  • To define router-level configuration in RPSL.

  • Used in network documentation or router grouping (rtr-set).

Required attributes:

  • inet-rtr

  • local-as

  • mnt-by

  • changed

  • source

Example:

inet-rtr: router1.example.net alias: r1.example.net local-as: AS64500 ifaddr: 198.51.100.1 masklen 24 peer: BGP4 198.51.100.2 asno(AS64501) mnt-by: MAINT-EXAMPLE changed: noc@example.net 20240101 source: RADB

key-cert

Purpose:
Publishes a public PGP key used to cryptographically sign object submissions for authentication.

Note: The RADb Web Portal currently does not support key-cert–based updates.

You will need to upload the key-cert object via email (auto-dbm) or API

Typical Usage:

  • For securing updates to RADb using PGP/GPG.

  • Required for PGP/GPG-based authorization on maintained objects.

Required attributes:

  • key-cert

  • method

  • owner

  • fingerpr

  • certif

  • mnt-by

  • changed

  • source

Example:

key-cert: PGPKEY-12345678 method: PGP owner: John Example <john@example.net> fingerpr: 1234 5678 9ABC DEF0 1234 5678 9ABC DEF0 1234 5678 certif: -----BEGIN PGP PUBLIC KEY BLOCK----- certif: certif: mQENBF6d8i8BCADY5XASXUEaZ0Z0zkXogUMc7pHTpV4O0uyKJhfEvNhdQgVxL5Tw certif: 3djZc93bcMGQK5XgEbT9Orph+eJ7HnEC+uZcvWSwOtJzAxCgL3i+CuI3PI0I0FAO certif: ... certif: =ABCD certif: -----END PGP PUBLIC KEY BLOCK----- mnt-by: MAINT-EXAMPLE changed: john@example.net 20240101 source: RADB

mntner

Purpose:
Defines who has authorization to update, delete, or create objects in RADb.

Typical Usage:

  • Every object must be protected by at least one mntner.

  • Typically tied to an organization or network's AS.

Required attributes:

  • mntner

  • descr

  • auth

  • mnt-by

  • changed

  • source

Example:

mntner: MAINT-EXAMPLE descr: Example Inc Maintainer auth: BCRYPT-PW <hash> mnt-by: MAINT-EXAMPLE changed: admin@example.net 20240101 source: RADB

peering-set

Purpose:
Represents a group of BGP peerings. Used for routing policy automation.

Typical Usage:

  • Define all peerings for a particular region, IXP, or customer.

  • Referenced in policy statements or BGP templates.

Required attributes:

  • peering-set

  • peering

  • mnt-by

  • changed

  • source

Example:

peering-set: prng-ix1 peering: AS64501 at 203.0.113.1 mnt-by: MAINT-EXAMPLE changed: routing@example.net 20240101 source: RADB

person

Purpose:
Describes an individual contact person responsible for networking operations.

Typical Usage:

  • Referenced in admin-c or tech-c of other objects.

  • Must be registered before being used as a contact.

Required attributes:

  • person

  • address

  • phone

  • e-mail

  • nic-hdl

  • mnt-by

  • changed

  • source

Example:

person: John Smith address: 123 Main St, Anytown, USA phone: +1 555 123 4567 e-mail: jsmith@example.net nic-hdl: JS123-RADB mnt-by: MAINT-EXAMPLE changed: jsmith@example.net 20240101 source: RADB

role

Purpose:
Describes a group role (e.g., NOC, abuse desk), used as a contact point.

Typical Usage:

  • Referenced in admin-c or tech-c.

  • Preferred over person for general/shared contacts.

Required attributes:

  • role

  • address

  • phone

  • e-mail

  • nic-hdl

  • mnt-by

  • changed

  • source

Example:

role: Example NOC address: 456 Network Way phone: +1 555 987 6543 e-mail: noc@example.net nic-hdl: NOC1-RADB mnt-by: MAINT-EXAMPLE changed: noc@example.net 20240101 source: RADB

route

Purpose:
Registers an IPv4 route announcement and origin ASN.

Typical Usage:

  • Required to allow ASNs to propagate prefixes via IRR filters.

  • Used by upstreams and peers for routing validation.

Required attributes:

  • route

  • origin

  • mnt-by

  • changed

  • source

Example:

route: 203.0.113.0/24 origin: AS64500 mnt-by: MAINT-EXAMPLE changed: routing@example.net 20240101 source: RADB

route6

Purpose:
Registers an IPv6 route and origin ASN.

Typical Usage:

  • Same use as route, but for IPv6.

  • Included in IRR-based prefix lists.

Required attributes:

  • route6

  • origin

  • mnt-by

  • changed

  • source

Example:

route6: 2001:db8::/32 origin: AS64500 mnt-by: MAINT-EXAMPLE changed: ipv6@example.net 20240101 source: RADB

route-set

Purpose:
Defines a set of route prefixes or other route-sets.

Typical Usage:

  • Used to group prefixes for easier policy management.

  • Often used in large import/export policies.

Required attributes:

  • route-set

  • members

  • mnt-by

  • changed

  • source

Example:

route-set: rs-customer members: 198.51.100.0/24, rs-downstreams mnt-by: MAINT-EXAMPLE changed: routing@example.net 20240101 source: RADB

rtr-set

Purpose:
Groups routers by hostname or IP address.

Typical Usage:

  • Used with inet-rtr objects for modeling BGP peering or configuration templates.

Required attributes:

  • rtr-set

  • members

  • mnt-by

  • changed

  • source

Example:

rtr-set: rtrs-core members: router1.example.net, router2.example.net mnt-by: MAINT-EXAMPLE changed: admin@example.net 20240101 source: RADB

 

Please contact RADb Support for Assistance at support@radb.net or (734) 527-5776.