Register a NAS
POST
/api/v1/admin/nas
prm_nas_create
Creates the device record and its RADIUS shared secret. At least one of nas_identifier, nas_ip and called_station_id must be present — that is what an incoming RADIUS packet will be matched on.
A 409 here can be caused by a device belonging to a tenant you cannot see. The three identity columns are globally unique because RADIUS resolves on the bare key before any tenant is known, so "already taken" does not mean "already in your list".
نظرة سريعة
- المصادقة
- رمز موظّف أو جلسة
- تتطلب صلاحية
-
prm_nas_createAdd NAS - حد المعدل
t_mutate
المعاملات
| المعامل | الوصف |
|---|---|
shared_secretمطلوب
body · string
|
The RADIUS shared secret. Required. |
nas_identifier
body · string
|
NAS-Identifier. Unique across the whole platform. |
nas_ip
body · string
|
NAS-IP-Address. Unique across the whole platform. |
called_station_id
body · string
|
Called-Station-Id. Unique across the whole platform. |
vendor
body · string
|
Device vendor. Validated against the known-vendor catalogue. |
coa_port
body · integer
|
RFC 5176 port. Omit for the schema default of 3799. |
ip_accounting_enabled
body · boolean
|
Defaults to true when omitted. An explicit false is honoured. |
الأخطاء
| الرمز | متى تُرجَع |
|---|---|
ERR_VALIDATION400
|
shared_secret missing, no identity field supplied, or an unknown vendor |
ERR_CONFLICT409
|
the nas_ip, nas_identifier or called_station_id is already registered — possibly by another tenant |