Initial alpha release of iics-cli - a Go CLI for the Informatica Intelligent Cloud Services (IICS) REST API v3/v2. Covers authentication, asset management, export/import, access control, auditing, and more across 26 top-level commands.
Implemented Commands
Authentication and Profiles
| Command |
Description |
login / logout |
Session authentication with 30-minute TTL auto-refresh |
profile |
Interactive setup wizard; multi-profile support via ~/.iics/config.yaml |
Asset Management
| Command |
Description |
objects list |
Search assets with q filter syntax (type, location, tag, updatedBy, updateTime, sourceControl); auto-pagination; optional file export (yaml/json/csv) |
objects dependencies |
Find uses/usedBy references for an asset |
lookup |
Resolve object IDs, names, and paths |
state |
Fetch and load object state snapshots |
package expand / create |
Expand or assemble IICS export package ZIP files |
Export and Import
| Command |
Description |
export |
Export asset packages with async status polling |
import |
Full pipeline: upload package, start job, poll until complete, download log on failure |
Organization
| Command |
Subcommands |
project |
list, get, create, update, delete |
folder |
list, get, create, update, delete |
schedule |
list, get, create, update, delete |
Access Control
| Command |
Subcommands |
user |
list, get, create, update, delete, change-password, reset-password |
usergroup (alias: ug) |
list, get, create, update, delete |
role |
list, get, create, delete |
privilege |
list |
permission (alias: perm) |
list, add, remove object-level permissions |
Connectivity and Runtime
| Command |
Description |
connection (alias: conn) |
list, get connections (V2 API) |
agent |
list Secure Agents (V2 API) |
runtime (alias: rt) |
list, get runtime environments |
tag |
Assign / remove tags on objects |
Auditing and Observability
| Command |
Description |
activitylog |
List completed job activity logs; field selection, state labels, nested entry sections |
securitylog (alias: auditlog) |
Query security audit log; filter by actor, actionCategory, actionEvent, entryTime via q parameter |
metering |
Query usage and metering data |
Source Control
| Command |
Description |
sourcecontrol (alias: sc) |
Source control operations (pull, commit, sync) |
Tooling
| Command |
Description |
completion |
Generate shell completion scripts (bash, zsh, fish, PowerShell) |
Global Flags
| Flag |
Short |
Default |
Description |
--profile |
-p |
defaultProfile |
Connection profile to use |
--output |
-o |
table |
Output format: table, json, csv |
--verbose |
-v |
false |
Verbose output |
--no-color |
|
false |
Disable colored output |
--config |
|
~/.iics/config.yaml |
Config file path |
--debug |
|
false |
Enable debug HTTP logging |
Quick Start
# Build from source
git clone https://github.com/jbrazda/iics-cli.git
cd iics-cli
make build
# Set up a profile
./iics profile setup
# List all mapping tasks
./iics objects list --type MTT
# Export a project
./iics export run --name "my-export" --query "location=='MyProject'"
# View recent activity logs
./iics activitylog list --limit 20
Alpha Caveats
- Tested against IICS US region only; other regions (EU, AP) may have endpoint differences
objects command is read-only (list and search only - no create/update/delete)- Source control subcommands cover the most common operations but may not handle all edge cases
- No automated release binaries - build from source using
make build
- API structs are aligned with documented V3 API field names; undocumented fields may be missing
