HP OneView REST API Reference

id-pools/vmac/ranges
id-pools-vmac-ranges.html[10/17/2013 10:35:17 AM]
The following example shows how to allocate IDs from a vmac range
whose identifier is {range-id}
PUT https://{appl}/rest/id-pools/vmac/ranges/{range-id}/allocator
Request Body: {"count":5}
URI: /rest/id-pools/vmac/ranges/{id}/collector
Method API
PUT Collects a set of IDs back to a vmac 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 vmac range
whose identifier is {range-id}
PUT https://{appl}/rest/id-pools/vmac/ranges/{range-id}/collector
Request Body:
{
"idList": [
"E2:89:E8:B0:00:00",
"E2:89:E8:B0:00:01",
"E2:89:E8:B0:00:02",
"E2:89:E8:B0:00:03",
"E2:89:E8:B0:00:04"
]
}
URI: /rest/id-pools/vmac/ranges/{id}/free-fragments
Method API
GET Returns all the free fragments in a vmac 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