Changing server settings

Execution permission

Storage Administrator (Provisioning)

Request line

PATCH base-URL/simple/v1/objects/servers/object-ID

Request message

Object ID

Specify the id value obtained by getting information about the server.

Attribute	Type	Description
id	int	(Required) Server ID

Query parameters

None.

Body

Only the specified attributes are changed.

The following is an example of changing the OS type to Solaris for a Fibre Channel-connected server (ID 10):

{
  "osType": "Solaris"
}

The following is an example of changing the nickname of an iSCSI-connected server (ID 11) to My_REST_API_HOST:

{
  "nickname": "My_REST_API_HOST"
}

Attribute	Type	Description
nickname	string	(Optional) Specify a server nickname consisting of 1 through 229 characters. You can use alphanumeric characters (0 through 9, A through Z, a through z), space characters, and the following symbols: Comma (,), Hyphen (-), period (.), forward slash (/), colon (:), at sign (@), back slash (\), underscore (_) This attribute is case-sensitive. You can use a space character between characters, but cannot use it at the beginning or end of the server nickname. You cannot use a hyphen (-) at the beginning of the server nickname. This attribute cannot be specified together with the following attributes: If you are using an iSCSI connection, the server nickname must not include any commas (,), slashes (/), or backslashes (\). osType osTypeOptions
osType	string	(Optional) OS type You can specify the following values: Linux HP-UX OpenVMS Tru64 Solaris NetWare AIX VMware Windows This attribute cannot be specified together with the following attribute: nickname
osTypeOptions	int[]	(Optional) Specify an option for the OS type as an integer. For VSP Fx00 models and VSP Gx00 models: 0 through 127 For VSP E990 storage systems: 0 through 255 For the specifiable numbers, see the Provisioning Guide. This attribute corresponds to the host mode option in Command Control Interface and in Device Manager - Storage Navigator. If you do not specify the OS type option, this value will be overwritten by the value that is currently set for the OS type. If a value is already set for the OS type option and you do not want to overwrite the value, specify the OS type option that is currently set. This attribute cannot be specified together with the following attribute: nickname

Response message

Body

Attribute	Type	Description
statusResource	string	URL used to obtain the execution results of the change server settings request

Note:

Execute the API function for obtaining information about the status of the API function that performs asynchronous processing. For details, see Getting status information about an API function that performs asynchronous processing.

Status codes

See HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X PATCH --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/simple/v1/objects/servers/10