diff --git a/docs/models/ipam/asn.md b/docs/models/ipam/asn.md index e34790406..8de3cfd93 100644 --- a/docs/models/ipam/asn.md +++ b/docs/models/ipam/asn.md @@ -1,8 +1,8 @@ -# ASN +# ASNs An Autonomous System Number (ASN) is a numeric identifier used in the BGP protocol to identify which [autonomous system](https://en.wikipedia.org/wiki/Autonomous_system_%28Internet%29) a particular prefix is originating and transiting through. NetBox support both 32- and 64- ASNs. -ASNs must be globally unique within NetBox, must each may be assigned to multiple [sites](../dcim/site.md). +ASNs must be globally unique within NetBox, and may be allocated from within a [defined range](./asnrange.md). Each ASN may be assigned to multiple [sites](../dcim/site.md). ## Fields diff --git a/docs/models/ipam/asnrange.md b/docs/models/ipam/asnrange.md new file mode 100644 index 000000000..30d2f49c3 --- /dev/null +++ b/docs/models/ipam/asnrange.md @@ -0,0 +1,21 @@ +# ASN Ranges + +Ranges can be defined to group [AS numbers](./asn.md) numerically and to facilitate their automatic provisioning. Each range must be assigned to a [RIR](./rir.md). + +## Fields + +### Name + +A unique human-friendly name for the range. + +### Slug + +A unique URL-friendly identifier. (This value can be used for filtering.) + +### RIR + +The [Regional Internet Registry](./rir.md) or similar authority responsible for the allocation of AS numbers within this range. + +### Start & End + +The starting and ending numeric boundaries of the range (inclusive). diff --git a/docs/release-notes/version-3.5.md b/docs/release-notes/version-3.5.md index 29bb5d82f..6cbdefe18 100644 --- a/docs/release-notes/version-3.5.md +++ b/docs/release-notes/version-3.5.md @@ -20,6 +20,10 @@ This release introduces the ability to render device configurations from Jinja2 The NAPALM integration feature found in previous NetBox releases has been moved from the core application to a dedicated plugin. This allows greater control over the feature's configuration and will unlock additional potential as a separate project. +#### ASN Ranges ([#8550](https://github.com/netbox-community/netbox/issues/8550)) + +A new ASN range model has been introduced to facilitate the provisioning of new autonomous system numbers from within a prescribed range. For example, an administrator might define an ASN range of 65000-65099 to be used for internal site identification. This includes a REST API endpoint suitable for automatic provisioning, very similar to the allocation of available prefixes and IP addresses. + ### Enhancements * [#9073](https://github.com/netbox-community/netbox/issues/9073) - Enable syncing config context data from remote sources diff --git a/mkdocs.yml b/mkdocs.yml index 2487176d3..2c24d2e00 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -215,6 +215,7 @@ nav: - Webhook: 'models/extras/webhook.md' - IPAM: - ASN: 'models/ipam/asn.md' + - ASNRange: 'models/ipam/asnrange.md' - Aggregate: 'models/ipam/aggregate.md' - FHRPGroup: 'models/ipam/fhrpgroup.md' - FHRPGroupAssignment: 'models/ipam/fhrpgroupassignment.md'