resource-query

resource-query
resource-query

Object used to lookup resources with various filtering criteria

JSON Example
{
    "adapterInstanceId": [
        "string"
    ],
    "adapterKind": [
        "string"
    ],
    "collectorId": [
        0
    ],
    "collectorName": [
        "string"
    ],
    "credentialId": [
        "string"
    ],
    "includeRelated": "string",
    "maintenanceScheduleId": [
        "string"
    ],
    "name": [
        "string"
    ],
    "parentId": [
        "string"
    ],
    "propertyConditions": {
        "conditions": [
            {
                "doubleValue": "number",
                "key": "string",
                "operator": "string",
                "stringValue": "string"
            }
        ],
        "conjunctionOperator": "string"
    },
    "propertyName": "string",
    "propertyValue": "string",
    "recentlyAdded": 0,
    "regex": [
        "string"
    ],
    "resourceHealth": [
        "string"
    ],
    "resourceId": [
        "string"
    ],
    "resourceKind": [
        "string"
    ],
    "resourceState": [
        "string"
    ],
    "resourceStatus": [
        "string"
    ],
    "resourceTag": [
        {
            "category": "string",
            "name": "string"
        }
    ],
    "statConditions": {
        "conditions": [
            {
                "doubleValue": "number",
                "key": "string",
                "operator": "string",
                "stringValue": "string"
            }
        ],
        "conjunctionOperator": "string"
    },
    "statKey": "string",
    "statKeyInclusive": false,
    "statKeyLowerBound": "number",
    "statKeyUpperBound": "number"
}
array of string
adapterInstanceId
Optional

Array of uuids that identify adapter instances

array of string
adapterKind
Optional

Array of Adapter Kind keys

array of integer
collectorId
Optional

Array of Collector Identifiers

array of string
collectorName
Optional

Array of Collector names

array of string
credentialId
Optional

Array of CredentialIDs

string
includeRelated
Optional

None null value specifies to include related resource ids of given relationship type in resource result. Uses the RelationshipType.representation value.

Possible values are : PARENT, CHILD,
array of string
maintenanceScheduleId
Optional

Array of {@link UUID} that identify Maintenance Schedules. Since vROps 6.1.0 release onwards, we don't support search and look up of Resources using Maintenance Schedules' identifiers.

array of string
name
Optional

Array of resource names to query for. NOTE: Currently, only single element supported

array of string
parentId
Optional

Array of UUID of object that are the parent resource in a parent child relationship

propertyConditions
Optional

Object used to define filtering criteria based on multiple stats/properties with possibility to specify the conjunction operator

string
propertyName
Optional

Name of property. Query only supports filtering for a single property.

string
propertyValue
Optional

Value of property. Omitting the property value will check for existence of the property name on the resource. NOTE: Use 'propertyConditions' to specify lookup of Resource using multiple properties.

integer As int64 As int64
recentlyAdded
Optional

Return resources created after the specified value. Value is the number of seconds since Midnight January 1, 1970 GMT.

array of string
regex
Optional

Array of resource names in java regex format. NOTE: regex and name are mutually exclusive. If both are specified, name is given preference.

array of string
resourceHealth
Optional

Array of resource health

Possible values are : GREEN, YELLOW, ORANGE, RED, GREY,
array of string
resourceId
Optional

Array of Resource Identifiers

array of string
resourceKind
Optional

Array of Resource Kind keys

array of string
resourceState
Optional

Array of resource states

Possible values are : STOPPED, STARTING, STARTED, STOPPING, UPDATING, FAILED, MAINTAINED, MAINTAINED_MANUAL, REMOVING, NOT_EXISTING, NONE, UNKNOWN,
array of string
resourceStatus
Optional

Array of resource data collection stats

Possible values are : NONE, ERROR, UNKNOWN, DOWN, DATA_RECEIVING, OLD_DATA_RECEIVING, NO_DATA_RECEIVING, NO_PARENT_MONITORING, COLLECTOR_DOWN,
resourceTag
Optional

Property used for tag filtering. NOTE: If specified, only the resources with the tags will be returned.

statConditions
Optional

Object used to define filtering criteria based on multiple stats/properties with possibility to specify the conjunction operator

string
statKey
Optional

Name of resource StatKey to validate value is within a range. Use with statKeyLowerBound, statKeyUpperBound and statKeyInclusive to create comparison conditions NOTE: Use 'statConditions' to specify lookup of Resource using multiple stat keys.

boolean
statKeyInclusive
Optional

Filtering by statKey values is inclusive or exclusive of boundary values. Defaults to true

number As double As double
statKeyLowerBound
Optional

StatKey value matching range lower bound

number As double As double
statKeyUpperBound
Optional

StatKey value matching range upper bound