Skip to content

Radius Attribute Group (1.0.9)

Overview

The RADIUS Attribute Group Management API provides comprehensive management of RADIUS attribute groups for network authentication and authorization. RADIUS is a networking protocol that provides centralized authentication, authorization, and accounting management. This API enables organizations to create, modify, and delete RADIUS attribute groups that contain standardized network parameters used in wireless and wired network access control.

What This API Does

  • Create and manage RADIUS attribute groups: Organize RADIUS attributes into logical groups for easier management
  • Assign attributes to groups: Associate specific RADIUS attributes with groups. The complete list of available RADIUS attributes can be retrieved through the API endpoint /radiusAttributes.
  • Query available RADIUS attributes: Browse and search through available RADIUS attributes by vendor, data type, and name
  • Manage external service assignments: Link attribute groups to external services and systems for distributed authentication

Technical Details

  • Content Types: Supports application/json and application/vnd.ruckus.v1+json
  • API Version: v1.0.9
  • Data Formats: JSON with HATEOAS links for resource navigation
  • Pagination: Standard pagination with configurable page sizes

Common Use Cases

  • Wireless Network Access: Configure RADIUS attributes for Wi-Fi authentication
  • VPN Access Control: Manage user access policies through RADIUS attribute groups
  • Guest Network Management: Create attribute groups for different user types

Authentication

All API calls require valid authentication via Bearer token in Authorization header. Include the JWT token in the Authorization: Bearer <token> header.

Error Handling

The API uses standard HTTP status codes with detailed error messages in the response body. All error responses include a requestId for tracking and debugging purposes.

Common Error Responses

All endpoints may return these common error responses:

  • 400 Bad Request: Invalid input data or validation errors
  • 401 Unauthorized: Missing or invalid authentication
  • 403 Forbidden: Insufficient permissions
  • 404 Not Found: Requested resource doesn't exist
  • 409 Conflict: Resource conflict (e.g., duplicate names)
  • 422 Unprocessable Entity: Business rule violations
  • 500 Internal Server Error: Unexpected server errors
Download OpenAPI description
Languages
Servers
RUCKUS One API host for North American region.
https://api.ruckus.cloud
RUCKUS One API host for European region.
https://api.eu.ruckus.cloud
RUCKUS One API host for Asian region.
https://api.asia.ruckus.cloud

RADIUS Attribute Group

Comprehensive management of RADIUS attribute groups including creation, modification, deletion, and querying. Provides full CRUD operations for organizing RADIUS attributes into logical groups for network authentication and authorization.

Operations

Get RADIUS Attribute Groups

Request

Gets the complete list of RADIUS attribute group in a paged format.

Query
sizeany

Page size

pageany

The page to retrieve (starts at zero).

sortany

The field name to sort, comma separated from the sort order (asc or desc).

No request payload

Responses

Radius attribute groups paged.

Body
idstring(uuid)

The unique identifier for this attribute group.

namestringrequired

The name for this attribute group.

descriptionstring

The description for this attribute group.

attributeAssignmentsArray of objects(Attribute Assignment)required

The RADIUS attributes that are assigned to this group.

attributeAssignments[].​attributeNamestring[ 0 .. 255 ] charactersrequired

The RADIUS attribute name to use. This should be from the list of supported RADIUS attributes. The complete list of available RADIUS attributes can be retrieved through the /radiusAttributes API endpoint. For standard RADIUS attributes, refer to Request for Comments 2865. Vendor specific attributes are identified by their vendor name.

attributeAssignments[].​operatorstringrequired

The operator to use for attribute assignment. ADD: Adds the attribute value to the response if it does not already exist. ADD_REPLACE: Adds the attribute value to the response, replacing any existing value for the same attribute. DOES_NOT_EXIST: Assigns the attribute value only if the attribute does not already exist in the response.

Enum"ADD""ADD_REPLACE""DOES_NOT_EXIST"
attributeAssignments[].​attributeValuestring[ 0 .. 4096 ] charactersrequired

The assignment value to be returned for this RADIUS attribute. The value must conform to the data type specified for the attribute. Maximum length is 4096 characters.

attributeAssignments[].​dataTypestringrequired

The data type for this attribute value. The value must match one of the specified data types. The data type determines how the attributeValue is validated and formatted. For example, IPADDR expects a valid IPv4 address, IPV6ADDR expects a valid IPv6 address, INTEGER expects a numeric value, and STRING accepts alphanumeric text. Refer to the RADIUS Attribute schema for the specific data type definition of the selected attribute.

Enum"ABINARY""BYTE""COMBO_IP""DATE""ETHER""IFID""INTEGER""IPADDR""IPV6ADDR""IPV6PREFIX"
attributeCountinteger(int32)

The number of RADIUS attribute assignments within this attribute group. Allows sorting and filtering.

externalAssignmentsCountinteger(int32)

The total count of external service assignments for this attribute group across all services. Allows sorting and filtering.

externalServiceAssignmentsArray of objects(External Assignment Service Group)

The list of external service assignments grouped by service name, showing which services have assigned this attribute group and their associated external assignment identifiers.

_linksobject(Links)

Hypermedia links for HATEOAS navigation, including self reference and related resources.

Response
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "description": "string", "attributeAssignments": [ {} ], "attributeCount": 0, "externalAssignmentsCount": 0, "externalServiceAssignments": [ {} ], "_links": { "property1": {}, "property2": {} } }

Create RADIUS Attribute Group

Request

Creates a new RADIUS attribute group with the specified name, description, and attribute assignments. The group will be associated with the authenticated tenant and can be used for network authentication and authorization policies.

Bodyrequired
idstring(uuid)

The unique identifier for this attribute group.

namestringrequired

The name for this attribute group.

descriptionstring

The description for this attribute group.

attributeAssignmentsArray of objects(Attribute Assignment)required

The RADIUS attributes that are assigned to this group.

attributeAssignments[].​attributeNamestring[ 0 .. 255 ] charactersrequired

The RADIUS attribute name to use. This should be from the list of supported RADIUS attributes. The complete list of available RADIUS attributes can be retrieved through the /radiusAttributes API endpoint. For standard RADIUS attributes, refer to Request for Comments 2865. Vendor specific attributes are identified by their vendor name.

attributeAssignments[].​operatorstringrequired

The operator to use for attribute assignment. ADD: Adds the attribute value to the response if it does not already exist. ADD_REPLACE: Adds the attribute value to the response, replacing any existing value for the same attribute. DOES_NOT_EXIST: Assigns the attribute value only if the attribute does not already exist in the response.

Enum"ADD""ADD_REPLACE""DOES_NOT_EXIST"
attributeAssignments[].​attributeValuestring[ 0 .. 4096 ] charactersrequired

The assignment value to be returned for this RADIUS attribute. The value must conform to the data type specified for the attribute. Maximum length is 4096 characters.

attributeAssignments[].​dataTypestringrequired

The data type for this attribute value. The value must match one of the specified data types. The data type determines how the attributeValue is validated and formatted. For example, IPADDR expects a valid IPv4 address, IPV6ADDR expects a valid IPv6 address, INTEGER expects a numeric value, and STRING accepts alphanumeric text. Refer to the RADIUS Attribute schema for the specific data type definition of the selected attribute.

Enum"ABINARY""BYTE""COMBO_IP""DATE""ETHER""IFID""INTEGER""IPADDR""IPV6ADDR""IPV6PREFIX"
attributeCountinteger(int32)

The number of RADIUS attribute assignments within this attribute group. Allows sorting and filtering.

externalAssignmentsCountinteger(int32)

The total count of external service assignments for this attribute group across all services. Allows sorting and filtering.

externalServiceAssignmentsArray of objects(External Assignment Service Group)

The list of external service assignments grouped by service name, showing which services have assigned this attribute group and their associated external assignment identifiers.

_linksobject(Links)

Hypermedia links for HATEOAS navigation, including self reference and related resources.

{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "description": "string", "attributeAssignments": [ {} ], "attributeCount": 0, "externalAssignmentsCount": 0, "externalServiceAssignments": [ {} ], "_links": { "property1": {}, "property2": {} } }

Responses

RADIUS attribute group created

Body
idstring(uuid)

The unique identifier for this attribute group.

namestringrequired

The name for this attribute group.

descriptionstring

The description for this attribute group.

attributeAssignmentsArray of objects(Attribute Assignment)required

The RADIUS attributes that are assigned to this group.

attributeAssignments[].​attributeNamestring[ 0 .. 255 ] charactersrequired

The RADIUS attribute name to use. This should be from the list of supported RADIUS attributes. The complete list of available RADIUS attributes can be retrieved through the /radiusAttributes API endpoint. For standard RADIUS attributes, refer to Request for Comments 2865. Vendor specific attributes are identified by their vendor name.

attributeAssignments[].​operatorstringrequired

The operator to use for attribute assignment. ADD: Adds the attribute value to the response if it does not already exist. ADD_REPLACE: Adds the attribute value to the response, replacing any existing value for the same attribute. DOES_NOT_EXIST: Assigns the attribute value only if the attribute does not already exist in the response.

Enum"ADD""ADD_REPLACE""DOES_NOT_EXIST"
attributeAssignments[].​attributeValuestring[ 0 .. 4096 ] charactersrequired

The assignment value to be returned for this RADIUS attribute. The value must conform to the data type specified for the attribute. Maximum length is 4096 characters.

attributeAssignments[].​dataTypestringrequired

The data type for this attribute value. The value must match one of the specified data types. The data type determines how the attributeValue is validated and formatted. For example, IPADDR expects a valid IPv4 address, IPV6ADDR expects a valid IPv6 address, INTEGER expects a numeric value, and STRING accepts alphanumeric text. Refer to the RADIUS Attribute schema for the specific data type definition of the selected attribute.

Enum"ABINARY""BYTE""COMBO_IP""DATE""ETHER""IFID""INTEGER""IPADDR""IPV6ADDR""IPV6PREFIX"
attributeCountinteger(int32)

The number of RADIUS attribute assignments within this attribute group. Allows sorting and filtering.

externalAssignmentsCountinteger(int32)

The total count of external service assignments for this attribute group across all services. Allows sorting and filtering.

externalServiceAssignmentsArray of objects(External Assignment Service Group)

The list of external service assignments grouped by service name, showing which services have assigned this attribute group and their associated external assignment identifiers.

_linksobject(Links)

Hypermedia links for HATEOAS navigation, including self reference and related resources.

Response
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "description": "string", "attributeAssignments": [ {} ], "attributeCount": 0, "externalAssignmentsCount": 0, "externalServiceAssignments": [ {} ], "_links": { "property1": {}, "property2": {} } }

Get RADIUS Attribute Groups

Request

Gets the list of RADIUS attribute groups using the specified query.

Query
excludeContentboolean
Default false
Bodyrequired
sortFieldstring

The field name to use for sorting the results. Valid field names depend on the resource being queried. For RADIUS attributes, valid values include: id, name, vendorName, dataType, showOnDefault. For RADIUS attribute groups, valid values include: id, name, description, attributeCount, externalAssignmentsCount. For attribute group assignments, valid values include: id, externalAssignmentIdentifier, serviceName. The field name must match exactly one of the supported sortable fields for the resource type.

Example: "name"
sortOrderstring

The sort order of the applied query.

Enum"ASC""DESC"
pageinteger(int32)>= 0

The page number to return, indexed starting with 0.

pageSizeinteger(int32)[ 1 .. 2000 ]

The number of items requested on the page.

filtersobject

A map of filter criteria to apply to the query results. Each key represents a field name to filter on, and the value is the filter condition. Supported filter formats depend on the resource type. Examples: {"name": "John Doe"} for exact match on attribute names, {"vendorName": "Cisco"} for vendor filtering, {"attributeCount": {"gte": 5}} for range queries. Filter keys must match valid field names for the resource being queried.

Example: {"name":"Sally Smith","vendorName":"Cisco"}
{ "sortField": "name", "sortOrder": "ASC", "page": 0, "pageSize": 1, "filters": { "name": "Sally Smith", "vendorName": "Cisco" } }

Responses

RADIUS attribute groups

Body
totalCountinteger(int64)

Total number of items matching the query across all pages.

pageinteger(int32)>= 0

Current page number (0-based).

pageSizeinteger(int32)>= 1

Number of items per page.

dataArray of objects
Response
{ "totalCount": 0, "page": 0, "pageSize": 1, "data": [ null ] }

Get RADIUS Attribute Group

Request

Gets the requested RADIUS attribute group by the id.

Path
groupIdstring(uuid)required

RADIUS attribute group id

No request payload

Responses

RADIUS attribute group

Body
idstring(uuid)

The unique identifier for this attribute group.

namestringrequired

The name for this attribute group.

descriptionstring

The description for this attribute group.

attributeAssignmentsArray of objects(Attribute Assignment)required

The RADIUS attributes that are assigned to this group.

attributeAssignments[].​attributeNamestring[ 0 .. 255 ] charactersrequired

The RADIUS attribute name to use. This should be from the list of supported RADIUS attributes. The complete list of available RADIUS attributes can be retrieved through the /radiusAttributes API endpoint. For standard RADIUS attributes, refer to Request for Comments 2865. Vendor specific attributes are identified by their vendor name.

attributeAssignments[].​operatorstringrequired

The operator to use for attribute assignment. ADD: Adds the attribute value to the response if it does not already exist. ADD_REPLACE: Adds the attribute value to the response, replacing any existing value for the same attribute. DOES_NOT_EXIST: Assigns the attribute value only if the attribute does not already exist in the response.

Enum"ADD""ADD_REPLACE""DOES_NOT_EXIST"
attributeAssignments[].​attributeValuestring[ 0 .. 4096 ] charactersrequired

The assignment value to be returned for this RADIUS attribute. The value must conform to the data type specified for the attribute. Maximum length is 4096 characters.

attributeAssignments[].​dataTypestringrequired

The data type for this attribute value. The value must match one of the specified data types. The data type determines how the attributeValue is validated and formatted. For example, IPADDR expects a valid IPv4 address, IPV6ADDR expects a valid IPv6 address, INTEGER expects a numeric value, and STRING accepts alphanumeric text. Refer to the RADIUS Attribute schema for the specific data type definition of the selected attribute.

Enum"ABINARY""BYTE""COMBO_IP""DATE""ETHER""IFID""INTEGER""IPADDR""IPV6ADDR""IPV6PREFIX"
attributeCountinteger(int32)

The number of RADIUS attribute assignments within this attribute group. Allows sorting and filtering.

externalAssignmentsCountinteger(int32)

The total count of external service assignments for this attribute group across all services. Allows sorting and filtering.

externalServiceAssignmentsArray of objects(External Assignment Service Group)

The list of external service assignments grouped by service name, showing which services have assigned this attribute group and their associated external assignment identifiers.

_linksobject(Links)

Hypermedia links for HATEOAS navigation, including self reference and related resources.

Response
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "description": "string", "attributeAssignments": [ {} ], "attributeCount": 0, "externalAssignmentsCount": 0, "externalServiceAssignments": [ {} ], "_links": { "property1": {}, "property2": {} } }

Delete RADIUS Attribute Group

Request

Deletes the requested RADIUS attribute group.

Path
groupIdstring(uuid)required

Radius Attribute Group id

No request payload

Responses

RADIUS attribute group deleted.

Body
object(EmptyResponse)

Empty response for successful deletion operations.

Response
{}

Update RADIUS Attribute Group

Request

Updates the properties of an existing RADIUS attribute group using PATCH semantics. Allows partial updates to the group name, description, and attribute assignments. All changes are validated before applying to ensure data integrity.

Path
groupIdstring(uuid)required

RADIUS attribute group id

Bodyrequired
namestring[ 0 .. 255 ] characters

The name for this attribute group. Maximum length is 255 characters.

descriptionstring[ 0 .. 1000 ] characters

The description for this attribute group. Maximum length is 1000 characters.

attributeAssignmentsArray of objects(Attribute Assignment)[ 0 .. 1000 ] items

The RADIUS attributes that are assigned to this group. Must contain at least one attribute assignment. Maximum of 1000 assignments allowed.

{ "name": "string", "description": "string", "attributeAssignments": [ {} ] }

Responses

RADIUS attribute group

Body
idstring(uuid)

The unique identifier for this attribute group.

namestringrequired

The name for this attribute group.

descriptionstring

The description for this attribute group.

attributeAssignmentsArray of objects(Attribute Assignment)required

The RADIUS attributes that are assigned to this group.

attributeAssignments[].​attributeNamestring[ 0 .. 255 ] charactersrequired

The RADIUS attribute name to use. This should be from the list of supported RADIUS attributes. The complete list of available RADIUS attributes can be retrieved through the /radiusAttributes API endpoint. For standard RADIUS attributes, refer to Request for Comments 2865. Vendor specific attributes are identified by their vendor name.

attributeAssignments[].​operatorstringrequired

The operator to use for attribute assignment. ADD: Adds the attribute value to the response if it does not already exist. ADD_REPLACE: Adds the attribute value to the response, replacing any existing value for the same attribute. DOES_NOT_EXIST: Assigns the attribute value only if the attribute does not already exist in the response.

Enum"ADD""ADD_REPLACE""DOES_NOT_EXIST"
attributeAssignments[].​attributeValuestring[ 0 .. 4096 ] charactersrequired

The assignment value to be returned for this RADIUS attribute. The value must conform to the data type specified for the attribute. Maximum length is 4096 characters.

attributeAssignments[].​dataTypestringrequired

The data type for this attribute value. The value must match one of the specified data types. The data type determines how the attributeValue is validated and formatted. For example, IPADDR expects a valid IPv4 address, IPV6ADDR expects a valid IPv6 address, INTEGER expects a numeric value, and STRING accepts alphanumeric text. Refer to the RADIUS Attribute schema for the specific data type definition of the selected attribute.

Enum"ABINARY""BYTE""COMBO_IP""DATE""ETHER""IFID""INTEGER""IPADDR""IPV6ADDR""IPV6PREFIX"
attributeCountinteger(int32)

The number of RADIUS attribute assignments within this attribute group. Allows sorting and filtering.

externalAssignmentsCountinteger(int32)

The total count of external service assignments for this attribute group across all services. Allows sorting and filtering.

externalServiceAssignmentsArray of objects(External Assignment Service Group)

The list of external service assignments grouped by service name, showing which services have assigned this attribute group and their associated external assignment identifiers.

_linksobject(Links)

Hypermedia links for HATEOAS navigation, including self reference and related resources.

Response
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "description": "string", "attributeAssignments": [ {} ], "attributeCount": 0, "externalAssignmentsCount": 0, "externalServiceAssignments": [ {} ], "_links": { "property1": {}, "property2": {} } }

RADIUS Attribute Group Assignments

Manages the external service assignments to a specified Attribute Group. Enables linking RADIUS attribute groups to external services and systems for distributed authentication and authorization across multiple platforms.

Operations

RADIUS Attribute

Browse and query the comprehensive catalog of supported RADIUS attributes. Provides read only access to standardized RADIUS parameters including vendor specific attributes, data types, and metadata for network authentication and authorization.

Operations