Skip to main content

PredefinedApiControls Collection

Iterate over InspectionPredefinedControlResource resources in Zscaler Private Access V1.

Returned items are InspectionPredefinedControlResource resources — access their fields via dot notation.

Iterate all items​

import zssdk
session = zssdk.Session(profile_name="beta")

# Yield each item; pagination (if any) is handled automatically
for item in session.zpa.predefined_api_controls.all():
    print(item.id)

# Materialize the full list
all_items = list(session.zpa.predefined_api_controls.all())
print(f"Total items: {len(all_items)}")

Iterate by page​

# Paginated collections yield each server page; simple collections yield one page
for page in session.zpa.predefined_api_controls().pages():
    print(f"Got a page with {len(page)} items")
    for item in page:
        print(item.id)

Simple collection​

This endpoint returns all items in a single response — no server-side pagination. .all() and .pages() still work; .pages() yields exactly one page. .page_size(n) is ignored; .limit(n) just slices the single response.

See the Pagination guide for the full pagination model.

# Server-side filtering (query params sent to the API)
for item in session.zpa.predefined_api_controls.filter(version="value"):
    print(item.id)

# Client-side JMESPath on each page
for item in session.zpa.predefined_api_controls.search("[?contains(control_group, 'prod')]"):
    print(item.id)

Resource Type​

Each item is a InspectionPredefinedControlResource instance with standard CRUDL and any custom actions defined on that resource.