Object Class types
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-setmembersmnt-bychangedsource
Example:
as-set: as-mycustomers
members: AS64501, AS64502, as-customer-downstreams
mnt-by: MAINT-EXAMPLE
changed: noc@example.net 20240101
source: RADBaut-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/route6objects viaorigin.
Required attributes:
aut-numas-nameimportexportmnt-bychangedsource
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: RADBfilter-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/exportpolicies or tools like bgpq3.
Required attributes:
filter-setfiltermnt-bychangedsource
Example:
filter-set: fltr-peers
filter: { 192.0.2.0/24^+ }
mnt-by: MAINT-EXAMPLE
changed: noc@example.net 20240101
source: RADBinet-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-rtrlocal-asmnt-bychangedsource
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: RADBkey-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-certmethodownerfingerprcertifmnt-bychangedsource
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: RADBmntner
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:
mntnerdescrauthmnt-bychangedsource
Example:
mntner: MAINT-EXAMPLE
descr: Example Inc Maintainer
auth: BCRYPT-PW <hash>
mnt-by: MAINT-EXAMPLE
changed: admin@example.net 20240101
source: RADBpeering-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-setpeeringmnt-bychangedsource
Example:
peering-set: prng-ix1
peering: AS64501 at 203.0.113.1
mnt-by: MAINT-EXAMPLE
changed: routing@example.net 20240101
source: RADBperson
Purpose:
Describes an individual contact person responsible for networking operations.
Typical Usage:
Referenced in
admin-cortech-cof other objects.Must be registered before being used as a contact.
Required attributes:
personaddressphonee-mailnic-hdlmnt-bychangedsource
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: RADBrole
Purpose:
Describes a group role (e.g., NOC, abuse desk), used as a contact point.
Typical Usage:
Referenced in
admin-cortech-c.Preferred over person for general/shared contacts.
Required attributes:
roleaddressphonee-mailnic-hdlmnt-bychangedsource
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: RADBroute
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:
routeoriginmnt-bychangedsource
Example:
route: 203.0.113.0/24
origin: AS64500
mnt-by: MAINT-EXAMPLE
changed: routing@example.net 20240101
source: RADBroute6
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:
route6originmnt-bychangedsource
Example:
route6: 2001:db8::/32
origin: AS64500
mnt-by: MAINT-EXAMPLE
changed: ipv6@example.net 20240101
source: RADBroute-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-setmembersmnt-bychangedsource
Example:
route-set: rs-customer
members: 198.51.100.0/24, rs-downstreams
mnt-by: MAINT-EXAMPLE
changed: routing@example.net 20240101
source: RADBrtr-set
Purpose:
Groups routers by hostname or IP address.
Typical Usage:
Used with
inet-rtrobjects for modeling BGP peering or configuration templates.
Required attributes:
rtr-setmembersmnt-bychangedsource
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.