Skip to main content

CloudApplicationInstances Collection

Iterate over CloudApplicationInstance resources in Zscaler Internet Access.

Returned items are CloudApplicationInstance 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.zia.cloud_application_instances.all():
    print(item.id)

# Materialize the full list
all_items = list(session.zia.cloud_application_instances.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.zia.cloud_application_instances().pages():
    print(f"Got a page with {len(page)} items")
    for item in page:
        print(item.id)

Server-side pagination​

This collection paginates server-side via the ListCloudApplicationInstances operation.

Pagination tokenValue
Stylepage
Input tokenpage
Output tokentotalPages
Limit keypageSize
Result key@
# Tune the per-request batch size and cap total yielded items
for item in session.zia.cloud_application_instances.page_size(50).limit(100):
    print(item.id)

See the Pagination guide for the full pagination model.

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

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

Resource Type​

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