Actors Commands¶
actors¶
View and manage Incydr actors.
Actors are identities that generate events collected by Incydr. User cloud accounts are consolidated into a single actor through adoption, which tie related actors to one parent actor.
The actor commands can be used to retrieve information about actors and their relationships.
Usage:
actors [OPTIONS] COMMAND [ARGS]...
Options:
--log-stderr Enable logging to stderr.
--log-file TEXT Specify file path to write log output to.
--log-level TEXT Set level for Incydr client logging.
--help Show this message and exit.
actors list¶
List actors.
Usage:
actors list [OPTIONS]
Options:
--active / --inactive Filter by active or inactive actors. Defaults to
returning both when when neither option is passed.
--name-starts-with TEXT Find actors whose name (e.g. username/email)
starts with this text, ignoring case.
--name-ends-with TEXT Find actors whose name (e.g. username/email) ends
with this text, ignoring case.
--prefer-parent Returns an actor's parent when applicable. Returns
an actor themselves if they have no parent.
-f, --format TABLEFORMAT Format to print result. One of 'table', 'json-
pretty', 'json-lines', or 'csv. If environment has
INCYDR_USE_RICH=false set, defaults to 'json-
lines', else defaults to 'table'.
--columns TEXT Comma-delimited string of column names. Nested
values should be specified in dot-notation. Limits
output to contain only the specified columns in
CSV or Table format. Ignored for JSON output
formats.
--log-stderr Enable logging to stderr.
--log-file TEXT Specify file path to write log output to.
--log-level TEXT Set level for Incydr client logging.
--help Show this message and exit.
actors show¶
Show actor details.
Specify actor by ID or name, either --actor-id or --name is required.
Usage:
actors show [OPTIONS]
Options:
--actor-id TEXT Get an actor by actor ID.
--name TEXT Get an actor by actor name, typically a
username/email address.
--prefer-parent Returns an actor's parent when applicable.
Returns an actor themselves if they have no
parent.
-f, --format SINGLEFORMAT Format to print result. One of 'rich', 'json-
pretty', or 'json-lines'. If environment has
INCYDR_USE_RICH=false set, defaults to 'json-
lines', else defaults to 'rich'.
--log-stderr Enable logging to stderr.
--log-file TEXT Specify file path to write log output to.
--log-level TEXT Set level for Incydr client logging.
--help Show this message and exit.
actors show-family¶
Show an actors family.
Specify actor by ID or name, either --actor-id or --name is required.
An actor family consists of the the parent actor and any associated children.
Usage:
actors show-family [OPTIONS]
Options:
--actor-id TEXT Get an actor family by the actor ID of one of its
members.
--name TEXT Get an actor family by the actor name of one of
its members, where name is typically a
username/email address.
-f, --format SINGLEFORMAT Format to print result. One of 'rich', 'json-
pretty', or 'json-lines'. If environment has
INCYDR_USE_RICH=false set, defaults to 'json-
lines', else defaults to 'rich'.
--log-stderr Enable logging to stderr.
--log-file TEXT Specify file path to write log output to.
--log-level TEXT Set level for Incydr client logging.
--help Show this message and exit.
actors update¶
Update an actor.
Accepts actor ID.
Usage:
actors update [OPTIONS] ACTOR_ID
Options:
--start-date TEXT Update a user's starting date. Accepts a date in yyyy-
MM-dd (UTC) format.
--end-date TEXT Update a user's departure date. Accepts a date in yyyy-
MM-dd (UTC) format.
--notes TEXT Update the optional notes on a user's profile.
--clear-start-date Clear the start date on a user's profile. Incompatible
with --start-date.
--clear-end-date Clear the end date on a user's profile. Incompatible
with --end-date.
--clear-notes Clear the notes on a user's profile. Incompatible with
--notes.
--log-stderr Enable logging to stderr.
--log-file TEXT Specify file path to write log output to.
--log-level TEXT Set level for Incydr client logging.
--help Show this message and exit.