Synopsis

fcli ssc appversion create [--auto-required-attrs] [--[no-]refresh] [--skip-if-exists] [--active=<active>] [-d=<description>] [--delim=<delimiter>] [--issue-template=<issueTemplateNameOrId>] [--refresh-timeout=<timeoutPeriod>] [--add-tags=<tagSpecs>[,<tagSpecs>…​]]…​ [--add-users=<authEntitySpecs>[, <authEntitySpecs>…​]]…​ [--attrs=ATTR=VALUE[, ATTR=VALUE…​]]…​ [--rm-tags=<tagSpecs>[, <tagSpecs>…​]]…​ [[-h] [--env-prefix=<prefix>] [--log-file=<logFile>] [--log-level=<logLevel>] [--log-mask=<level>] [--debug]] [[--ssc-session=<sessionName>]] [[-o=<type+args>] [--style*=<style>,…​]…​ ] [--to-file=<outputFile>_]] [--from=<appVersionNameOrId> [--copy=<copyOptions>[, <copyOptions>…​]]…​] <app>:<version>

Description

This command allows for creating a new SSC application version, optionally skipping creation if the application version already exists (see --skip-if-exists option), and/or copying configuration and state of an existing application version (see --copy and --copy-from options).

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 option or when copying an existing application version may not be applied if the fcli session was created using a CIToken.

Options

--active=<active>

Specify whether application version should be activated (true, default) or not (false).

--add-tags=<tagSpecs>[,<tagSpecs>…​]

Comma-separated list of custom tag names or GUIDs to add.

--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)

--auto-required-attrs

Automatically set a default value for required application version attributes.

--copy=<copyOptions>[,<copyOptions>…​]

Comma separated list of elements to copy (Requires --copy-from). By default, all are copied. Allowed values: custom-tags, bugtracker, processing-rules, attributes, users, state.

-d, --description=<description>

Application version description.

--delim=<delimiter>

Change the default delimiter character when using options that accept "application:version" as an argument or parameter.

--from, --copy-from=<appVersionNameOrId>

Copy FROM application version:

id or <application>:<version> name.

--issue-template=<issueTemplateNameOrId>

Issue template name or id.

--[no-]refresh

By default, this command will refresh the source application version’s metrics when copying from it. Note that for large applications this can lead to an error if the timeout expires.

--refresh-timeout=<timeoutPeriod>

Time-out, for example 30s (30 seconds), 5m (5 minutes), 1h (1 hour). Default value: 60s

--rm-tags=<tagSpecs>[,<tagSpecs>…​]

Comma-separated list of custom tag names or GUIDs to remove.

--skip-if-exists

Skip application version creation if an application version with the specified name already exists.

SSC session name options

--ssc-session=<sessionName>

Name of the SSC session to use for executing this command. Default value: default.

Output options (also see documentation link below)

-o, --output=<type+args>

Select output type (csv, table, expr, json, xml, yaml) and optional type arguments.

--store=<var>[:<prop>]

Store JSON results in an fcli variable for later reference.

*--style*=<style>,…​

Select output style: header, no-header, pretty, no-pretty, flat, no-flat, array, single, border, no-border, md-border.

--to-file=<outputFile>

Write output to the specified file.

Generic fcli options (also see documentation link below)

--debug

Enable collection of debug logs.

--env-prefix=<prefix>

Prefix for resolving default option values. Default value: FCLI_DEFAULT.

-h, --help

Use 'fcli [command] -h' to display help for fcli (sub-)commands.

--log-file=<logFile>

Write log output to file. Default: ./fcli.log if logging is enabled.

--log-level=<logLevel>

Set logging level: TRACE, DEBUG, INFO, WARN, ERROR, NONE.

--log-mask=<level>

Log mask level: high, medium, low, none. Default: medium. Masking is done on a best-effort basis; no guarantee that all sensitive data will be masked.

Arguments

<app>:<version>

Application and version name.