Adding path information to a server

Storage Advisor Embedded User Guide

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

The following request adds path information to the specific server that corresponds to the specified server ID.

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 results of the add path information to the server 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 POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/simple/v1/objects/servers/10/paths