Illumio Core Python API Client

Latest Release Badge PyPI Version Badge Python Version Support Badge

The illumio python library exposes Policy Compute Engine API endpoints through an easy-to-use interface. It is a community-maintained fork of illumio/illumio-py (the import package is still illumio), compatible with Illumio Core PCE versions 21.2 and up.

Install it and take advantage of the PCE’s APIs in just a few lines of code:

$ python -m pip install illumio-py-open
>>> from illumio import PolicyComputeEngine
>>> pce = PolicyComputeEngine('my.pce.com', port='443', org_id='1')
>>> pce.set_credentials('api_key', 'api_secret')
>>> workloads = pce.workloads.get(
...     params={'managed': True, 'enforcement_mode': 'visibility_only'}
... )

How the docs are organized

The documentation is split by what you’re trying to do:

  • Getting started — install the client and follow a hands-on path from your first connection to your first policy. Start here if you’re new.

  • Guides — task-focused recipes for building segmentation policy, working with deny rules, provisioning, and more.

  • Concepts — how the client is designed: the object model, the @pce_api registry, policy versioning, and org scoping.

  • Reference — the complete, generated API for every class and method.

Examples