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