Command Central 10.1 | Command Central Developer Reference | Using the Command Line Interface | Configuration Commands | sagcc get configuration instances
 
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.
You can view a list of installations and their aliases using sagcc list landscape nodes.
componentid
Required. Specifies the ID of the run-time component for which you want to retrieve instance information.
You can determine the IDs for run-time components using sagcc list inventory components.
instanceid
Required. Specifies the ID of the instance for which you want to retrieve information.
You can determine the IDs for configuration instances using sagcc list configuration instances.
[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
*To retrieve the data for a specific instance, use sagcc get configuration data.
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.