sagcc get configuration instances
Retrieves information about a specific configuration instance that belongs to a specified run-time component. For example, you might want to retrieve information about an instance of a configuration properties file. Information about a configuration instance can include:
Instance ID
Type ID for the configuration type associated with the instance
Display name for the instance
Description of the instance
URL providing the location of the configuration instance
The ID of the run-time component to which the instance belongs
Syntax
Command Central syntax:
sagcc get configuration instances node_alias componentid instanceid
[options]
Platform Manager syntax:
sagcc get configuration instances componentid instanceid [options]
options:
[{--accept | -a} content_type]
[{--debug | -d}]
[{--error | -r} file]
[{--format | -f} {tsv args | text | xml | csv args | json}]
[{--log | -l} file]
[{--output | -o} file]
[{--quiet | -q}]
[{--password | -p} password]
[{--server | -s} url]
[{--username | -u} user_name]
Arguments and Options
Argument or Option | Description |
node_alias | Command Central only. Required. Specifies the alias name of the installation in which the run-time component is installed. |
componentid | Required. Specifies the ID of the run-time component for which you want to retrieve instance information. |
instanceid | Required. Specifies the ID of the instance for which you want to retrieve information. |
[options] | Optional. Refer to the command syntax for a list of the options the command supports. For a description of the options, see Common Options. |
Usage Notes
Example When Executing on Command Central
To execute a command on the Command Central server with host name “rubicon” and port “8090” to retrieve information about the configuration instance with ID “COMMON-PORTS-com.softwareag.sshd.pid.properties” that belongs to the run-time component that has the ID “OSGI-SPM” and runs in the installation with alias name “sag01”, using the authorization of the user with user name “Administrator” and password “manage”, and have the information displayed on the console in XML format:
sagcc get configuration instances sag01 OSGI-SPM COMMON-PORTS-
com.softwareag.sshd.pid.properties --format xml
--server http://rubicon:8090/cce --username Administrator
--password manage
Example When Executing on Platform Manager
To retrieve information about the configuration instance with ID “COMMON-PORTS-com.softwareag.sshd.pid.properties” that belongs to the run-time component that has the ID “OSGI-SPM” and is managed by the Platform Manager with host name “rubicon2” and port “8092”, and have the information displayed on the console in XML format:
sagcc get configuration instances OSGI-SPM COMMON-PORTS-
com.softwareag.sshd.pid.properties --format xml --server
http://rubicon2:8092/spm
Because the
{--username | -u} and
{--password | -p} options are not specified, the command uses the default user name and password. For more information, see
username and
password.
