List access groups

Lists access groups without associated rules.

Caution: Access groups were deprecated in Tenable Vulnerability Management on February 4th, 2022. Tenable recommends that customers use access control instead to manage user and group access to resources in Tenable Vulnerability Management. Please update any existing integrations that your organization has. For more information about access control, see Access Control in the Tenable Vulnerability Management User Guide.

Requires the Basic [16] user role to list access groups to which you are assigned. Requires the Administrator [64] user role to list all access groups for your organization. See Roles.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

A filter condition in the following format: field:operator:value. For a list of possible fields and operators, use the GET /access-groups/filters endpoint. You can specify multiple f parameters, separated by ampersand (&) characters. If you specify multiple f parameters, use the ft parameter to specify how Tenable Vulnerability Management applies the multiple filter conditions.

string

If multiple f parameters are present, specifies whether Tenable Vulnerability Management applies AND or OR to conditions. Supported values are and and or. If you omit this parameter when using multiple f parameters, Tenable Vulnerability Management applies AND by default.

string

The search value that Tenable Vulnerability Management applies across the wildcard fields. Wildcard fields are specified in the wf parameter.

string

A comma-separated list of fields where Tenable Vulnerability Management applies the search value specified in the w parameter. For a list of supported wildcard fields, use the GET /access-groups/filters endpoint.

boolean

Specifies whether or not to include the rules and principals objects in the response. Tenable Vulnerability Management defaults to false if this parameter is omitted.

int32

The number of records to retrieve.

int32

The starting record to retrieve. If this parameter is omitted, Tenable Vulnerability Management uses the default value of 0.

string

The field you want to use to sort the results by along with the sort order. The field is specified first, followed by a colon, and the order is specified second (asc or desc). For example, name:desc would sort results by the name field in descending order.

If you specify multiple fields, the fields must be separated by commas. For example, name:desc,created_at:asc would first sort results by the name field in descending order and then by the created_at field in ascending order.

For a list of supported sort fields, use the GET /access-groups/filters endpoint.

Responses

403

Returned if you do not have permission to view access groups.

Language
Credentials