List all OneView appliances

get/compute-ops-mgmt/v1beta1/oneview-appliances

Retrieve data for all OneView appliances.

URI PATH PREFIX RENAME

This API now supports the URI path prefix /compute-ops-mgmt which used to be /compute-ops. The /compute-ops prefix is deprecated and might become unresponsive after Tuesday, April 1, 2025. The Guide provides more information about this change.

SecurityBearer
Request
query Parameters
limit
integer [ 0 .. 1000 ]

The maximum number of records to return.

Example: limit=10
filter
string

Limit the resources operated on by an endpoint or when used with a multiple-GET endpoint, return only the subset of resources that match the filter. The filter grammar is a subset of OData 4.0.

NOTE: The filter query parameter must use URL encoding. Most clients do this automatically with inputs provided to them specifically as query parameters. Encoding must be done manually for any query parameters provided as part of the URL.
The reserved charecters ! # $ & ' ( ) * + , / : ; = ? @ [ ] must be encoded with percent encoded equivalents. Server IDs contain a +, which must be encoded as %2B.
For example: the value P06760-B21+2M212504P8 must be encoded as P06760-B21%2B2M212504P8 when it is used in a query parameter.

CLASS EXAMPLES
Types integer, decimal, timestamp, string, boolean, null
Operations eq, ne, gt, ge, lt, le, in
Logic and, or, not
Examples:
Return resources where id == c650e411-3454-475d-a1af-7a31b21a1ce4
filter=eq(id,'c650e411-3454-475d-a1af-7a31b21a1ce4')
Return server where id == c650e411-3454-475d-a1af-7a31b21a1ce4
filter=eq(id,%27c650e411-3454-475d-a1af-7a31b21a1ce4%27)
Return resources where applianceType is VM and state is connected
filter=and(eq(applianceType,'VM'),eq(state,'connected'))
Return resources where applianceType is VM or UNKNOWN
filter=in(applianceType,'VM','UNKNOWN')
sort
string

The order in which to return the resources in the collection.

The value of the sort query parameter is a comma separated list of sort expressions. Each sort expression is a property name optionally followed by a direction indicator asc (ascending) or desc (descending).

The first sort expression in the list defines the primary sort order, the second defines the secondary sort order, and so on. If a direciton indicator is omitted the default direction is ascending.

Examples:
Order resources ascending by name
sort=name asc
Order resources ascending by name and then by descending by createdAt
sort=name,createdAt desc
header Parameters
Tenant-Acid
string <uuid>

Tenant-Acid header can be used by an MSP workspace to make API calls on behalf of their tenant by specifying the tenant's application customer ID.

In order to make such an API call, the Bearer token must belong to an MSP workspace and this header value must be the application customer ID of a tenant within the MSP workspace. Use the /compute-ops-mgmt/v1beta1/accounts API to determine the application customer IDs for your tenant accounts.

Responses
200

OK

400

Bad request

401

Unauthorized

403

Forbidden

406

Not acceptable

500

Internal server error

Request samples 
Response samples 
application/json
{
  • "offset": 0,
  • "count": 1,
  • "total": 12,
  • "items": [
    ]
}