plerion integrations

With plerion integrations, you can list all cloud integrations (AWS, Azure, GCP, Kubernetes) configured in your tenant and set the tags you assign to them in Plerion.

Synopsis

plerion integrations <subcommand> [options]

Subcommands

list

List cloud integrations (AWS, Azure, GCP, Kubernetes).

plerion integrations list [options]

Options

Flag	Type	Description
`--per-page`	number	Results per page (default: 50)
`--include-total`	flag	Include total count in response metadata
`--all`	flag	Fetch all pages automatically

set-tags

Replace all user-defined tags on an integration.

plerion integrations set-tags <id> (--tag KEY=VALUE ... | --clear)

Flag	Type	Description
`--tag`	string	A tag as `KEY=VALUE`. Repeat for each tag, up to 50. The first `=` separates the key from the value, and both must be non-empty. Each key can appear only once
`--clear`	flag	Remove every user-defined tag. Can’t be combined with `--tag`

The tags you pass become the complete set. Any user-defined tag you leave out is removed.

Tags read from the cloud account aren’t changed, but a user-defined tag overrides a cloud tag with the same key. The command returns the integration’s tags after the change.

Examples

# List all integrations
plerion integrations list

# Include total count
plerion integrations list --include-total --output json

# Extract integration IDs
plerion integrations list --output json --query 'data[*].integrationId'

# Fetch all integrations across all pages
plerion integrations list --all --output json

# Set two tags on an integration, replacing any existing user-defined tags
plerion integrations set-tags 458511a1-9bc2-4fce-97a0-0e3139588e6e --tag team=platform --tag env=prod

# Remove every user-defined tag
plerion integrations set-tags 458511a1-9bc2-4fce-97a0-0e3139588e6e --clear

Output columns

Table output includes all fields returned by the API:

Column	Description
ID	Integration ID
NAME	Integration name
PROVIDER	Cloud provider (`AWS`, `Azure`, `GCP`, `Kubernetes`)
TYPE	Integration type
STATUS	Integration status (e.g. `ACTIVE`)
RISK SCORE	Numeric risk score
SCHEDULE	Scan schedule
SCAN INTERVAL	Scan interval setting
DETECTION SETTING ID	Detection setting ID
TENANT ID	Tenant ID
ORG ID	Organization ID
AWS ACCOUNT	AWS account ID
AZURE SUBSCRIPTION	Azure subscription ID
AZURE DIRECTORY	Azure directory/tenant ID
GCP PROJECT	GCP project ID
CREATED AT	Creation timestamp
UPDATED AT	Update timestamp

Tags output columns (set-tags)

Column	Description
KEY	Tag key
VALUE	Tag value
SOURCE	`user-defined` for tags set in Plerion, `cloud-provider` for tags read from the cloud account

Getting started

Commands

Synopsis

Subcommands

list

Options

set-tags

Examples

Output columns

Tags output columns (set-tags)

​Synopsis

​Subcommands

​list

​Options

​set-tags

​Examples

​Output columns

​Tags output columns (set-tags)

Synopsis

Subcommands

list

Options

set-tags

Examples

Output columns

Tags output columns (set-tags)