CnsCursor
Cursor object to facilitate pagination of multi-value result for an operation, such as querying volumes.
Usage: Client can set desired values of offset and limit in the first request. Cursor will also be returned as part of result, pointing to next set of values. Client can simply put the cursor object from result back in the next request.
If client does not set cursor object for the request, default offset 0 and default limit 100 will be used. The returned cursor object will set offset to next offset and limit to the default limit.
This structure may be used only with operations rendered under /vsan
.
{
"_typeName": "string",
"offset": 0,
"limit": 0,
"totalRecords": 0
}
Offset value.
These many results will be skipped and not included in result.
Limit value sets upper cap for maximum number of values to be included in result.
Default value for limit is 100 and maximum is 1000 (implementation dependent. Subject to change).
If a value higher than maximum allowed is set in input, it will be limited to the maximum.
This is the total number of records for given input parameters.
This value should be used by client to decide if there is a need to make further calls to server. Client request with offset greater than total number of records would have empty result.