Get Resources Using GET

Get Resources Using GET

Get a listing of resources based on the query spec specified

Request
URI
GET
https://{api_host}/api/resources
COPY
Query Parameters
string of array
adapterInstanceId
Optional

Array of uuids that identify adapter instances

string of array
adapterKind
Optional

Array of Adapter Kind keys

integer of array
collectorId
Optional

Array of Collector Identifiers

string of array
collectorName
Optional

Array of Collector names

string of array
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, CONTAINS, CONTAINED_BY, REFERENCES, REFERENCED_BY, USES, USED_BY, SELF, DESCENDANT, ANCESTOR, TST, ALL,
string of array
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.

string of array
name
Optional

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

object of array
others
Optional

others

integer
page
Optional

Page number from which data needs to be displayed (0-based)

integer
pageSize
Optional

Expected number of entries per page

string of array
parentId
Optional

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

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
recentlyAdded
Optional

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

string of array
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.

string of array
resourceHealth
Optional

Array of resource health

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

Array of Resource Identifiers

string of array
resourceKind
Optional

Array of Resource Kind keys

string of array
resourceState
Optional

Array of resource states

Possible values are : STOPPED, STARTING, STARTED, STOPPING, UPDATING, FAILED, MAINTAINED, MAINTAINED_MANUAL, REMOVING, NOT_EXISTING, NONE, UNKNOWN,
string of array
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,
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
statKeyLowerBound
Optional

StatKey value matching range lower bound

number
statKeyUpperBound
Optional

StatKey value matching range upper bound


Authentication
This operation uses the following authentication methods.
Responses
200

The Collection of Resources matching the specified query parameters

Returns resources of type(s) application/json
{
    "links": [
        {
            "description": "string",
            "href": "string",
            "name": "string",
            "rel": "string"
        }
    ],
    "pageInfo": {
        "page": 0,
        "pageSize": 0,
        "sortBy": "string",
        "sortOrder": "string",
        "totalCount": 0
    },
    "resourceList": [
        {
            "badges": [
                {
                    "color": "string",
                    "score": "number",
                    "type": "string"
                }
            ],
            "creationTime": 0,
            "credentialInstanceId": "string",
            "description": "string",
            "dtEnabled": false,
            "extension": {
                "anyObjects": [
                    {}
                ]
            },
            "geoLocation": {
                "latitude": "number",
                "longitude": "number"
            },
            "identifier": "string",
            "links": [
                {
                    "description": "string",
                    "href": "string",
                    "name": "string",
                    "rel": "string"
                }
            ],
            "monitoringInterval": 0,
            "monitoringIntervalMinutes": 0,
            "monitoringIntervalSeconds": 0,
            "relatedResources": [
                "string"
            ],
            "resourceHealth": "string",
            "resourceHealthValue": "number",
            "resourceKey": {
                "adapterKindKey": "string",
                "extension": {
                    "anyObjects": [
                        {}
                    ]
                },
                "links": [
                    {
                        "description": "string",
                        "href": "string",
                        "name": "string",
                        "rel": "string"
                    }
                ],
                "name": "string",
                "resourceIdentifiers": [
                    {
                        "identifierType": {
                            "dataType": "string",
                            "extension": {
                                "anyObjects": [
                                    {}
                                ]
                            },
                            "isPartOfUniqueness": false,
                            "links": [
                                {
                                    "description": "string",
                                    "href": "string",
                                    "name": "string",
                                    "rel": "string"
                                }
                            ],
                            "name": "string"
                        },
                        "key": "string",
                        "links": [
                            {
                                "description": "string",
                                "href": "string",
                                "name": "string",
                                "rel": "string"
                            }
                        ],
                        "name": "string",
                        "uniquelyIdentifying": false,
                        "value": "string"
                    }
                ],
                "resourceKindKey": "string"
            },
            "resourceStatusStates": [
                {
                    "adapterInstanceId": "string",
                    "resourceState": "string",
                    "resourceStatus": "string",
                    "statusMessage": "string"
                }
            ]
        }
    ]
}
array of link
links
Optional

Collection of links

pageInfo
Optional

Represents page information for a paged result

array of resource
resourceList
Optional

The Collection of Resources


Resources Operations
POST
Add Group Type Using POST
POST
Add Stats For Resources Using POST
POST
Add Stats For Resources Using Push Adapter Kind Using POST
POST
Create Custom Group Using POST
POST
Create Custom Profile Using POST
POST
Create Resource Using Adapter Instance Using POST
POST
Create Resource Using Adapter Kind Using POST
DELETE
Delete Custom Group Using DELETE
DELETE
Delete Custom Profile Using DELETE
DELETE
Delete Group Type Using DELETE
DELETE
Delete Resources Using DELETE
GET
Get Custom Group Members Using GET
GET
Get Custom Groups Using GET
GET
Get Custom Group Using GET
GET
Get Custom Profiles Using GET
GET
Get Custom Profile Using GET
GET
Get Group Types Using GET
GET
Get Latest Stats Of Resources Using GET
POST
Get Matching Resources Using POST
GET
Get Resource Properties List Using GET
POST
Get Resources Relationships Using POST
GET
Get Resources Using GET
GET
Get Stat Keys Of Resources Using GET
POST
Get Stats And DT For Resources Using POST
POST
Get Stats For Resources Using POST
GET
Get Stats Of Resources Using GET
GET
Get Top N Stats Of Resources Using GET
PUT
Mark Resources As Being Maintained Using PUT
PUT
Modify Custom Group Using PUT
PUT
Modify Custom Profile Using PUT
POST
Query Latest Properties Of Resources Using POST
POST
Query Latest Stats Of Resources Using POST
PUT
Start Monitoring Resources Using PUT
PUT
Stop Monitoring Resources Using PUT
DELETE
Unmark Resources As Being Maintained Using DELETE
PUT
Update Resource Using PUT