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

flash-device-list-info flash-get-thresholds | The Flash Management Module (FMM) is the management interface to access information about flash devices in the system.

NetApp Manage ONTAP

flash-device-list-info | [top]

> This API is used to retrieve information about the flash devices in the controller registered with Flash Management Module (FMM).

> Input Name | Range | Type | Description
> slot-number | [1..255] | integer optional | PCI-e slot number of the flash device. If not provided, information of all the registered devices will be given.
> Output Name | Range | Type | Description
> flash-device-info |  | flash-device-info[] optional | List of registered flash devices.

> Errno | Description
> ENOFMMDEVICES |  |
> EINTERNALERROR |  |

flash-get-thresholds | [top]

> Get threshold profiles available in Flash Management Module.

> Input Name | Range | Type | Description
> profile |  | string optional | Name of the threshold profile. If not provided, all available profiles will be printed.
> Output Name | Range | Type | Description
> flash-threshold-profile |  | flash-threshold-profile[] optional | A collection of failure threshold entries.

Element definition: flash-device-info | [top]

> Flash device information.

> Name | Range | Type | Description
> average-erase-cycle-count | [0..2^63-1] | integer | Average number of executed erase cycles.
> capacity | [0..2^31-1] | integer | Advertised capacity of the device, in gigabytes.
> firmware-revision |  | string | Firmware revision of FPGA on the flash device.
> last-change-time | [0..2^31-1] | integer | Seconds since Midnight 1/1/1970 UTC when status changed.
> model-name |  | string | Model name of the flash device in XXXXXX-XX format.
> part-number |  | string | Part number of the flash device in XXX-XXXXX format.
> percent-online | [0..100] | integer | Percentage of device capacity that is currently online.
> serial-number |  | string | 10-digit serial number of the flash device.
> service-time | [0..2^31-1] | integer | Total number of hours the device was operational.
> slot-number | [1..255] | integer | PCI-e slot number of the flash device.
> status |  | string | The current status of the device. Possible values: "online", "offline_failed", or "offline_threshold".
> threshold-profile |  | string | The name of the threshold profile being used for this flash device.

Element definition: flash-threshold-profile | [top]

> A definition for a threshold element

> Name | Range | Type | Description
> flash-threshold |  | flash-threshold[] | The list of threshold entries for this profile.
> profile |  | string | The name of the profile in plain text.

Element definition: flash-threshold | [top]

> A definition for a threshold element. Each threshold specifies what level of errors or failures the specified domain can sustain before the specified action is taken.

> Name | Range | Type | Description
> action |  | string | Action to be taken if this threshold is exceeded. Possible values: "log an EMS event", "log an EMS_event, and disable the 'domain'", "log an EMS event, and send an AutoSupport message", "log an EMS event, send an AutoSupport message, and disable the 'domain'"
> domain |  | string | The type of domain. Possible values: "card", "bank", "chip" (in Data ONTAP 7.3.x to 8.1) or "lun" (from Data ONTAP 8.2 onwards).
> threshold-units |  | string | The metric for threshold. Possible values: "count", or "percentage".
> threshold-value | [0..2^31-1] | integer | Threshold value in 'threshold-units'.
> time-slice |  | string | The time slice. Available if the 'threshold-unit' is "count". If not, output will say 'none'. Possible values: "none", "seconds", "minutes", or "hours".