飞连 icon

飞连

飞连开放平台 API 集成,支持部门与成员、Wi-Fi、终端管理

部门与成员 → 获取角色列表

AI-generated

Summary

Retrieve a list of roles with optional fuzzy name search for filtering.

Inputs

  • 查询字符串 — A string for fuzzy searching role names to filter the list.
  • Options — Additional options including 'Timeout' to specify the maximum wait time in milliseconds for the server response header before aborting the request; 0 means no timeout.

Output shape

a list of role objects matching the search criteria

The output returns an array of roles filtered by the optional fuzzy search query. The operation supports batch execution configurable via node options. If an error occurs per item and 'Continue on Fail' is enabled, error details are returned in the output.

Examples

Example 1: Fetch all roles without filtering

Leave the '查询字符串' blank and invoke the operation to get all roles.

Example 2: Fetch roles with names containing 'admin'

Set the '查询字符串' to 'admin' to perform a fuzzy search for roles containing that substring.

Links

Discussion