HP OneView REST API Reference

id-pools/vsn/ranges
id-pools-vsn-ranges.html[10/17/2013 10:35:18 AM]
The following example shows how to allocate IDs from a range whose
identifier is {range-id}
PUT :https://{appl}/rest/id-pools/vsn/ranges/{range-id}/allocator
Request Body:{"count":10}
URI: /rest/id-pools/vsn/ranges/{id}/collector
Method API
PUT Collects a set of IDs back to a vsn range. The collector returned contains the list of IDs
successfully collected.
Request
Header
Attributes Description
REST API Request Headers NOTE: The X-API-Version header is required for all APIs. For the
current release, this must be set to "X-API-Version:3"
Request
Body
Attributes Description
Collector Required
Response Description
Collector The DTO with the count of IDs collected
Response Codes
REST API Response Codes
Examples
The following example shows how to collect IDs back to a range whose
identifier is {range-id}
PUT : https://{appl}/rest/id-pools/vsn/ranges/{range-id}/collector
Request Body:
{
"idList":[
"VCG434R000",
"VCG434R001"
]
}
URI: /rest/id-pools/vsn/ranges/{id}/free-fragments
Method API
GET Returns all the free vsn fragments to a range.
Parameter Attributes Description
start Optional The 0-based index of the first resource to return (start=0 starts with
the first available resource). If the specified count does not return all
resources within the maximum allowed time (see count), use the
start parameter to view additional resource pages. The default value
for start is 0 (first available resource).