3.2.10. devices/users saved-query add

This command will add a saved query for users or devices.

3.2.10.1. Common Options

3.2.10.2. Common Examples

  • Selecting Fields Examples for examples of selecting which fields (columns) to include in the saved query for sort column, columns displayed, and column filters.

3.2.10.3. Examples

3.2.10.4. Help Page

3.2.10.4.1. axonshell devices/users saved-query add

Add a saved query.

axonshell devices/users saved-query add [OPTIONS]

Options

--help-detailed <help_detailed>

Show detailed help and exit

Options:

auth | query | selectfields | wizard

-u, --url <URL>

Required URL of an Axonius instance

-k, --key <KEY>

Required API Key (or username if credentials=True) of user in an Axonius instance

-s, --secret <SECRET>

Required API Secret (or password if credentials=True) of user in an Axonius instance

-xf, --export-format <export_format>

Format to export data in

Default:

table

Options:

json | str-names | str | table

-tf, --table-format <table_format>

Base format to use for –export-format=table

Default:

fancy_grid

Options:

asciidoc | double_grid | double_outline | fancy_grid | fancy_outline | github | grid | heavy_grid | heavy_outline | html | jira | latex | latex_booktabs | latex_longtable | latex_raw | mediawiki | mixed_grid | mixed_outline | moinmoin | orgtbl | outline | pipe | plain | presto | pretty | psql | rounded_grid | rounded_outline | rst | simple | simple_grid | simple_outline | textile | tsv | unsafehtml | youtrack

-q, --query <QUERY>

Query built from the Query wizard in the GUI

-qf, --query-file <QUERY_FILE>

Path to a file to override –query

-wz, --wiz <"simple|complex|file|lines" "EXPRESSION">

Build a query using an expression (multiples, will override –query). –wiz “file” “<token>” - Read expressions from a file. –wiz “lines” “simple expr1<CR>simple expr2” - Read multiple expressions from a string. –wiz “simple” “<expr>” - Simple expression. –wiz “complex” “<expr>” - Complex expression.

-t, --tag <tags>

Tags to set for saved query (multiple)

-d, --description <description>

Description to set on saved query

-f, --field <ADAPTER:FIELD>

Fields to include in the format of adapter:field (multiples)

-fr, --field-regex <ADAPTER_REGEX:FIELD_REGEX>

Regular expressions of fields to include (multiples)

-frro, --fields-regex-root-only, -nfrro, --no-fields-regex-root-only

Only include root fields for –field-regex

Default:

True

-ff, --field-fuzzy <ADAPTER:FIELD>

Fuzzy matching of fields to include (multiples)

-fro, --fields-root <ADAPTER>

Select all root fields for a given adapter (PERFORMANCE HIT!)

-fd, --fields-default, -nfd, --no-fields-default

Include the default fields defined in the API library

Default:

True

-sf, --sort-field <ADAPTER:FIELD>

Column to sort data on.

-sd, --sort-descending, -nsd, --no-sort-descending

Sort –sort-field descending.

Default:

True

-gps, --gui-page-size <gui_page_size>

Number of rows to show per page in GUI.

Default:

20

Options:

20 | 50 | 100

-pr, --private, -npr, --no-private

Set as private.

Default:

False

-ac, --always-cached, -nac, --no-always-cached

Set as always cached.

Default:

False

-as, --asset-scope, -nas, --no-asset-scope

Set as an asset scope query.

Default:

False

-n, --name <name>

Required Name of saved query

-e, --echo, -ne, --no-echo

Echo folder workflow messages to console.

Default:

True

-c, --create, -nc, --no-create

If –folder does not exist, create it

Default:

True

-f, --folder <folder>

Path of folder