Skip to main content

Cisco ACI Unused Policy Cleaner

ACIClean is a tool that helps you clean up your Cisco ACI infrastructure by detecting and reporting on unused objects. It uses the ACI COBRA Python SDK provided by Cisco.

ACIClean currently detects and reports on the following objects:

  • VLAN Pools

  • AAEPs

  • Physical Domains

  • Leafswitch Profiles

  • Accessports

  • PCs and VPCs

Installation

To install ACIClean, follow these steps:

  1. Install the ACI COBRA Python SDK by following the instructions here.

If you dont’t have the SDK modules handy, run the following commands to install an ACI v5.2.7 SDK module:

  • pip install https://github.com/cubinet-code/aci_cobra_sdk/raw/main/acicobra-5.2.7.0.7-py2.py3-none-any.whl

  • pip install https://github.com/cubinet-code/aci_cobra_sdk/raw/main/acimodel-5.2.7.0.7-py2.py3-none-any.whl

  1. Run pip install aciclean to install this module and command line script.

Usage

To use ACIClean, run the aciclean.py script. The script will detect and report on any unused objects in your Cisco ACI infrastructure.

The following APIC credentials will be read from the environment, if they exist:

  • ACI_APIC_URL

  • ACI_APIC_USER

  • ACI_APIC_PASSWORD

aciclean --help

Usage: aciclean.py [OPTIONS]

Options:
  --url TEXT       APIC URL including protocol.
  --user TEXT      APIC user.  [default: (admin)]
  --password TEXT  APIC password.
  -w, --write      Write report to aciclean_report.txt
  -r, --remove     WARNING: !!! This will remove all policies without
                   relationships from the APIC !!!
  --help           Show this message and exit.

Contributing

Contributions to ACIClean are welcome! If you find a bug or have a feature request, please open an issue on the GitHub repository. If you would like to contribute code, please fork the repository and submit a pull request.

License

ACIClean is licensed under the MIT License.

Metadata

Release files for aciclean 0.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aciclean 0.1.7
File Size Uploaded Provenance
aciclean-0.1.7.tar.gz 5.1 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for aciclean 0.1.7
File Interpreter ABI Platform
aciclean-0.1.7-py3-none-any.whl Python 3 none any Details

Total release size: 10.6 kB

Release files / aciclean-0.1.7.tar.gz

Download URL aciclean-0.1.7.tar.gz
Size 5.1 kB
Tags Source
SHA-256 checksum
How to use checksums
10c88dde3a29367b4752c1e0cc8d392d5cd0ca5d3a23ac0ce920c9ba1d2ac866
BLAKE2b-256 checksum
How to use checksums
e614f41aa322fab92e5abab51fe9701a227812bbbdf08250584276cfecc78cd5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/4.0.2 CPython/3.11.6

Release files / aciclean-0.1.7-py3-none-any.whl

Download URL aciclean-0.1.7-py3-none-any.whl
Size 5.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f1e698e014207769d7c41dc448497191807a989be75a2858fe42605331dce8ad
BLAKE2b-256 checksum
How to use checksums
c7d237f5271d421877f90e78052f121dfc24a3dba9928ea942fd15ee48cb96be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/4.0.2 CPython/3.11.6

Security for aciclean 0.1.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.7 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page