HP OneView REST API Reference

server-profiles
server-profiles.html[10/17/2013 10:35:14 AM]
simple as a name or description change or much more complex changes around the assigned server and
networking configuration. It should be noted that selection of a virtual or physical MAC or Serial Number is not
mutable once a profile has been created, and attempts to change those elements will not be applied to the
target profile. Connection requests can be one of the following types - port Auto, auto and explicit. An explicit
request is where the request portId parameter includes the adapter, port and flexNic. An auto request is where
portId is set to "Auto" and a port auto request is where just the portId parameter includes just the adapter and
port.
Parameter Attributes Description
force Optional If set to true, the operation completes even if there are network
connectivity issues or resource errors. The default is false.
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
ServerProfileV1 Required Server Profile populated with input data
Response Description
TaskResourceV2 TaskResourceV2 object for tracking of the edit
operation to
completion
Response Codes
REST API Response Codes
Examples
The base API is shown here:
PUT https://{appl}/rest/server-profiles/{id}
With the request body taking a format very similar to that
of the one used when creating a profile. A name change
request body is illustrated here:
{"uri": "/rest/server-profiles/{id}",
"name":"Profile101",
"type":"ServerProfileV1",
"serverHardwareUri":"/rest/server-hardware/{id}",
"connections":[],
}
A more advanced example is shown below
{"uri": "/rest/server-profiles/{id}",
"type":"ServerProfileV1",
"name": "Profile101",
"connections":[
{
"id":1,
"functionType":"Ethernet",
"portId":"FlexibleLOM:1-a",
"requestedMbps":2500,
"networkUri":
"/rest/ethernet-networks/{networkUUID}",
"boot":{
"priority":"Primary"
}
},
{
"id":2,
"functionType":"Ethernet",
"portId":"Auto",
"requestedMbps":2500,
"networkUri":
"/rest/network-sets/{networkSetUUID}",