Synopsis
fcli ssc appversion update [--active=<active>] [-d=<description>] [--delim=<delimiter>] [--issue-template=<issueTemplateNameOrId>] [-n=<name>] [--add-users=<authEntitySpecs>[, <authEntitySpecs>…]]… [--attrs=ATTR=VALUE[, ATTR=VALUE…]]… [--rm-users=<authEntitySpecs>[, <authEntitySpecs>…]]… [[-h] [--env-prefix=<envPrefix>] [--log-file=<logFile>] [--log-level=<logLevel>]] [[--session=<sessionName>]] ] [--store=_variableName[:<propertyNames>]] [--to-file=<outputFile>]] <appVersionNameOrId>
Description
This command allows for updating an existing SSC application version.
Note that depending on user and token permissions, SSC may reject some of the application version configuration settings. In particular, user access permissions as specified through the --add-users or --rm-users option may not be applied if the fcli session was created using a CIToken.
Options
- --active=<active>
-
Specify whether application version should be activated (true) or not (false).
- --add-users=<authEntitySpecs>[,<authEntitySpecs>…]
-
Assign one or more (comma-separated) users or LDAP groups to the application version; accepts user id, entity name or email address. Option is repeatable.
- --attrs, --attributes=ATTR=VALUE[,ATTR=VALUE…]
-
Example: ATTR1=[VAL1;VAL2],CATEGORY:ATTR2=VAL3
Set values for one or more attributes. This option accepts a comma-separated list of KEY=VALUE assignments.
Each KEY accepts either the Attribute’s GUID or its Name with the optional Category (InfoClassification or "BUSINESS:Data Classification" or "Data Classification")
Each VALUE accepts a semicolon-separated list of Attribute’s Values, encapsulated in brackets (optional for single value)
- -d, --description=<description>
-
Update application version description.
- --delim=<delimiter>
-
Change the default delimiter character when using options that accept "application:version" as an argument or parameter.
- --issue-template=<issueTemplateNameOrId>
-
Issue template name or id.
- -n, --name=<name>
-
Update application version name.
- --rm-users=<authEntitySpecs>[,<authEntitySpecs>…]
-
Remove one or more (comma-separated) users or LDAP groups from the application version; accepts user id, entity name or email address. Option is repeatable.
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.