Object Repository queries that you can run from the CLI

The following table provides a list of the query commands that you can run against the Object Repository. 

Query

Description

--query-added-after "yyyy-MM-dd HH:mm:ss"

Get the objects that have been added after the specified time. Query can be qualified with --query-state, --query-type-name or --query-type-path.

--query-attr-name attr_name

Qualifies --query-path-prefix query to those objects with the stable attribute values. Up to four can be specified and paired with --query-attr-value (ie. the first name is paired with the first value and so on).

See --defs-query-attributes.

--query-attr-value attr_value

Qualifies --query-path-prefix query to those objects with a stable attribute value. Requires --query-attr-name.

--query-changed-after "yyyy-MM-dd HH:mm:ss"

Get the objects whose attributes have changed after the specified time. Query can be qualified with --query-state, --query-type-name or --query-type-path.

--query-last-confirmed-after "yyyy-MM-dd HH:mm:ss"

Get the objects (re)confirmed after the specified time. Query can be qualified with --query-state, --query-type-name or --query-type-path.

--query-limit number|all 

Qualifies a --query-objects, --query-state-altered-after, --query-added-after, --query-changed-after, --query-last-confirmed-after, --query-monitored or --query-path-prefix query to limit the number of objects returned. The default is 1000.

 The value "all" indicates there is no limit. This is not recommended.

--query-monitored

Get the objects that are registered for monitoring. Query can be qualified with --query-state, --query-type-name or --query-type-path.

--query-objects

Query objects. Query can be qualified with --query-state, --query-type-name or --query-type-path.

--query-path-prefix instance_path_prefix

Get the objects matching the instance path prefix. The query must be qualified with --query-type-name and --query-type-path. Query can be qualified with --query-state, --query-attr-name or --query-attr-value.

It can specify an empty string ("") to match everything.

--query-pattern regular_expression

Qualifies queries with --query-type-name to those objects that match a specified regular expression.

--query-state state

Qualifies --query-objects, --query-state-altered-after, --query-added-after, --query-changed-after, --query-last-confirmed-after, --query-monitored, or --query-path-prefix to those objects with the specified state. This option can be specified more than once.

The valid states are: added|confirmed|not-found|deprecated|deleted.

--query-state-altered-after "yyyy-MM-dd HH:mm:ss"

Get the objects whose state has been altered after the specified time. Query can be qualified with --query-state, --query-type-name or --query-type-path.

--query-type-name type_name

Qualifies a --query-objects, --query-state-altered-after, --query-added-after, --query-changed-after, --query-last-confirmed-after, --query-monitored or --query-path-prefix query to those objects matching the type name.

See --defs-query-types.

--query-type-path type_path

Qualifies a --query-objects, --query-state-altered-after, --query-added-after, --query-changed-after, --query-last-confirmed-after, --query-monitored or --query-path-prefix query to those objects matching the type path.

This option requires an exclamation mark ! delimited type path follow it. See --defs-query-types.

Was this page helpful? Yes No Submitting... Thank you

Comments