Changing server settings

Storage Advisor Embedded User Guide

Version
93-07-2x
88-08-12
Audience
anonymous
Part Number
MK-97HM85022-25

The following request changes the settings of the server corresponding to the specified server ID.

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 G130, G/F350, G/F370, G/F700, G/F900: 0 through 127
  • For VSP E series 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 results of the change server settings request

Note:

Run 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