Adding information about the WWN of an HBA (iSCSI name)

Storage Advisor Embedded User Guide

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

The following request adds information about the WWN of an HBA (or iSCSI name) to the server corresponding to the specified server ID.

Execution permission

For cluster configurations, add the WWNs (or iSCSI names) of all of the servers (nodes) that make up the cluster to the server with the same server ID.

Storage Administrator (Provisioning)

Request line

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

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 the WWN 210003e08b0256f9 of an HBA to a Fibre Channel-connected server (ID 10):

{
  "hbas": [
    {
      "hbaWwn": "210003e08b0256f9"
    }
  ]
}

The following is an example of adding the iSCSI name iqn.myrestapiiscsi20150907 in the iqn format to an iSCSI-connected server (ID 11):

{
  "hbas": [
    {
      "iscsiName": "iqn.myrestapiiscsi20150907"
    }
  ]
}

Attribute

Type

Description

hbas

object[]

Information about the WWN of an HBA or the iSCSI name:

  • (Optional) hbaWwn (string)

    Specifies the WWN of the HBA in 16 lowercase characters.

  • (Optional) iscsiName (string)

    Specifies the iSCSI name.

    Specify this item in the 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.

Response message

Body

Attribute

Type

Description

statusResource

string

URL used to obtain the results of the add server information about the WWN of an HBA (or iSCSI name) 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/hbas