PUT /osdeployment/hostSettings
Use this method to modify the network and storage settings for one or more specific servers.
Authentication
Authentication with username and password is required.
Request URL
PUT https://{management_server_IP}/osdeployment/hostSettings
Query parameters
None
Request body
| Attributes | Required / Optional | Type | Description | ||
|---|---|---|---|---|---|
| networkSettings | Optional | Object | Information about network settings | ||
| dns1 | Optional | String | Preferred DNS server for the host server to be used after the operating system is deployed | ||
| dns2 | Optional | String | Alternative DNS server for the host server to be used after the operating system is deployed | ||
| gateway | Optional | String | Gateway of the host server to be used after the operating system is deployed. This is used when the network setting is set to static in the Global OS deployment settings. Tip To determine the IP mode, use | ||
| hostname | Optional | String | Hostname for the host server. If a hostname is not specified, a default hostname is assigned. | ||
| ipAddress | Optional | String | IP address of the host server to be used after the operating system is deployed. This is used when the network setting is set to static in the Global OS deployment settings. | ||
| mtu | Optional | Long | Maximum transmission unit for the host to be used after the operating system is deployed | ||
| prefixLength | Optional | String | Prefix length of the host IP address to be used after the operating system is deployed. This is used when the network setting is set to static IPv6 in the Global OS deployment settings. | ||
| selectedMAC | Optional | String | MAC address of the host server to which the IP address is to be bound The MAC address is set to AUTO by default. This setting automatically detects the Ethernet ports that can be configured and used for deployment. The first MAC address (port) that is detected is used by default. If connectivity is detected on a different MAC address, the XClarity Administrator host is automatically restarted to use the newly detected MAC address for deployment, and selectedMAC is set to the newly detected MAC address. VLAN mode is supported only for servers that have MAC addresses in their inventory. If AUTO is the only the MAC address that is available for a server, then VLANs cannot be used to deploy operating systems to that server. Tip To obtain the MAC address, use the | ||
| subnetMask | Optional | String | Subnet mask of the host server to be used after the operating system is deployed. This is used when the network setting is set to static in the Global OS deployment settings. Tip To determine the IP mode, use | ||
| vlanId | Optional | String | VLAN ID for operating-system VLAN tagging This attribute is valid only if in VLAN mode is enabled (see GET /osdeployment/globalSettings). Important Only specify a VLAN ID when a VLAN tag is required to function on the network. Using VLAN tags can affect the network routability between the host operating system and the | ||
| selectedImage | Optional | String | Name of the selected OS image to be deployed | ||
| storageSettings | Optional | Object | Preferred storage location on which you want to deploy operating-system images | ||
| targetDevice | Optional | String | Target device. This can be one of the following values.
Note For ThinkServer servers, this value is always | ||
| uuid | Required | String | UUID of the host platform | ||
The following example modifies the network and storage settings for one or more specific servers.
[{
"networkSettings": {
"dns1": "",
"dns2": "",
"gateway": "",
"hostname": "",
"ipAddress": "",
"mtu": 1500,
"prefixLength": 0,
"selectedMAC": "AUTO",
"subnetMask": "",
"vlanId": "2"
},
"storageSettings": {
"targetDevice": "localdisk"
},
"uuid": "69BDF8912E5211E4998B40F2E99033F0"
}]
Response codes
| Code | Description | Comments |
|---|---|---|
| 200 | OK | The request completed successfully. |
| 403 | Forbidden | The orchestrator server was prevented from fulfilling the request. A descriptive error message is returned in the response body. Ensure that you have privileges to perform the request. For XClarity Administrator advanced functions, ensure that you have active licenses for each managed server that supports the advanced functions. |
| 409 | Conflict | There is a conflict with the current state of the resource. A descriptive error message is returned in the response body. |
| 500 | Internal Server Error | An internal error occurred. A descriptive error message is returned in the response body. |
Response body
| Attributes | Type | Description | ||||
|---|---|---|---|---|---|---|
| result | String | Result of the request. This can be one of the following values.
| ||||
| messages | Array | Information about the message that is related to the result of the request | ||||
| explanation | String | Additional information to clarify the reason for the message | ||||
| id | String | Message identifier of a returned message | ||||
| message | String | Message text associated with the message identifier | ||||
| recovery | Array | Recovery information | ||||
| text | String | User actions that can be taken to recover from the event | ||||
| URL | String | Link to the help system for more information, if available | ||||
The following example is returned if the request is successful.
{
"result": "success",
"messages": []
}
Give documentation feedback