Synopsis
fcli ssc appversion list [--q-param=<qParam>] [--embed=<embedSuppliers>[, <embedSuppliers>…]]… [[-h] [--env-prefix=<envPrefix>] [--log-file=<logFile>] [--log-level=<logLevel>]] [[--session=<sessionName>]] ] [--store=_variableName[: _ <propertyNames>]] [--to-file=<outputFile>_]] [-q=<SpEL _ _ expression>]
Description
By default, this command simply lists all application versions. However, the --embed, --query and --output options allow for implementing advanced use cases. Some examples:
List application versions created by user 'admin': -q 'createdBy=="admin"'
List application versions requiring refresh: -q 'refreshRequired'
List application versions with artifacts requiring approval: -q 'currentState.attentionRequired'
List application versions with business risk 'High':
--embed attrValuesByGuid -q 'attrValuesByGuid["BusinessRisk"].contains("High")'
Generate script for purging all application versions:
-o 'expr=fcli ssc appversion purge-artifacts --older-than 30d {id}\n'
Options
- --embed=<embedSuppliers>[,<embedSuppliers>…]
-
Embed extra application version data. Allowed values: attrs, attrValuesByName, attrValuesByGuid, bugtracker, customTags, filterSets, folders, resultProcessingRules.
- -q, --query=<SpEL expression>
-
Only display records for which the given Spring Expression Language (SpEL) expression returns true.
- --q-param=<qParam>
-
Server-side queries are automatically generated from the -q / --query option if possible; generated queries can be viewed in the debug log. The --q-param option can be used to override the automatically generated query, for example to further optimize the request. See SSC REST API documentation for information on supported formats.
Session options
- --session=<sessionName>
-
Name of the SSC session to use for executing this command. Default value: default.
Output options
- -o, --output=format[=<options>]
-
Specify output format and options. Available output formats: csv, csv-plain, json, json-flat, table, table-plain, tree, tree-flat, xml, xml-flat, yaml, yaml-flat, expr, json-properties. The 'expr' output format takes a string containing '{property}' placeholders, other output formats take an optional, comma-separated list of properties to include in the output. Use '-o json-properties' on the current command to see available properties.
- --store=variableName[:<propertyNames>]
-
Store the JSON results of this command in a variable. Variables can be managed through the 'fcli util variable' command, and can be referenced using ::variable::[property] on any subsequent command.
- --to-file=<outputFile>
-
Write command output to the specified file instead of stdout.
Generic fcli options
- --env-prefix=<envPrefix>
-
Environment variable prefix for resolving default option and parameter values. Default value is FCLI_DEFAULT.
- -h, --help
-
Show this help message and exit. Use 'fcli <command> -h' to display help for subcommands.
- --log-file=<logFile>
-
File where logging data will be written. Defaults to fcli.log in current directory if --log-level is specified.
- --log-level=<logLevel>
-
Set logging level. Note that DEBUG and TRACE levels may result in sensitive data being written to the log file. Allowed values: TRACE, DEBUG, INFO, WARN, ERROR.