Search Entities
Using search API you can search vRealize Network Insight entities by specifying entity type and filter expression. A filter expression is a predicate expression (similar to SQL where clause) used to define the search criteria. Please refer to API Guide on details of how to construct filter expression. A successful search request will return a list of entity ids that matches the search criteria.
Request
URI
POST
https://vrni.example.com/api/ni/search
COPY
Request Body
Search Request
SearchRequest of type(s) application/json
Optional
{
"entity_type": "string",
"filter": "string",
"sort_by": {
"field": "string",
"order": "string"
},
"size": 0,
"cursor": "string",
"time_range": {
"start_time": 1597247025,
"end_time": 1597247999
}
}string
filter
Optional
query filter
integer As int32 As int32
size
Optional
size
string
cursor
Optional
cursor
Responses
200
Success
Returns PagedListResponseWithTime of type(s) application/json
{
"results": [
{
"entity_id": "string",
"entity_type": "VirtualMachine",
"time": 0
}
],
"cursor": "ML12eu02==",
"total_count": 100,
"start_time": 1504739809,
"end_time": 1504739809
}string
cursor
Optional
Cursor for the next page
integer
total_count
Optional
Total number of objects returned
integer As int64 As int64
start_time
Optional
Start timestamp of the window of the objects returned
integer As int64 As int64
end_time
Optional
End timestamp of the window of the objects returned
400
Bad Request
Returns ApiError of type(s) application/json
{
"code": 0,
"message": "string",
"details": [
{
"code": 0,
"message": "string",
"target": [
"string"
]
}
]
}integer As int32 As int32
code
Optional
code
string
message
Optional
message
401
Unauthorized
Operation doesn't return any data structure
500
Internal Error
Operation doesn't return any data structure