client.permission_sets.list_resources

A method of the Permission Sets endpoint.

list_resources(id: int, *, limit: int = None, page_num: int = None, order: str = None, order_dir: str = None, iterator: bool = None) ListResponse | PaginatedResponse

List resources in a permission set

API URL: GET /permission_sets/{id}/resources

import civis
client = civis.APIClient()
response = client.permission_sets.list_resources(...)
Parameters:
idint

The ID for this permission set.

limitint, optional

Number of results to return. Defaults to 50. Maximum allowed is 1000.

page_numint, optional

Page number of the results to return. Defaults to the first page, 1.

orderstr, optional

The field on which to order the result set. Defaults to name. Must be one of: name, id, updated_at, created_at.

order_dirstr, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to asc.

iteratorbool, optional

If True, return a generator (specifically, a civis.PaginatedResponse object) to iterate over all responses. Use it when more results than the maximum allowed by ‘limit’ are needed. When True, ‘page_num’ is ignored. If False, return a civis.ListResponse object (= a list of civis.Response objects), whose size is determined by ‘limit’. Defaults to False.

Returns:
civis.ListResponse | civis.PaginatedResponse
  • permission_set_idint

    The ID for the permission set this resource belongs to.

  • namestr

    The name of this resource.

  • descriptionstr

    A description of this resource.

  • created_at : str (time)

  • updated_at : str (time)