Adding path information to a server

Execution permission

Storage Administrator (Provisioning)

Request line

POST base-URL/simple/v1/objects/servers/object-ID/paths

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

The following is an example of adding path information for a server (ID 10) that is connected using Fibre Channel:

{
  "hbaWwn": "210003e08b0256f9",
  "portIds": [
    "CL1-A"
  ]
}

The following is an example of adding path information for a server (ID 11) that is connected using iSCSI:

{
  "iscsiName": "iqn.myrestapiiscsi20150907",
  "portIds": [
    "CL1-B"
  ]
}

Attribute	Type	Description
hbaWwn	string	(Optional) The WWN of the HBA in 16 lowercase characters. Specify either hbaWwn or iscsiName. Do not specify both of these attributes together.
iscsiName	string	(Optional) The iSCSI name. Specify this item in iqn or eui format: iqn format Specify a value that begins with iqn.. Use no more than 223 characters. You can use alphanumeric characters (0 through 9, A through Z, a through z), and the following symbols: Hyphen (-), period (.), colon (:) Specification example: iqn.rest.example.of.iqn.form eui format After "eui.", specify a hexadecimal number. Specify a value consisting of 20 characters. You can use alphanumeric characters (0 through 9, A through F, a through f). Specification example: eui.0900ABDC32598D26 Specify either hbaWwn or iscsiName. Do not specify both of these attributes together.
portIds	string[]	(Required) The port IDs of the assigned ports.

Response message

Body

Attribute	Type	Description
statusResource	string	URL used to obtain the execution results of the add path information to the server 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 POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/simple/v1/objects/servers/10/paths