Develop > Command-Line Interfaces > opr-ci-list Command-Line Interface

opr-ci-list Command-Line Interface

The opr-ci-list command line utility enables you to retrieve the type, ID, and label for a set of CIs.

Location

<OMi_HOME>/opr/bin/opr-ci-list.[bat|sh]

Synopsis

opr-ci-list -help|-version|-examples|<CONNECTION_INFO><selector>

Options

Exit Status

Exit Status

Description

Output

0

Successful completion of the requested operation

No output.
1

Failure of the requested operation

An error message stating why the operation failed, followed by the tool's help text.
300‑399

HTTP Redirection (300-399)

An error message stating the HTTP error number and description.

For more information about HTTP error status values, see publicly available HTTP documentation.

400‑499

HTTP Client Error (400-499)

500‑599

HTTP Internal Server Error (500-599)

Restrictions

Non-admin users also need the following file permissions to operate this command-line tool:

File Windows Permissions Linux Permissions
<OMi_HOME>/conf/TopazInfra.ini read r
<OMi_HOME>/log/opr-clis.log full control rw

<OMi_HOME>/log/opr-pgctl.log

Note: This file is not available on gateway server systems.
full control rw
<OMi_HOME>/conf/encryption.properties read r
<OMi_HOME>/conf/seed.properties read r

Examples

This section shows a number of examples you can use as a starting point for developing your own opr-ci-list commands.

  • List information for the CIs with the specified IDs:

    opr-ci-list -username user -password passwd -ci_list ee05b4ecaa1f508b5047d2894d43a76d,5994f81063372abddd3c0114cc91a2b2
  • List information for nodes with the specified primary DNS name:

    opr-ci-list -username user -password passwd -node_list test1.test.com, test2.test.com
  • List information for all CIs of the specified type (and subtypes):

    opr-ci-list -username -password passwd -ci_type oracle
  • List information for all nodes that are members of the specified node group:

    opr-ci-list -username user -password passwd -node_group testGroup -v
  • List information for all CIs contained in the specified view:

    opr-ci-list -username user -password passwd -view_name myView -v
  • List information for all node CIs contained in the specified query:

    opr-ci-list -username user -password passwd -query_name myQuery -nodes_only -v
  • List information for all node CIs that match the specified filter:

    opr-ci-list -username user -password passwd -filter_name myFilter -v