APIs in Category: disk | 7-Mode API version 1.20

disk-fail disk-list-info disk-release-all-reservations disk-remove disk-replace-start disk-replace-stop disk-sanown-assign disk-sanown-filer-list-info disk-sanown-list-info disk-sanown-reassign disk-sanown-remove-ownership disk-swap disk-unfail disk-unswap disk-update-disk-fw disk-zero-spares

NetApp Manage ONTAP

disk-fail | [top]

> Fail a file system disk. Removes the specified file system disk from the RAID configuration, spinning the disk down when removal is complete. disk fail is used to remove a file system disk that may be logging excessive errors and requires replacement. Note that if optional input parameter 'is-immediate' is true, the specified disk will be immediately failed out, and the RAID group to which the disk belongs will enter degraded mode (meaning a disk is missing from the RAID group). If a spare disk at least as large as the disk being removed is available, the contents of the disk being removed will be reconstructed onto that spare disk. If 'is-immediate' options is false or not specified, system will prefail the disk and its content will be copied to a replacement disk if a suitable spare disk is available, and afterwards the prefailed disk will be failed out. This process can be observed by polling disk-list-info for this disk and tracking values of elements copy-destination and copy-percent. Same can be done using 'storage-disk-get-iter' when requested from Admin Vserver LIF. The disk being failed is marked as ``broken'', so that if it remains in the disk shelf, it will not be used by the filer as a spare disk. If the disk is moved to another filer, that filer will use it as a spare. This is not a recommended course of action, as the reason that the disk was failed may have been because it needed to be replaced. NOTE: Data ONTAP 7.0 and earlier releases don't indicate failure code properly.

> Input Name | Range | Type | Description
> disk |  | string | Name of the disk to fail, e.g. "v0.1". On Admin Vserver LIF, this will be disk path name with format of ":". e.g. "Filer01:v0.1"
> is-immediate |  | boolean optional | Specify 'true' if disk is to be failed out immediately. If disk is to be prefailed, specify 'false'. Default value is 'false'.

> Errno | Description
> EINTERNALERROR |  |
> EDISKNOTFOUND |  |
> ESWAPINPROGRESS |  |
> ENOTDISKOWNER |  |
> EOPNOTSUPPORTED |  |
> EDISKINRAIDZEROVOL |  |
> ENOTSTARTED |  |
> EDISKISSPARE |  |
> ESAVECOREDISK |  |
> E_GROUP_REPARITY |  |
> E_MIRROR_RESYNC |  |
> EOP_DISALLOWED_DURING_REVERT |  |

disk-list-info | [top]

> Get disk/array LUN status information from RAID. By default, only disks/array LUNs owned by the storage system or its partner are eligible for inclusion in the returned list. Unowned disks/array LUNs may be displayed by using the ownership-type option. To obtain information about disks/array LUNs connected to the storage system, but owned by a system other than the local system or its CFO partner use the disk-sanown-list-info api.

> Input Name | Range | Type | Description
> disk |  | string optional | Get status for given disk, if not supplied, get status for all disks owned by the system and its CFO partner.
> ownership-type |  | string optional | This field is used to specify which disks/array LUNs are listed. Valid values are 'assigned', 'unassigned' and 'all'. If ownership-type is set to 'assigned' then only assigned disks/array LUNs are returned. If ownership-type is set to 'unassigned' then only unassigned disks/array LUNs are returned. If ownership-type is set to 'all' then both assigned and unassigned disks/array-LUNs are returned. The default is to return assigned disks/array LUNs. Default: 'assigned'.
> Output Name | Range | Type | Description
> disk-details |  | disk-detail-info[] | List of disks and their status.

> Errno | Description
> EINTERNALERROR |  |
> EDISKNOTFOUND |  |
> ENODENOTFOUND |  |

> Vfiler-enabled
> Yes

disk-release-all-reservations | [top]

> Release reservations on all reserved disks. When invoked from maintenance mode, all reservations are released on all disks until the system is rebooted. When not in maintenance mode, then the system will automatically re-issue reservations for disks it owns. In sanown environment the system will reserve its disks everu 30 seconds.

> Errno | Description
> ERESERVATIONSDISABLED |  |
> EUNABLETORELEASE |  |

disk-remove | [top]

> Remove a spare disk. Removes the specified spare disk from the RAID configuration, spinning the disk down when removal is complete. You can use disk remove to remove a spare disk so that it can be used by another filer (as a replacement for a failed disk or to expand file system space). NOTE: Data ONTAP 7.0 and earlier releases don't indicate failure code properly.

> Input Name | Range | Type | Description
> disk |  | string | Name of the disk to remove, e.g. "v0.1". On Admin Vserver LIF, this will be disk path name with format of ":Disk Name". e.g. "Filer01:2a.32"

> Errno | Description
> EINTERNALERROR |  |
> EDISKNOTFOUND |  |
> ENOTSTARTED |  |
> EDISKNOTSPARE |  |
> ESAVECOREDISK |  |
> EOP_DISALLOWED_DURING_REVERT |  |

disk-replace-start | [top]

> Initiate replacing a file system disk with an appropriate spare disk. Uses Rapid RAID Recovery to copy data from the source file system disk to the destination spare disk. Roles of disks are reversed at the end of that process. The spare disk will replace the file system disk in the RAID group and the file system disk will become a spare. This interface returns as soon as possible while disk replace starts in the background. This process can be observed by polling disk-list-info for this disk and tracking values of elements copy-destination and copy-percent. Note: The operation performs limited error checking. Disk replace starts asynchronously in the background, and it can fail even if ZAPI reports success.

> Input Name | Range | Type | Description
> allow-same-carrier |  | boolean optional | Using two disks from one carrier that houses multiple disks in one RAID group is not desirable. If that happens, Data ONTAP initiates a series of disk copy operations to correct that situation. Sometimes, selection of available spare disks makes it impossible to avoid placing two disks from one carrier in one RAID group. Setting this option to true allows placing two disks from one carrier in one RAID group.
> disk |  | string | Name of the file system disk to replace.
> force |  | boolean optional | Allow replacement-disk to come from the opposite spare pool. Also allow replacement-disk not matching rotational speed of majority of disks in the aggregate.
> replacement-disk |  | string | Name of the spare disk to use as a replacement.

> Errno | Description
> EDISKNOTFOUND |  |
> ENOTDISKOWNER |  |
> EDISKISSPARE |  |
> EDISKNOTSPARE |  |
> EDISKTOOSMALL |  |
> EDISKINRAIDZEROVOL |  |
> EALREADYSTARTED |  |
> ERAIDGROUPDEGRADED |  |
> EVOLUMEOFFLINE |  |
> EINTERNALERROR |  |
> EOP_DISALLOWED_DURING_REVERT |  |

disk-replace-stop | [top]

> Abort disk replace.

> Input Name | Range | Type | Description
> disk |  | string | Name of the file system disk being replaced.

> Errno | Description
> EDISKNOTFOUND |  |
> EDISKISSPARE |  |
> ENOTSTARTED |  |
> EINTERNALERROR |  |
> EOP_DISALLOWED_DURING_REVERT |  |

disk-sanown-assign | [top]

> Assigns ownership of a disk. The normal usage is when the disk is unowned, or to assign a disk to a pool.

> Input Name | Range | Type | Description
> all |  | boolean optional | Assign all unowned visible disks to the specified node. The node parameter is mandatory. No other parameter is allowed with this option.
> auto |  | boolean optional | Auto-assign unowned disks which are on loops where only 1 filer owns the disks and the pool information is the same, to the specified node. The node parameter is mandatory. No other parameter is allowed with this option.
> checksum |  | string optional | Assign checksum type to disk. Option may only be specified on a RAID array LUNs. Possible values: 'block' or 'zoned'.
> disk |  | string optional | Name of disk to assign. Wildcarding for disk string is supported. Either owner or owner-id is mandatory. The node parameter is not allowed with this option.
> disk-count |  | integer optional | Assign specified count of disks
> disk-type |  | string optional | Assign specified type of disk(or set of disks). The disk-count parameter is mandatory. Type of disk: ATA, BSAS, EATA, FCAL, FSAS, LUN, MSATA, SAS, SATA, SCSI, SSD, BSSD, XATA, XSAS, or unknown.
> force |  | boolean optional | Force flag need to be set to 'true' if assigning disks which are already owned a Filer. However, if that Filer is up and has put a reservation on the disk, even the force option won't work.
> node-name |  | string optional | Used only with auto or all parameter. It specifies the node to which autoassignment or assignment of all unowned disks must be done.
> owner |  | string optional | Assign disk to specific owner.Either owner or owner-id is mandatory
> owner-id |  | integer optional | Assign disk to specific owner ID (NVRAM ID or serial number). Either owner or owner-id is mandatory Range : [0..2^32-1].
> pool |  | integer optional | Assign disk to specific pool, e.g. '0' or '1'.

> Errno | Description
> EINTERNALERROR |  |
> EDISKNOTFOUND |  |
> EINVALIDOWNER |  |
> EINVALIDINPUTERROR |  |

disk-sanown-filer-list-info | [top]

> Get sanown filer information.

> Output Name | Range | Type | Description
> disk-sanown-filer-details |  | disk-sanown-filer-detail-info[] | List of filers and their information.

> Errno | Description
> EINTERNALERROR |  |
> ESANOWNNOTENABLED |  |

disk-sanown-list-info | [top]

> Get sanown disk information. This API is not supported as of Data ONTAP 8.2. Use storage-disk-get-iter instead.

> Input Name | Range | Type | Description
> disk |  | string optional | Get ownership status for given disk, if not supplied, get ownership for all disks or if onership-type is supplied, get ownership info for disks of specific type. '6a*' wildcarding is supported.
> ownership-type |  | string optional | Possible values are 'all' which will list all disks. 'unowned' which will list all disks without owners. 'owned' which will list all disks with owners. 'visible' which will list all disks belonging to the local and partner filer. Default is 'all'. If specific disk is specified, ownership-type will be ignored.
> Output Name | Range | Type | Description
> disk-sanown-details |  | disk-sanown-detail-info[] | List of disks and their sanown information.

> Errno | Description
> EINTERNALERROR |  |
> EDISKNOTFOUND |  |
> EAPIUNSUPPORTEDVERSION |  |

disk-sanown-reassign | [top]

> Changes ownership on disks already belonging to an owner.

> Input Name | Range | Type | Description
> force |  | boolean optional | Force flag need to be set to 'true' if reassigning disks which are owned by another Filer. However, if that Filer is up and has put a reservation on the disk, even the force option won't work. In this case reassign will need to be run on the Filer which owns the disks.
> new-owner |  | string optional | Name of new owner. This form will assign all the disks belonging to the old owner to the specific owner.
> new-owner-id |  | integer optional | ID of new owner. This form will assign all the disks belonging to the old owner to the specific owner ID. Either new-owner or new-owner-id (or both) must be specified. Range : [0..2^32-1].
> old-owner |  | string optional | Name of old owner. This form takes all disks currently belonging to the specific old owner, and reassigns them to a new owner.
> old-owner-id |  | integer optional | ID of old owner. This form takes all disks currently belonging to the specific old owner ID, and reassign them to a new owner. Either old-owner or old-owner-id must be specified, but not both. Range : [0..2^32-1].

> Errno | Description
> EINTERNALERROR |  |
> EDISKFAILED |  |

disk-sanown-remove-ownership | [top]

> Removes ownership information on a disk. Default usage is to remove ownership information for all disks owned by the local node, in maintenance mode.

> Input Name | Range | Type | Description
> all |  | boolean optional | If 'true' remove ownership information from all disks. (maintenance mode only)
> disk-list |  | disk-name[] optional | List of disks to remove ownership information from. Example: 4a.18 5b.16 switch1:10.126L4
> force |  | boolean optional | If 'true' override the RAID checks. Eg: Disk is part of aggregate. Otherwise defaults to false.
> owner |  | string optional | Remove ownership of all disks owned by owner. Either owner or owner-id is mandatory
> owner-id |  | integer optional | Remove ownership of all disks owned by this owner-id (maintenance mode only). Range [0..2^32-1]

> Errno | Description
> EINVALIDINPUTERROR |  |
> EDISKNOTFOUND |  |
> EINVALIDOWNER |  |
> EINVALIDRESERVATION |  |
> ENODISKSFOUND |  |
> EMUSTBEINMAINTMODE |  |
> EINTERNALERROR |  |
> EDISKFAILED |  |

disk-swap | [top]

> Prepare (quiet) bus for swap. Applies to SCSI disks only. It stalls all I/O on the filer to allow a disk to be physically added or removed from a disk shelf. Typically, this command would be used to allow removal of a failed disk, or of a file system or spare disk that was prepared for removal using the disk fail or disk remove command. Once a disk is physically added or removed from a disk shelf, system I/O will automatically continue. NOTE: It is important to issue the disk swap command only when you have a disk that you want to physically remove or add to a disk shelf, because all I/O will stall until a disk is added or removed from the shelf. This API is not supported in Data ONTAP 8.0 and later.

> Errno | Description
> EOPNOTSUPPORTED |  |
> EALREADYSTARTED |  |
> EINTERNALERROR |  |

disk-unfail | [top]

> Unfail a disk in the broken pool, by clearing its FDR (Failed Disk Registry) entry and unfailing it at the Storage Layer, as necessary. If the "make-spare" option is set to B_TRUE, the disk is returned to the spare pool. Otherwise, label assimilation will bring the disk back according to its on-disk labels, with one of four possible outcomes. 1. Disk becomes a spare. This is the common case. The disk becomes a spare upon unfail, because its parent volume is complete and online. 2. Disk is assimilated into former volume. This is a recovery scenario. The disk is brought back into an existing volume, which may result in this volume coming back online. 3. Disk is assimilated into a new partial volume. This may occur in the rare case that the disk's former volume was destroyed or moved. 4. Disk returned to broken pool. This is the case if a fatal error occurs in process of unfailing the disk.

> Input Name | Range | Type | Description
> disk |  | string | Name of the disk, e.g. "v0.1". On Admin Vserver LIF, this will be disk path name with format of ":Disk Name". e.g. "Filer01:2a.32"
> make-spare |  | boolean optional | Specify 'true' to force the disk to become a spare upon unfail. Default value is 'false'.

> Errno | Description
> EINTERNALERROR |  |
> EDISKNOTFOUND |  |
> EOP_DISALLOWED_DURING_REVERT |  |

disk-unswap | [top]

> Undo disk swap and resume service. This API is not supported in Data ONTAP 8.0 and later.

> Errno | Description
> EOPNOTSUPPORTED |  |
> ENOTSTARTED |  |
> EINTERNALERROR |  |

disk-update-disk-fw | [top]

> Start disk firmware download process to update firmware on disks. This operation is asynchronous, and therefore returns no errors that might occur during the download process. This operation will only update firmware on disks that do not have the latest firmware revision. The firmware revision on the disk can be monitored via the disk-list-info API.

> Input Name | Range | Type | Description
> disk-list |  | disk-name[] optional | List of disks to be updated. If not specified, all disks are updated. Example: 4a.18 5b.16 switch1:10.126L4

> Errno | Description
> EINTERNALERROR |  |
> EDISKNOTFOUND |  |
> EINVALIDINPUTERROR |  |
> ENODENOTFOUND |  |

disk-zero-spares | [top]

> Set up all non-zeroed spares owned by the filer to start zeroing. This operation is asynchronous, and therefore returns no errors that might occur when the zeroing operation actually starts, which could be several seconds after this API operation completes. Zeroing progress can be monitored via the disk-list-info API. Same can be done using 'storage-disk-get-iter' when requested from Admin Vserver LIF. The "zeroing-percent" element of disk-detail-info is returned if disk zeroing has started, and "is-zeroed" returns TRUE once the zeroing has completed (or, if zeroing wasn't necessary in the first place).

> Errno | Description
> EINTERNALERROR |  |

Element definition: disk-detail-info | [top]

> Disk status information.

> Name | Range | Type | Description
> aggregate |  | string optional | Aggregate that the disk resides on. Returned for disks contained on a flexible volume. Not returned for traditional volumes.
> bay |  | string | Disk bay. If disk bay can't be determined, value will be "?".
> blocks-read |  | integer | Number of blocks read since the controller was powered on last. Range: [0..2^64-1]
> blocks-written |  | integer | Number of blocks written since the controller was powered on last. Range: [0..2^64-1]
> broken-details |  | string optional | Reason for the disk failure, if raid-state is 'broken'. Possible values are 'unknown', 'failed', 'admin failed', 'labeled broken', 'init failed', 'admin removed', 'not responding', 'pulled', 'bad label', 'bypassed', 'SFO Disk' and 'not failed'. If raid-state is not 'broken', broken-details will be omitted in the ouput.
> bytes-per-sector |  | integer | Bytes per sector. Range : [0..2^31-1].
> checksum-compatibility |  | string | An indication of the checksum types that this disk is capable of supporting. Each possible return value represents one or more checksum types. Starting in Data ONTAP 8.1, "zoned/block" is no longer supported. Possible values are: "advanced_zoned" - Supports advanced_zoned checksum. "block" - Supports block checksum. "none" - No checksum support. "zoned/advanced_zoned" - Supports zoned and advanced_zoned checksum. "zoned/block" - Supports zoned and block checksum.
> copy-destination |  | string optional | The name of the disk selected as the destination to copy this disk when it must be replaced (is-prefailed or is-replacing is true). This element is not returned if the destination is not selected. The destination might not be present even when is-prefailed or is-replacing is true, if there is no appropriate spare, or other disk copy is in progress, or the destination was not yet selected, including immediately after disk-replace-start.
> copy-percent |  | integer optional | Percent of disk copy done, if disk is involved in Rapid RAID Recovery, either as the source (is-prefailed or is-replacing is true) or as the destination (raid-state is 'copy') of disk copy. This element is not returned if the destination is not selected yet. Range : [0..100].
> disk-model |  | string | Disk model.
> disk-type |  | string | Type of disk: ATA, BSAS, EATA, FCAL, FSAS, LUN, MSATA, SAS, SATA, SCSI, SSD, XATA, XSAS, or unknown.
> disk-uid |  | string | Disk unique identifier. Maximum length of 90 characters.
> effective-disk-type |  | string | Disks with same effective-disk-type are compatible, and they can be used in the same aggregate, even though their physical disk type, as reported by disk-type may be different. Possible values are the same as for disk-type: ATA, BSAS, EATA, FCAL, FSAS, LUN, MSATA, SAS, SATA, SCSI, SSD, XATA, XSAS, or unknown.
> firmware-revision |  | string | Firmware revision of disk. The format of the firmware revision will vary depending on the type of disk and its vendor.
> grown-defect-list-count |  | integer | Number of entries in the drive's grown defect list. Range: [0..2^64-1]
> host-adapter |  | string | Host adapter.
> id |  | integer | internal Id of disk. Range : [-2^31..2^31-1].
> is-dynamically-qualified |  | boolean | True if the drive was dynamically qualified.
> is-offline |  | boolean optional | True if the disk is offline. If the disk is not offline, this element will not be included with the output.
> is-prefailed |  | boolean optional | True if the disk is prefailed and undergoing disk copy (as the source) or waiting for such disk copy to be started, false otherwise.
> is-replacing |  | boolean optional | True if the disk is marked to be replaced with another disk and undergoing disk copy (as the source) or waiting for such disk copy to be started, false otherwise.
> is-zeroed |  | boolean optional | True if the disk is a spare and has already been zeroed, false otherwise. If disk is not a spare or if it is currently being zeroed, this element will not be included with the output.
> name |  | string | Name of the disk, e.g. v1.1
> node |  | string | Controller supplying this disk record.
> physical-blocks |  | integer | Number of 512-byte blocks on disk. Range : [0..2^64-1].
> physical-space |  | integer | Physical disk size in bytes. Range : [0..2^64-1].
> plex |  | string optional | Plex the disk belongs. Not returned if disk doesn't belong to any plex. Example : plex0.
> pool |  | string optional | Pool the disk is in. Example : pool0.
> port |  | string | Port of disk, e.g. A.
> port-name |  | string | The port name of the disk object, e.g. FC:A.
> poweron-hours |  | integer optional | Number of hours the drive has been powered on. Range: [0..2^64-1]
> raid-group |  | string optional | Raid group disk belongs. Not returned if disk doesn't belong to any raid group.
> raid-state |  | string | Raid state. Possible values are : partner, broken, zeroing, spare, copy, pending, reconstructing, present and unknown.
> raid-type |  | string | Raid type. Possible values are : pending, parity, dparity, data, and unowned.
> raw-disk-sectors |  | integer | Number of sectors on disk (as reported by the read capacity command). Range: [0..2^64-1].
> reconstruction-percent |  | integer optional | Percent of reconstruction done, if the disk is undergoing reconstruction (raid-state is 'reconstructing'). This element is not returned if the disk is not being reconstructed. Range : [0..100].
> rpm |  | integer optional | Rotational speed in revolutions per minute. Possible values are: 5400, 7200, 10000, and 15000. This element is not returned when the value is not known, or when it does not apply.
> scrub-count |  | integer | Number of times the drive was scrubbed since the controller was powered on last. Range: [0..2^64-1]
> scrub-last-done |  | integer | Number of seconds since the last time scrub was completed. Range: [0-2^64-1]
> secondary-host-adapter |  | string | Secondary Host adapter.
> secondary-name |  | string | Secondary name.
> secondary-port |  | string | Secondary port.
> serial-number |  | string | Disk serial number. Maximum length of 129 characters.
> shelf |  | string | Disk shelf. If disk shelf can't be determined, value will be "?".
> shm-time-interval |  | integer | Number of seconds we have been counting errors from SHM (Storage Health Monitor). Range: [0..2^64-1]
> ssd-info |  | storage-ssd-info optional | Info block for solid-state storage devices.
> used-blocks |  | integer | Number of 512-byte blocks used. Range : [0..2^64-1].
> used-space |  | integer | Used space in bytes. Range : [0..2^64-1].
> v-series-detail-info |  | v-series-detail-info optional | Lists LUN status from RAID array LUNs
> vendor-id |  | string | Vendor of this disk.
> volume |  | string optional | Volume the disks is used in. Not returned if disk isn't used in any volume or if the disk belongs to a partner or if the disk is in an aggregate.
> zeroing-percent |  | integer optional | Zeroing percentage done, if disk is being zeroed. Element is not returned if disk is not being zeroed. Range : [0..100].

Element definition: disk-name | [top]

> name of a disk.

> [none]

Element definition: disk-sanown-detail-info | [top]

> Disk sanown information.

> Name | Range | Type | Description
> checksum |  | string optional | Only returned on RAID array LUNs. The possible values: "advanced_zoned" - advanced_zoned checksum (azcs), "block" - block, "zoned" - zoned.
> home |  | string optional | The home of the disk. On NG will be different than owner if the home node has been taken over. On Classic this will be the same as owner. If the disk has no owner, this will not be returned.
> home-id |  | integer optional | ID (NVRAM ID) of disk home. Range : [0..2^32-1].
> is-failed |  | boolean | 'true' if the disk is failed, 'false' otherwise.
> name |  | string | Name of the disk, e.g. v1.1 Wildcarding for disk string is suuported, e.g. v1.*
> owner |  | string optional | Current owner of the disk. If disk has no owner, this will not be returned.
> owner-id |  | integer optional | ID (NVRAM ID) of owner if there is one. Range : [0..2^32-1].
> pool |  | integer optional | Pool the disk belongs to, if it has a owner.
> reserved-by |  | integer | ID (NVRAM ID) of node with the reservation on this disk, 0 if there is none. Range : [0..2^32-1].
> serial-no |  | string | Serial number of the disk.
> type |  | string optional | Indicates the type of disk or device being being reported. Values are one of following: "SCSI", "FCAL", "D_ATA", "E_ATA", "LUN", "MSATA", "SSD", "UNKNOWN"

Element definition: disk-sanown-filer-detail-info | [top]

> Disk sanown filer information.

> Name | Range | Type | Description
> filer-id |  | integer | ID (NVRAM ID) of owner. Range : [0..2^32-1].
> filer-name |  | string optional | Name of the filer. If the filer name hasn't been written to the disks, this will not be returned.

Element definition: storage-ssd-info | [top]

> Storage info block for solid-state storage devices.

> Name | Range | Type | Description
> percent-rated-life-used | [0..255] | integer optional | An estimate of the percentage of device life that has been used, based on the actual device usage and the manufacturer's prediction of device life. A value greater than 99 indicates that the estimated endurance has been consumed, but may not indicate a device failure. Omitted if value is unknown.
> percent-spares-consumed | [0..100] | integer optional | Percentage of device spare blocks that have been used. Each device has a number of spare blocks that will be used when a data block can no longer be used to store data. This value reports what percentage of the spares have already been consumed. Omitted if value is unknown.
> percent-spares-consumed-limit | [0..100] | integer optional | Spares consumed percentage limit reported by the device. Omitted if value is unknown.

Element definition: v-series-detail-info | [top]

> LUN status from RAID array LUNs

> Name | Range | Type | Description
> alternate-array-node-wwn |  | string | The RAID array LUN alternate path is the path that can be used to communicate with the LUN, but not currently used. This is the WWNN (World Wide Node Name) of the array FC port used as the secondary path.
> alternate-array-port-wwn |  | string | The RAID array LUN alternate path is the path that can be used to communicate with the LUN, but not currently used. This is the WWPN (World Wide Port Name) of the array FC port used as the secondary path.
> alternate-array-switch-port-wwn |  | string optional | The RAID array LUN alternate path is the path that can be used to communicate with the LUN, but not currently used. This is the WWN of the switch FC port connected to the array FC port used as primary path. This field is present in switch attached configrations only.
> alternate-controller-port-wwn |  | string | The RAID array LUN alternate path is the path that can be used to communicate with the LUN, but not currently used. This is the WWN of the FC port controller used as secondary path.
> alternate-lun-number |  | integer | LUN number on the alternate path Range: [0..65535]
> alternate-switch-name |  | string optional | Switch name of the alternate path. Present for switch attached configurations only.
> alternate-switch-port |  | integer optional | Switch port of the alternate path. Present for switch attached configurations only. Range: [0..1024].
> alternate-vseries-port-wwn |  | string | This is the same as alternate-controller-port-wwn, presented for backwards compatibility.
> primary-array-node-wwn |  | string | The RAID array LUN primary path is the path that is currently used to communicate with the LUN. This is the WWNN (World Wide Node Name) of the array FC port used as primary path.
> primary-array-port-wwn |  | string | The RAID array LUN primary path is the path that is currently used to communicate with the LUN. This is the WWPN (World Wide Port Name) of the array FC port used as primary path.
> primary-array-switch-port-wwn |  | string optional | The RAID array LUN primary path is the path that is currently used to communicate with the LUN. This is the WWN of the switch FC port connected to the array FC port used as primary path. This field is present in switch attached configrations only.
> primary-controller-port-wwn |  | string | The RAID array LUN primary path is the path that is currently used to communicate with the LUN. This is the WWN of the FC port controller used as primary path.
> primary-lun-number |  | integer | LUN number on the primary path Range: [0..65535]
> primary-switch-name |  | string optional | Switch name of the primary path. Present for switch attached configurations only.
> primary-switch-port |  | integer optional | Switch port of the primary path. Present for switch attached configurations only. Range: [0..1024].
> primary-vseries-port-wwn |  | string | This is the same as primary-controller-port-wwn, presented for backwards compatibility.
> product-id |  | string | Product id string of the raid array lun resides on.