Command Central 10.3 | Command Central Developer Reference | Using the Command Line Interface | Configuration Commands | sagcc list configuration instances
 
sagcc list configuration instances
Lists the configuration instances that belongs to a specified run-time component. 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 list configuration instances  node_alias  componentid [instanceid]               
[options]
*Platform Manager syntax:
sagcc list 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]               
[{--password | -p} password]               
[{--quiet | -q}]               
[{--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 list configuration instances.
You can determine the IDs for run-time components using sagcc list inventory components.
[instanceid]
Optional. Specifies the ID of the instance for which you want to retrieve information. If you do not specify an instance ID, the command lists information for all instances that belong to the run-time component identified by the componentid argument.
[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 list configuration instances that belong 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 returned to the output file “config_instances” in XML format:
sagcc list configuration instances sag01 OSGI-SPM --format xml --output              
config_instances --server http://rubicon:8090/cce            
--username Administrator --password manage
Example When Executing on Platform Manager
To list configuration instances that belong 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”, using the authorization of the user with user name “Administrator” and password “manage”, and have the information returned to the console in JavaScript Object Notation format:
sagcc list configuration instances OSGI-SPM --format json --server              
http://rubicon2:8092/spm --username Administrator --password manage