APIs in Category: diagnosis
7-Mode API version 1.15

 
diagnosis-alert-definition-get
diagnosis-alert-definition-get-iter
diagnosis-alert-get
diagnosis-alert-get-iter
diagnosis-alert-modify
diagnosis-config-get
diagnosis-config-get-iter
diagnosis-delete-alert
diagnosis-policy-definition-get
diagnosis-policy-definition-get-iter
diagnosis-policy-modify
diagnosis-status-get
diagnosis-subscriptions-create
diagnosis-subscriptions-get
diagnosis-subscriptions-get-iter
diagnosis-subscriptions-modify
This set of Zapis is used for monitoring and diagnosing system health.

NetApp Manage ONTAP
 
diagnosis-alert-definition-get [top]

Return alert definition
Input Name Range Type Description
alert-id string
Alert identification.
desired-attributes diagnosis-alert-definition-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
monitor hm-type
Type of health monitor (e.g. node_connect, system_connect, system).
node string
Node hosting this health monitor.
 
Output Name Range Type Description
attributes diagnosis-alert-definition-info
The attributes of the Alert Definition.
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
diagnosis-alert-definition-get-iter [top]
Iterate over a list of Alert Definition objects.
Input Name Range Type Description
desired-attributes diagnosis-alert-definition-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
max-records [1..100] integer
optional
The maximum number of records to return in this call. Default: 20
query diagnosis-alert-definition-info
optional
A query that specifies which objects to return. A query could be specified on any number of attributes in the Alert Definition object. All Alert Definition objects matching this query up to 'max-records' will be returned.
tag string
optional
Specify the tag from the last call. It is usually not specified for the first call. For subsequent calls, copy values from the 'next-tag' obtained from the previous call.
 
Output Name Range Type Description
attributes-list diagnosis-alert-definition-info[]
optional
The list of attributes of Alert Definition objects.
next-tag string
optional
Tag for the next call. Not present when there are no more Alert Definition objects to return.
num-records [0..100] integer
The number of records returned in this call.
 Errno  Description
 EINTERNALERROR

 
diagnosis-alert-get [top]
Return a subsystem alert
Input Name Range Type Description
alert-id string
Alert identification.
alerting-resource string
Unique name of resource that generated the alert.
desired-attributes diagnosis-alert-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
monitor hm-type
Type of health monitor (e.g. node_connect, system_connect, system).
node string
Node hosting this health monitor.
 
Output Name Range Type Description
attributes diagnosis-alert-info
The attributes of the Alert Information.
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
diagnosis-alert-get-iter [top]
Iterate over a list of Alert Information objects.
Input Name Range Type Description
desired-attributes diagnosis-alert-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
max-records [1..100] integer
optional
The maximum number of records to return in this call. Default: 20
query diagnosis-alert-info
optional
A query that specifies which objects to return. A query could be specified on any number of attributes in the Alert Information object. All Alert Information objects matching this query up to 'max-records' will be returned.
tag string
optional
Specify the tag from the last call. It is usually not specified for the first call. For subsequent calls, copy values from the 'next-tag' obtained from the previous call.
 
Output Name Range Type Description
attributes-list diagnosis-alert-info[]
optional
The list of attributes of Alert Information objects.
next-tag string
optional
Tag for the next call. Not present when there are no more Alert Information objects to return.
num-records [0..100] integer
The number of records returned in this call.
 Errno  Description
 EINTERNALERROR

 
diagnosis-alert-modify [top]
Acknowledge/suppress an alert
Input Name Range Type Description
acknowledge boolean
optional
Acknowledge the alert condition.
acknowledger string
optional
Person who acknowledged this alert
alert-id string
Alert identification.
alerting-resource string
Unique name of resource that generated the alert.
monitor hm-type
Type of health monitor (e.g. node_connect, system_connect, system).
node string
Node hosting this health monitor.
suppress boolean
optional
Suppress this alert.
suppressor string
optional
Person who suppressed this alert
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
diagnosis-config-get [top]
Return the system health framework configuration
Input Name Range Type Description
desired-attributes diagnosis-config-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
monitor hm-type
Type of health monitor (e.g. node_connect, system_connect, system).
node string
Node hosting this health monitor.
 
Output Name Range Type Description
attributes diagnosis-config-info
The attributes of the Health Monitor Configuration.
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
diagnosis-config-get-iter [top]
Iterate over a list of Health Monitor Configuration objects.
Input Name Range Type Description
desired-attributes diagnosis-config-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
max-records [1..100] integer
optional
The maximum number of records to return in this call. Default: 20
query diagnosis-config-info
optional
A query that specifies which objects to return. A query could be specified on any number of attributes in the Health Monitor Configuration object. All Health Monitor Configuration objects matching this query up to 'max-records' will be returned.
tag string
optional
Specify the tag from the last call. It is usually not specified for the first call. For subsequent calls, copy values from the 'next-tag' obtained from the previous call.
 
Output Name Range Type Description
attributes-list diagnosis-config-info[]
optional
The list of attributes of Health Monitor Configuration objects.
next-tag string
optional
Tag for the next call. Not present when there are no more Health Monitor Configuration objects to return.
num-records [0..100] integer
The number of records returned in this call.
 Errno  Description
 EINTERNALERROR

 
diagnosis-delete-alert [top]
Delete subsystem alert
Input Name Range Type Description
alert-id string
Alert identification.
alerting-resource string
Unique name of resource that generated the alert.
monitor hm-type
Type of health monitor (e.g. node_connect, system_connect, system).
node string
Node hosting this health monitor.
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
diagnosis-policy-definition-get [top]
Return policy definition
Input Name Range Type Description
desired-attributes diagnosis-policy-definition-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
monitor hm-type
Type of health monitor (e.g. node_connect, system_connect, system).
node string
Node hosting this health monitor.
policy-id string
Policy identifier.
 
Output Name Range Type Description
attributes diagnosis-policy-definition-info
The attributes of the Policy Definition.
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
diagnosis-policy-definition-get-iter [top]
Iterate over a list of Policy Definition objects.
Input Name Range Type Description
desired-attributes diagnosis-policy-definition-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
max-records [1..100] integer
optional
The maximum number of records to return in this call. Default: 20
query diagnosis-policy-definition-info
optional
A query that specifies which objects to return. A query could be specified on any number of attributes in the Policy Definition object. All Policy Definition objects matching this query up to 'max-records' will be returned.
tag string
optional
Specify the tag from the last call. It is usually not specified for the first call. For subsequent calls, copy values from the 'next-tag' obtained from the previous call.
 
Output Name Range Type Description
attributes-list diagnosis-policy-definition-info[]
optional
The list of attributes of Policy Definition objects.
next-tag string
optional
Tag for the next call. Not present when there are no more Policy Definition objects to return.
num-records [0..100] integer
The number of records returned in this call.
 Errno  Description
 EINTERNALERROR

 
diagnosis-policy-modify [top]
Enable/disable policy
Input Name Range Type Description
enable boolean
optional
Enable/disable this policy.
monitor hm-type
Type of health monitor (e.g. node_connect, system_connect, system).
node string
Node hosting this health monitor.
policy-id string
Policy identifier.
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
diagnosis-status-get [top]
Return the overall system health
Input Name Range Type Description
desired-attributes diagnosis-status
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
 
Output Name Range Type Description
attributes diagnosis-status
The attributes of the System Health Status.
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
diagnosis-subscriptions-create [top]
Create a new Subscriptions for Notifications.
Input Name Range Type Description
class-name string
Class name of changed resource.
event-type hm-event-type
Type of event (rm-add, rm-del, rm-mod) for which notification is to be generated.
fail-thresh [0..2^32-1] integer
optional
Failure threshold for notification.
instance-name string
optional
Instance name of changed resource.
max-notify-period [0..65535] integer
optional
Maximum expected time for Notification to complete.
monitor hm-type
Type of source health monitor (e.g. node_connect, system_connect, system).
node string
Node hosting this health monitor and sends out notifications
notify-dest-hm hm-type
Health monitor subsribing for notification.
notify-dest-node node-name
Node hosting the health monitor that is subscribing for notification.
notify-table string
optional
Table name for DSMF notification.
psc-option boolean
optional
Enable/Disable periodic status confirmation.
return-record boolean
optional
If set to true, returns the Subscriptions for Notifications on successful creation. Default: false
subscription-id string
Subscription identifier.
time-gap-notify [0..65535] integer
optional
Time Period between two notifications.
 
Output Name Range Type Description
result diagnosis-subscriptions-info
optional
The Subscriptions for Notifications created (keys or the entire object if requested)
 Errno  Description
 EINTERNALERROR

 
diagnosis-subscriptions-get [top]
Return system health subscription
Input Name Range Type Description
class-name string
Class name of changed resource.
desired-attributes diagnosis-subscriptions-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
event-type hm-event-type
Type of event (rm-add, rm-del, rm-mod) for which notification is to be generated.
monitor hm-type
Type of source health monitor (e.g. node_connect, system_connect, system).
node string
Node hosting this health monitor and sends out notifications
notify-dest-hm hm-type
Health monitor subsribing for notification.
notify-dest-node node-name
Node hosting the health monitor that is subscribing for notification.
subscription-id string
Subscription identifier.
 
Output Name Range Type Description
attributes diagnosis-subscriptions-info
The attributes of the Subscriptions for Notifications.
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
diagnosis-subscriptions-get-iter [top]
Iterate over a list of Subscriptions for Notifications objects.
Input Name Range Type Description
desired-attributes diagnosis-subscriptions-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
max-records [1..100] integer
optional
The maximum number of records to return in this call. Default: 20
query diagnosis-subscriptions-info
optional
A query that specifies which objects to return. A query could be specified on any number of attributes in the Subscriptions for Notifications object. All Subscriptions for Notifications objects matching this query up to 'max-records' will be returned.
tag string
optional
Specify the tag from the last call. It is usually not specified for the first call. For subsequent calls, copy values from the 'next-tag' obtained from the previous call.
 
Output Name Range Type Description
attributes-list diagnosis-subscriptions-info[]
optional
The list of attributes of Subscriptions for Notifications objects.
next-tag string
optional
Tag for the next call. Not present when there are no more Subscriptions for Notifications objects to return.
num-records [0..100] integer
The number of records returned in this call.
 Errno  Description
 EINTERNALERROR

 
diagnosis-subscriptions-modify [top]
Modify system health subscription
Input Name Range Type Description
class-name string
Class name of changed resource.
event-type hm-event-type
Type of event (rm-add, rm-del, rm-mod) for which notification is to be generated.
fail-thresh [0..2^32-1] integer
optional
Failure threshold for notification.
instance-name string
optional
Instance name of changed resource.
max-notify-period [0..65535] integer
optional
Maximum expected time for Notification to complete.
monitor hm-type
Type of source health monitor (e.g. node_connect, system_connect, system).
node string
Node hosting this health monitor and sends out notifications
notify-dest-hm hm-type
Health monitor subsribing for notification.
notify-dest-node node-name
Node hosting the health monitor that is subscribing for notification.
notify-table string
optional
Table name for DSMF notification.
psc-option boolean
optional
Enable/Disable periodic status confirmation.
subscription-id string
Subscription identifier.
time-gap-notify [0..65535] integer
optional
Time Period between two notifications.
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
Element definition: diagnosis-alert-definition-info [top]
System Health Alert Definition When returned as part of the output, all elements of this typedef are reported, unless limited by a set of desired attributes specified by the caller.

When used as input to specify desired attributes to return, omitting a given element indicates that it shall not be returned in the output. In contrast, by providing an element (even with no value) the caller ensures that a value for that element will be returned, given that the value can be retrieved.

When used as input to specify queries, any element can be omitted in which case the resulting set of objects is not constrained by any specific value of that attribute.

Name Range Type Description
additional-information string
optional
Additional information about the alert. Attributes: non-creatable, non-modifiable
alert-id string
optional
Alert identification. Attributes: key, non-creatable, non-modifiable
alert-type hm-alert-type
optional
Type of alert (other,communications,quality-of-service,processing-error,device,environmental,model-change,security). Attributes: non-creatable, non-modifiable
corrective-actions string
optional
Recommended actions to correct the problem reported by alert. Attributes: non-creatable, non-modifiable
monitor hm-type
optional
Type of health monitor (e.g. node_connect, system_connect, system). Attributes: key, non-creatable, non-modifiable
node string
optional
Node hosting this health monitor. Attributes: key, non-creatable, non-modifiable
perceived-severity hm-perceived-sev
optional
Severity of alert (Unknown,Other,Information,Degraded,Minor,Major,Critical,Fatal). Attributes: non-creatable, non-modifiable
possible-effect string
optional
Detailed description of the possible effect of the condition. Attributes: non-creatable, non-modifiable
probable-cause hm-probable-cause
optional
Probable cause for alert generation. Attributes: non-creatable, non-modifiable
probable-cause-description string
optional
Detailed description of probable cause for alert generation. Attributes: non-creatable, non-modifiable
subsystem hm-subsystem
optional
Type of subsystem being monitored (e.g. sas_connect). Attributes: non-creatable, non-modifiable

 
Element definition: diagnosis-alert-info [top]
System Health Alert When returned as part of the output, all elements of this typedef are reported, unless limited by a set of desired attributes specified by the caller.

When used as input to specify desired attributes to return, omitting a given element indicates that it shall not be returned in the output. In contrast, by providing an element (even with no value) the caller ensures that a value for that element will be returned, given that the value can be retrieved.

When used as input to specify queries, any element can be omitted in which case the resulting set of objects is not constrained by any specific value of that attribute.

Name Range Type Description
acknowledge boolean
optional
Acknowledge the alert condition. Attributes: non-creatable, modifiable
acknowledger string
optional
Person who acknowledged this alert Attributes: non-creatable, modifiable
additional-info string[]
optional
Additional information from the resource that generated this alert Attributes: non-creatable, non-modifiable
alert-id string
optional
Alert identification. Attributes: key, non-creatable, non-modifiable
alerting-resource string
optional
Unique name of resource that generated the alert. Attributes: key, non-creatable, non-modifiable
alerting-resource-name string
optional
Display name of resource that generated the alert. Attributes: non-creatable, non-modifiable
corrective-actions string
optional
Recommended actions to correct the problem reported by alert. Attributes: non-creatable, non-modifiable
indication-time date
optional
Time of alert generation. Attributes: non-creatable, non-modifiable
monitor hm-type
optional
Type of health monitor (e.g. node_connect, system_connect, system). Attributes: key, non-creatable, non-modifiable
node string
optional
Node hosting this health monitor. Attributes: key, non-creatable, non-modifiable
perceived-severity hm-perceived-sev
optional
Severity of alert. Attributes: non-creatable, non-modifiable
policy string
optional
Policy rule responsible for creating this alert. Attributes: non-creatable, non-modifiable
possible-effect string
optional
Possible effect seen due to this problem. Attributes: non-creatable, non-modifiable
probable-cause hm-probable-cause
optional
Probable cause for alert generation. Attributes: non-creatable, non-modifiable
probable-cause-description string
optional
Detailed description of probable cause for alert generation. Attributes: non-creatable, non-modifiable
subsystem hm-subsystem
optional
Type of subsystem being monitored (e.g. sas_connect). Attributes: non-creatable, non-modifiable
suppress boolean
optional
Suppress this alert. Attributes: non-creatable, modifiable
suppressor string
optional
Person who suppressed this alert Attributes: non-creatable, modifiable

 
Element definition: diagnosis-config-info [top]
System Health Config When returned as part of the output, all elements of this typedef are reported, unless limited by a set of desired attributes specified by the caller.

When used as input to specify desired attributes to return, omitting a given element indicates that it shall not be returned in the output. In contrast, by providing an element (even with no value) the caller ensures that a value for that element will be returned, given that the value can be retrieved.

When used as input to specify queries, any element can be omitted in which case the resulting set of objects is not constrained by any specific value of that attribute.

Name Range Type Description
aggregator hm-type
optional
Aggregating health monitor that aggregates status from this health monitor. Attributes: non-creatable, non-modifiable
context hm-scope
optional
Scope of health monitor (node-context, cluster-context). Attributes: non-creatable, non-modifiable
health hm-status
optional
Status of health monitor (ok, ok-with-suppressed, degraded). Attributes: non-creatable, non-modifiable
mon-version string
optional
Health Monitor version. Attributes: non-creatable, non-modifiable
monitor hm-type
optional
Type of health monitor (e.g. node_connect, system_connect, system). Attributes: key, non-creatable, non-modifiable
node string
optional
Node hosting this health monitor. Attributes: key, non-creatable, non-modifiable
pol-version string
optional
Policy file version. Attributes: non-creatable, non-modifiable
resources string[]
optional
Resources monitored by this health monitor. Attributes: non-creatable, non-modifiable
sub-pol-versions string
optional
Subordinate policy file versions. Attributes: non-creatable, non-modifiable
subsystem hm-subsystem[]
optional
Type of subsystem being monitored (e.g. sas_connect). Attributes: non-creatable, non-modifiable

 
Element definition: diagnosis-policy-definition-info [top]
System Health Policy Definition When returned as part of the output, all elements of this typedef are reported, unless limited by a set of desired attributes specified by the caller.

When used as input to specify desired attributes to return, omitting a given element indicates that it shall not be returned in the output. In contrast, by providing an element (even with no value) the caller ensures that a value for that element will be returned, given that the value can be retrieved.

When used as input to specify queries, any element can be omitted in which case the resulting set of objects is not constrained by any specific value of that attribute.

Name Range Type Description
alert-count [0..2^32-1] integer
optional
Count of alerts created as a result of this policy. Attributes: non-creatable, non-modifiable
alert-id string
optional
Alert identifier for alert to be generated on policy rule match. Attributes: non-creatable, non-modifiable
creation-time datetime
optional
Time when the previous alert was created due to this policy. Attributes: non-creatable, non-modifiable
enable boolean
optional
Enable/disable this policy. Attributes: non-creatable, modifiable
monitor hm-type
optional
Type of health monitor (e.g. node_connect, system_connect, system). Attributes: key, non-creatable, non-modifiable
node string
optional
Node hosting this health monitor. Attributes: key, non-creatable, non-modifiable
policy-id string
optional
Policy identifier. Attributes: key, non-creatable, non-modifiable
responsible-resource-info string
optional
The resource responsible for creating this alert Attributes: non-creatable, non-modifiable
rule-expression string
optional
Arithmetic expression which defines alerts to be created as a result of this policy. Attributes: non-creatable, non-modifiable
where string
optional
Where clause of Arithmetic expression. Attributes: non-creatable, non-modifiable

 
Element definition: diagnosis-status [top]
System Health Status When returned as part of the output, all elements of this typedef are reported, unless limited by a set of desired attributes specified by the caller.

When used as input to specify desired attributes to return, omitting a given element indicates that it shall not be returned in the output. In contrast, by providing an element (even with no value) the caller ensures that a value for that element will be returned, given that the value can be retrieved.

When used as input to specify queries, any element can be omitted in which case the resulting set of objects is not constrained by any specific value of that attribute.

Name Range Type Description
status hm-status
optional
Overall system health (ok,ok-with-suppressed,degraded,unreachable) as determined by the diagnosis framework. Attributes: non-creatable, non-modifiable

 
Element definition: diagnosis-subscriptions-info [top]
System Health Subscriptions When returned as part of the output, all elements of this typedef are reported, unless limited by a set of desired attributes specified by the caller.

When used as input to specify desired attributes to return, omitting a given element indicates that it shall not be returned in the output. In contrast, by providing an element (even with no value) the caller ensures that a value for that element will be returned, given that the value can be retrieved.

When used as input to specify queries, any element can be omitted in which case the resulting set of objects is not constrained by any specific value of that attribute.

Name Range Type Description
class-name string
optional
Class name of changed resource. Attributes: key, required-for-create, non-modifiable
creation-time datetime
optional
Time at which this subscription was created. Attributes: non-creatable, non-modifiable
event-type hm-event-type
optional
Type of event (rm-add, rm-del, rm-mod) for which notification is to be generated. Attributes: key, required-for-create, non-modifiable
fail-thresh [0..2^32-1] integer
optional
Failure threshold for notification. Attributes: optional-for-create, modifiable
instance-name string
optional
Instance name of changed resource. Attributes: optional-for-create, modifiable
max-notify-period [0..65535] integer
optional
Maximum expected time for Notification to complete. Attributes: optional-for-create, modifiable
monitor hm-type
optional
Type of source health monitor (e.g. node_connect, system_connect, system). Attributes: key, required-for-create, non-modifiable
node string
optional
Node hosting this health monitor and sends out notifications Attributes: key, non-creatable, non-modifiable
notify-dest-hm hm-type
optional
Health monitor subsribing for notification. Attributes: key, required-for-create, non-modifiable
notify-dest-node node-name
optional
Node hosting the health monitor that is subscribing for notification. Attributes: key, required-for-create, non-modifiable
notify-fptr [0..2^64-1] integer
optional
Function pointer to be invoked. Attributes: non-creatable, non-modifiable
notify-table string
optional
Table name for DSMF notification. Attributes: optional-for-create, modifiable
notify-type hm-notify-type
optional
Type of notification (dsmf-type, fptr-type). Attributes: non-creatable, non-modifiable
psc-option boolean
optional
Enable/Disable periodic status confirmation. Attributes: optional-for-create, modifiable
subscription-id string
optional
Subscription identifier. Attributes: key, required-for-create, non-modifiable
time-gap-notify [0..65535] integer
optional
Time Period between two notifications. Attributes: optional-for-create, modifiable

 
Element definition: hm-event-type [top]
Event type
[none]

 
Element definition: hm-type [top]
Type of Health Monitor
[none]

 
Element definition: node-name [top]
The node's name
[none]

 
Element definition: date [top]
Date (in seconds since Jan. 1, 1970 12:00:00) Range : [0..2^31-1].
[none]

 
Element definition: datetime [top]
The number of seconds since January 1, 1970. Range : [0..2^31-1].
[none]

 
Element definition: hm-alert-type [top]
Type of alert
[none]

 
Element definition: hm-notify-type [top]
Notify type
[none]

 
Element definition: hm-perceived-sev [top]
Alert severity
[none]

 
Element definition: hm-probable-cause [top]
Probable cause for alert generation
[none]

 
Element definition: hm-scope [top]
Node or Cluster context of Health Monitor
[none]

 
Element definition: hm-status [top]
Health Monitor Status
[none]

 
Element definition: hm-subsystem [top]
Health Monitor Subsystem
[none]