APIs in Category: Dfm
API version 5.0

 
DfmAbout
DfmBackupScheduleDisable
DfmBackupScheduleEnable
DfmBackupScheduleGet
DfmBackupScheduleSet
DfmBackupStart
DfmBackupStatus
DfmGetApiStatistics
DfmGetResourcePropertyValues
DfmMonitorTimestampList
DfmObjectRefresh
DfmObjectsGetStatus
DfmRelatedObjectsListInfo
DfmServerListDiagnosticInfo
DfmSnmpSettingAdd
DfmSnmpSettingDelete
DfmSnmpSettingModify
DfmSnmpSettingsListInfo
DfmUserPrivGet

NetApp Manage ONTAP API version 5.0
 
DfmAbout (supported) [top]

Retrieve information currently provided by the 'dfm about' command.
Input Name Type
DfmAbout DfmAbout
 
Output Name Type
DfmAboutResult DfmAboutResult
 Error Name  Description
 EAPIPRIVILEDGE

 
DfmBackupScheduleDisable (supported) [top]
Disable an existing backup schedule.
Input Name Type
DfmBackupScheduleDisable DfmBackupScheduleDisable
 
Output Name Type
DfmBackupScheduleDisableResult DfmBackupScheduleDisableResult
 Error Name  Description
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR

 
DfmBackupScheduleEnable (supported) [top]
Enable an existing backup schedule.
Input Name Type
DfmBackupScheduleEnable DfmBackupScheduleEnable
 
Output Name Type
DfmBackupScheduleEnableResult DfmBackupScheduleEnableResult
 Error Name  Description
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR

 
DfmBackupScheduleGet (supported) [top]
Get the information about a DFM database backup schedule.
Input Name Type
DfmBackupScheduleGet DfmBackupScheduleGet
 
Output Name Type
DfmBackupScheduleGetResult DfmBackupScheduleGetResult
 Error Name  Description
 EACCESSDENIED
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR

 
DfmBackupScheduleSet (supported) [top]
API To configure DFM database backup schedules. A schedule can be of 'Snapshot' or 'archive' Type backup. Archive Backups can be scheduled at 'daily' or 'weekly' Period. Snapshot Backups can be scheduled at 'hourly', 'daily' or 'weekly' Period or everyday at regular intervals starting From a specified time. Hourly Backups require the 'Minute' at which the backup schedule is To run every Hour. Daily backup schedule requires 'Hour' and 'Minute' at which the backup schedule is To run. Weekly backup schedule requires the Day of the week and time (hh:mm) at which the backup schedule is To run. A backup schedule can also be set To run every Day at regular hourly repeat intervals starting From a specified Hour:Minute. Only one schedule can be set for creating DFM Backups.
Input Name Type
DfmBackupScheduleSet DfmBackupScheduleSet
 
Output Name Type
DfmBackupScheduleSetResult DfmBackupScheduleSetResult
 Error Name  Description
 EACCESSDENIED
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR
 EINVALIDINPUT

 
DfmBackupStart (supported) [top]
API To start a database backup immediately.
Input Name Type
DfmBackupStart DfmBackupStart
 
Output Name Type
DfmBackupStartResult DfmBackupStartResult
 Error Name  Description
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR
 EINVALIDINPUT

 
DfmBackupStatus (supported) [top]
Get information about a DFM database backup.
Input Name Type
DfmBackupStatus DfmBackupStatus
 
Output Name Type
DfmBackupStatusResult DfmBackupStatusResult
 Error Name  Description
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR

 
DfmGetApiStatistics (supported) [top]
Retrieve information about the API call frequencies on the DFM server
Input Name Type
DfmGetApiStatistics DfmGetApiStatistics
 
Output Name Type
DfmGetApiStatisticsResult DfmGetApiStatisticsResult
 Error Name  Description
 EAPIPRIVILEDGE

 
DfmGetResourcePropertyValues (supported) [top]
Gets the list of Resource Properties and the Values that can be set as filters for Thresholds. The list of Resource Properties are pre-defined, but the Values are obtained From the current set of Values in the database
Input Name Type
DfmGetResourcePropertyValues DfmGetResourcePropertyValues
 
Output Name Type
DfmGetResourcePropertyValuesResult DfmGetResourcePropertyValuesResult
 Error Name  Description
 EACCESSDENIED
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR

 
DfmMonitorTimestampList (supported) [top]
Returns the monitoring timestamps of a Host.
Input Name Type
DfmMonitorTimestampList DfmMonitorTimestampList
 
Output Name Type
DfmMonitorTimestampListResult DfmMonitorTimestampListResult
 Error Name  Description
 EACCESSDENIED
 EAPIAUTHENTICATION
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR
 EINVALIDINPUT
 EOBJECTAMBIGUOUS
 EOBJECTNOTFOUND

 
DfmObjectRefresh (supported) [top]
Request monitors be scheduled To run To refresh the information of the object specified. The monitors To be scheduled To run can be specified implicitly using ChildType or explicitly by providing MonitorNames. If both ChildType and MonitorNames are specified, it will be treated as an Error.
Input Name Type
DfmObjectRefresh DfmObjectRefresh
 
Output Name Type
DfmObjectRefreshResult DfmObjectRefreshResult
 Error Name  Description
 EACCESSDENIED
 EDATABASEERROR
 EINTERNALERROR
 EINVALIDINPUT
 EOBJECTAMBIGUOUS
 EOBJECTNOTFOUND

 
DfmObjectsGetStatus (supported) [top]
Get Status for DFM Objects This api always returns true. It returns the Status for all the Objects that are passed in. A ObjectNameOrId of "0" indicates the "global Group" Privelege required is read
Input Name Type
DfmObjectsGetStatus DfmObjectsGetStatus
 
Output Name Type
DfmObjectsGetStatusResult DfmObjectsGetStatusResult
 Error Name  Description
 EACCESSDENIED
 EAPIERROR
 EAPILICENSE
 EAPIPRIVILEDGE
 EDATABASEERROR
 EINVALIDINPUT
 EOBJECTAMBIGUOUS
 EOBJECTNOTFOUND

 
DfmRelatedObjectsListInfo (supported) [top]
Retrieve information about Objects related To a DFM object. This api takes an object as input and returns the information about parent Objects of that object, Resource Groups, Datasets and Resource pools the object belongs To and Objects that belong To the specified object. Privilege required is DFM.Database.Read on the specified object. Parent output Objects are returned only if the authenticated user has DFM.Database.Read Privilege on that parent object. For e.g. Group To which an object belongs is returned only if the authenticated user has DFM.Database.Read Privilege on that Group.
Input Name Type
DfmRelatedObjectsListInfo DfmRelatedObjectsListInfo
 
Output Name Type
DfmRelatedObjectsListInfoResult DfmRelatedObjectsListInfoResult
 Error Name  Description
 EACCESSDENIED
 EAPIERROR
 EAPIPRIVILEDGE
 EDATABASEERROR
 EINTERNALERROR
 EOBJECTNOTFOUND

 
DfmServerListDiagnosticInfo (supported) [top]
Retrieve server diagnostic information
Input Name Type
DfmServerListDiagnosticInfo DfmServerListDiagnosticInfo
 
Output Name Type
DfmServerListDiagnosticInfoResult DfmServerListDiagnosticInfoResult
 Error Name  Description
 EAPIPRIVILEDGE

 
DfmSnmpSettingAdd (supported) [top]
Add a SNMP credential setttings for a Host or network in dfm. This credential will be used when discovering Networks in dfm.
Input Name Type
DfmSnmpSettingAdd DfmSnmpSettingAdd
 
Output Name Type
DfmSnmpSettingAddResult DfmSnmpSettingAddResult
 Error Name  Description
 EACCESSDENIED
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR
 EINVALIDINPUT

 
DfmSnmpSettingDelete (supported) [top]
Delete Networks From dfm so that discovery should not happen. Either SnmpId or both NetworkAddress and PrefixLength has To be provided. If the user provides both or does not provide any, it will be considered as invalid input.
Input Name Type
DfmSnmpSettingDelete DfmSnmpSettingDelete
 
Output Name Type
DfmSnmpSettingDeleteResult DfmSnmpSettingDeleteResult
 Error Name  Description
 EACCESSDENIED
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR
 EINVALIDINPUT

 
DfmSnmpSettingModify (supported) [top]
Modify SNMP credential in dfm so that network discovery should happen using new SNMP credential.
Input Name Type
DfmSnmpSettingModify DfmSnmpSettingModify
 
Output Name Type
DfmSnmpSettingModifyResult DfmSnmpSettingModifyResult
 Error Name  Description
 EACCESSDENIED
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR
 EINVALIDINPUT

 
DfmSnmpSettingsListInfo (supported) [top]
Returns list of SNMP credential settings available in the dfm database Either SnmpId or both NetworkAddress and PrefixLength has To be provided. If user provides both, it will be considered as invalid input. If user does not provide any, then all the snmp credentials will be returned.
Input Name Type
DfmSnmpSettingsListInfo DfmSnmpSettingsListInfo
 
Output Name Type
DfmSnmpSettingsListInfoResult DfmSnmpSettingsListInfoResult
 Error Name  Description
 EACCESSDENIED
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR
 EINVALIDINPUT

 
DfmUserPrivGet (supported) [top]
Retrieve current user's global Privilege. This api is no longer the preferred way To getting user privileges. Use RbacAccessCheck.
Input Name Type
DfmUserPrivGet DfmUserPrivGet
 
Output Name Type
DfmUserPrivGetResult DfmUserPrivGetResult
 Error Name  Description
 ENAMENOTFOUND

 
Element definition: DfmAbout [top]
Retrieve information currently provided by the 'dfm about' command.
Name Type Description
IncludeDirectorySizeInfo xsd:boolean
optional
If true, then Size and file Count information of the DFM Directories is returned. Default Value is false i.e. only names of the DFM Directories are returned.

 
Element definition: DfmAboutResult [top]
Name Type Description
CpuCount xsd:string
CPU Count.
DfmDirectories ArrayOfDirectoryInfo
CPU Count.
Edition xsd:string
Edition of this product. Possible Values are 'Express Edition' and 'Standard Edition' with product Name appened.
HostName xsd:string
Host Name.
InstallDir xsd:string
Installation Directory.
InstalledPlugins ArrayOfPlugin
Installation Directory.
LicensedFeatures ArrayOfFeature
Installation Directory.
NodeLimit xsd:string
Operations Manager Node limit.
OperatingSystem xsd:string
Operating system.
ProtMgrNodeLimit xsd:string
Protection Manager Node limit.
ProvMgrNodeLimit xsd:string
Provisioning Manager Node limit.
SerialNumber xsd:string
serial number of this product.
SystemMemory xsd:string
System memory.
SystemTime xsd:integer
System time in seconds since 00:00:00 Jan 1, 1970, UTC.
Version xsd:string
A string that adheres To the following regular expression: [1-9][0-9]+\.[1-9][0-9]+.* The first number is the DFM major Version. The second number is the DFM minor Version. DFM APIs don't change if the major.minor doesn't change. Example: 3.5.0.4726

 
Element definition: DfmBackupScheduleDisable [top]
Disable an existing backup schedule.
[none]

 
Element definition: DfmBackupScheduleDisableResult [top]
[none]

 
Element definition: DfmBackupScheduleEnable [top]
Enable an existing backup schedule.
[none]

 
Element definition: DfmBackupScheduleEnableResult [top]
[none]

 
Element definition: DfmBackupScheduleGet [top]
Get the information about a DFM database backup schedule.
[none]

 
Element definition: DfmBackupScheduleGetResult [top]
Name Type Description
BackupType BackupType
Scheduled DFM database backup Type.
Day xsd:integer
optional
The Day of the week on which the backup schedule has To run at the specified Hour:Minute time. This is optional when the ScheduleType is 'weekly'. The Day starts with Sunday. The Days are enumerated with Sunday=0, Monday=1 and so on. Range: [0..6]
Hour xsd:integer
optional
The Hour of a Day at which the backup schedule runs. This is optional only for the 'Snapshot' Type Backups set at 'hourly' Period. Range: [0..23]
IsScheduleEnabled xsd:boolean
true if the backup schedule is enabled, false otherwise.
Minute xsd:integer
The Minute of an Hour at which the backup schedule runs. Range: [0..59]
RepeatInterval xsd:integer
optional
The hourly Interval at which 'Snapshot' based Backups recur. This is applicable for 'Snapshot' Type Backups having 'daily' ScheduleType. Range: [1..24]
ScheduleType xsd:string
The Period at which the backup schedule has runs. Possible Values are 'hourly', 'daily' or 'weekly'.

 
Element definition: DfmBackupScheduleSet [top]
API To configure DFM database backup schedules. A schedule can be of 'Snapshot' or 'archive' Type backup. Archive Backups can be scheduled at 'daily' or 'weekly' Period. Snapshot Backups can be scheduled at 'hourly', 'daily' or 'weekly' Period or everyday at regular intervals starting From a specified time. Hourly Backups require the 'Minute' at which the backup schedule is To run every Hour. Daily backup schedule requires 'Hour' and 'Minute' at which the backup schedule is To run. Weekly backup schedule requires the Day of the week and time (hh:mm) at which the backup schedule is To run. A backup schedule can also be set To run every Day at regular hourly repeat intervals starting From a specified Hour:Minute. Only one schedule can be set for creating DFM Backups.
Name Type Description
BackupType BackupType
optional
Default backup Type is 'archive'.
Day xsd:integer
optional
The Day of the week on which the backup schedule has To run at the specified Hour:Minute time. Required for weekly schedule Type. Not allowed for hourly and daily schedule Type. The Day starts with Sunday. The Days are enumerated with Sunday=0, Monday=1 and so on. Range: [0..6]
Hour xsd:integer
optional
The Hour of a Day at which the backup schedule has To run. Required for daily or weekly schedule Type. Not allowed for hourly schedule Type. Range: [0..23]
IsScheduleEnabled xsd:boolean
optional
Indicates whether the backup schedule has To be enabled or disabled after setting. Default Value is true.
Minute xsd:integer
optional
The Minute of an Hour at which the backup schedule has To run. Default Value is 0. Range: [0..59]
RepeatInterval xsd:integer
optional
The hourly Interval at which 'Snapshot' based Backups have To recur starting at Hour:Minute. This is applicable only for 'Snapshot' Type Backups. Range: [1..24]
ScheduleType xsd:string
The Period at which the backup schedule has To run. Possible Values are 'hourly', 'daily', 'weekly'.

 
Element definition: DfmBackupScheduleSetResult [top]
[none]

 
Element definition: DfmBackupStart [top]
API To start a database backup immediately.
Name Type Description
BackupType BackupType
Type of DFM database backup To initiate a backup.

 
Element definition: DfmBackupStartResult [top]
[none]

 
Element definition: DfmBackupStatus [top]
Get information about a DFM database backup.
[none]

 
Element definition: DfmBackupStatusResult [top]
Name Type Description
BackupStatus xsd:string
Status of the database backup. Possible Values are: 'running': when backup job is running; applicable for both immediate and scheduled Backups. 'pending': when backup job is scheduled, but yet To start; applicable only for immediate backup started with DfmBackupStart. 'schedule_active': backup schedule is set and enabled; applicable for scheduled backup only. 'schedule_inactive': backup schedule is set and disabled; applicable for scheduled backup only. 'not_scheduled': when a schedule is not set; applicable for scheduled backup only.

 
Element definition: DfmGetApiStatistics [top]
Retrieve information about the API call frequencies on the DFM server
Name Type Description
ClearApiStats xsd:boolean
optional
If present and true, reset all the API statistics. Default Value is false.

 
Element definition: DfmGetApiStatisticsResult [top]
Name Type Description
ApiStatistics ArrayOfApiStat
Lists the statistics about the API call frequencies on the DFM server.

 
Element definition: DfmGetResourcePropertyValues [top]
Gets the list of Resource Properties and the Values that can be set as filters for Thresholds. The list of Resource Properties are pre-defined, but the Values are obtained From the current set of Values in the database
Name Type Description
ResourceProperty xsd:string
optional
Specifies the property for which the Values are To be returned If not present, then Resource Values for all Properties are returned Maximum Length of 255 characters

 
Element definition: DfmGetResourcePropertyValuesResult [top]
Name Type Description
ResourcePropertyValues ArrayOfResourcePropertyValues
The Values for the Resource Properties

 
Element definition: DfmMonitorTimestampList [top]
Returns the monitoring timestamps of a Host.
Name Type Description
HostNameOrId ObjNameOrId
The Name or Id of the Host for which monitoring Timestamp is required. It should be Name or Id of a Host Agent, vFiler Unit, Storage System, Cluster or OSSV Host.

 
Element definition: DfmMonitorTimestampListResult [top]
Name Type Description
DfmMonitoringTimestamps ArrayOfDfmMonitoringTimestamp
List of all applicable monitoring timestamps.

 
Element definition: DfmObjectRefresh [top]
Request monitors be scheduled To run To refresh the information of the object specified. The monitors To be scheduled To run can be specified implicitly using ChildType or explicitly by providing MonitorNames. If both ChildType and MonitorNames are specified, it will be treated as an Error.
Name Type Description
ChildType xsd:string
optional
If specified, schedule only those monitors affecting the specified Type. Otherwise, all monitors affecting the ObjectNameOrId will be scheduled. Valid only if ObjectNameOrId points To a Storage System or a vFiler Unit. Possible Values: "Aggregate", "Volume", "Qtree" and "lun_path".
MonitorNames ArrayOfMonitorName
optional
Specifies one or more monitors To be scheduled To run. If this input is not provided, all monitors will be scheduled. Valid only if ObjectNameOrId points To a Host Agent, Storage System, vFiler Unit, OSSV Host or a NetCache.
ObjectNameOrId ObjNameOrId
The Name or Id of the object To be refreshed. Should be Name or Id of a Host Agent, Storage System, vFiler Unit, OSSV Host, Aggregate, Volume, Qtree, LUN or a NetCache. If ChildType is specified, this should be Name or Id of a Storage System or a vFiler Unit. If MonitorNames are specified, this should be Name or Id of a Host Agent, Storage System, vFiler Unit, OSSV Host or a NetCache.

 
Element definition: DfmObjectRefreshResult [top]
[none]

 
Element definition: DfmObjectsGetStatus [top]
Get Status for DFM Objects This api always returns true. It returns the Status for all the Objects that are passed in. A ObjectNameOrId of "0" indicates the "global Group" Privelege required is read
Name Type Description
Objects ArrayOfObjNameOrId
The Objects for which Status is To be retrieved

 
Element definition: DfmObjectsGetStatusResult [top]
Name Type Description
ObjectsStatus ArrayOfObjStatusInfo
Status of the passed in input Objects.

 
Element definition: DfmRelatedObjectsListInfo [top]
Retrieve information about Objects related To a DFM object. This api takes an object as input and returns the information about parent Objects of that object, Resource Groups, Datasets and Resource pools the object belongs To and Objects that belong To the specified object. Privilege required is DFM.Database.Read on the specified object. Parent output Objects are returned only if the authenticated user has DFM.Database.Read Privilege on that parent object. For e.g. Group To which an object belongs is returned only if the authenticated user has DFM.Database.Read Privilege on that Group.
Name Type Description
IncludeIndirect xsd:boolean
optional
If true, Resource Groups, Datasets and Resource pools in which the input object is an indirect member will also be returned. Default Value is false, i.e only direct memberships are returned.
ObjectNameOrId ObjNameOrId
Name or identifier of an object To list related Objects for. The allowed object types for this argument are:
  • Host
  • Aggregate
  • Volume
  • Qtree
  • Lun

 
Element definition: DfmRelatedObjectsListInfoResult [top]
Name Type Description
ChildCountList ArrayOfChildCount
optional
Count of children for the specified object. Present in the output if the object has at least one child.
ParentDatasetList ArrayOfParentDataset
optional
Datasets the specified object belongs To. Present in the output if the object belongs To at least one Dataset.
ParentGroupList ArrayOfParentGroup
optional
Resource Groups the specified object belongs To. Present in the output if the object belongs To at least one Group.
ParentObjectList ArrayOfParentObject
optional
Parents of the specified object. Present in the output if there is at least one parent object.
ParentResourcepoolList ArrayOfParentResourcepool
optional
Resource Pools the specified object belongs To. Present in the output if the object belongs To at least one Resource pool.

 
Element definition: DfmServerListDiagnosticInfo [top]
Retrieve server diagnostic information
[none]

 
Element definition: DfmServerListDiagnosticInfoResult [top]
Name Type Description
DiagInfo ArrayOfDfmDiagCounterGroup
Diagnostic information collected From the dfm server.

 
Element definition: DfmSnmpSettingAdd [top]
Add a SNMP credential setttings for a Host or network in dfm. This credential will be used when discovering Networks in dfm.
Name Type Description
HostName xsd:string
optional
The Name of the Host. This could be either short or fully qualified Host Name. Either this attribute or NetworkAddress must be provided. Error is returned if both are provided.
NetworkAddress NetworkAddress
optional
Ip Address of the network or Host
PrefixLength PrefixLength
It represents prefix Length. Useful for subnet mask calculation. This should be 32 for IPv4 and 128 for IPv6 if the NetworkAddress is a Host Address.
PrivacyPassword xsd:string
optional
Privacy Password used for encrypting SNMPv3 communication. This element is optional for the SNMP versions other than snmp_v3.
SnmpAuthenticationLogin xsd:string
optional
The Name of the user To be used for SNMPv3 discovery and monitoring. This element is optional for the SNMP versions other than snmp_v3.
SnmpAuthenticationPassword xsd:string
optional
The authentication Password To be used for SNMPv3 communication. Value must be a string greater than or equal To 8 characters. This element is optional for the SNMP versions other than snmp_v3.
SnmpAuthenticationProtocol SnmpAuthenticationProtocol
optional
Authentication Protocol for use with SNMPv3. This element is optional for the SNMP versions other than snmp_v3.
SnmpCommunityName xsd:string
optional
Name of the snmp community used for snmpv1 communication. This element is optional for the SNMP versions other than snmp_v1.
SnmpVersion SnmpVersion
optional
Represents snmp Version that will be used for discovering network.

 
Element definition: DfmSnmpSettingAddResult [top]
Name Type Description
SnmpId SnmpId
A UniqueId for this snmp credential setting will be returned.

 
Element definition: DfmSnmpSettingDelete [top]
Delete Networks From dfm so that discovery should not happen. Either SnmpId or both NetworkAddress and PrefixLength has To be provided. If the user provides both or does not provide any, it will be considered as invalid input.
Name Type Description
HostName xsd:string
optional
Name of the Host. It could be either short or fully qualified Host Name.
NetworkAddress NetworkAddress
optional
IP Address of the network or Host.
PrefixLength PrefixLength
optional
Prefix Length of the network or Host. This should be 32 for IPv4 and 128 for IPv6 if the NetworkAddress is a Host Address.
SnmpId SnmpId
optional
Unique indentifier of the SNMP credential setting in dfm. This Id will be generated when SNMP credential setting was added.

 
Element definition: DfmSnmpSettingDeleteResult [top]
[none]

 
Element definition: DfmSnmpSettingModify [top]
Modify SNMP credential in dfm so that network discovery should happen using new SNMP credential.
Name Type Description
PrefixLength PrefixLength
optional
It is prefix Length of network or Host, useful for subnet mask calculation. This cannot be modified for Hosts.
PrivacyPassword xsd:string
optional
Privacy Password used for encrypting SNMPv3 communication. This element is optional for the SNMP versions other than snmp_v3.
SnmpAuthenticationLogin xsd:string
optional
The Name of the user To be used for SNMPv3 discovery and monitoring. This element is optional for the SNMP versions other than snmp_v3.
SnmpAuthenticationPassword xsd:string
optional
The authentication Password To be used for SNMPv3 communication. Value must be a string greater than or equal To 8 characters. This element is optional for the SNMP versions other than snmp_v3.
SnmpAuthenticationProtocol SnmpAuthenticationProtocol
optional
Authentication Protocol for use with SNMPv3. This element is optional for the SNMP versions other than snmp_v3.
SnmpCommunityName xsd:string
optional
Name of the snmp community used for snmpv1 communication. This element is optional for the SNMP versions other than snmp_v1.
SnmpId SnmpId
Unique indentifier of the SNMP credential setting in dfm.
SnmpVersion SnmpVersion
optional
Represents snmp Version that will be used for discovering network.

 
Element definition: DfmSnmpSettingModifyResult [top]
[none]

 
Element definition: DfmSnmpSettingsListInfo [top]
Returns list of SNMP credential settings available in the dfm database Either SnmpId or both NetworkAddress and PrefixLength has To be provided. If user provides both, it will be considered as invalid input. If user does not provide any, then all the snmp credentials will be returned.
Name Type Description
HostName xsd:string
optional
The Name of the Host. This could be either short or fully qualified Host Name. This attribute and NetworkAddress must not be provided simultaneously. Error is returned if both are provided.
NetworkAddress xsd:string
optional
Ip Address of the network or Host.
PrefixLength xsd:integer
optional
It represents prefix Length. Useful for subnet mask calculation. This should be 32 for IPv4 and 128 for IPv6 if the NetworkAddress is a Host Address.
SnmpId SnmpId
optional
A unique Id representing the SNMP credential setting.

 
Element definition: DfmSnmpSettingsListInfoResult [top]
Name Type Description
NetworkSnmpCredentials ArrayOfNetworkSnmpCredentialInfo
The list of SNMP credential settings.

 
Element definition: DfmUserPrivGet [top]
Retrieve current user's global Privilege. This api is no longer the preferred way To getting user privileges. Use RbacAccessCheck.
[none]

 
Element definition: DfmUserPrivGetResult [top]
Name Type Description
Privilege xsd:string
User's Privilege(s), comma separated if there are multiple. Possible privileges are: FULL, DELETE, WRITE, READ, BACKUP, RESTORE, SAN, SRM, MIRROR.

 
Element definition: ArrayOfApiStat [top]
Name Type Description
ApiStat ApiStat[]

 
Element definition: ArrayOfChildCount [top]
Name Type Description
ChildCount ChildCount[]

 
Element definition: ArrayOfDfmDiagCounterGroup [top]
Name Type Description
DfmDiagCounterGroup DfmDiagCounterGroup[]

 
Element definition: ArrayOfDfmMonitoringTimestamp [top]
Name Type Description
DfmMonitoringTimestamp DfmMonitoringTimestamp[]

 
Element definition: ArrayOfDirectoryInfo [top]
Name Type Description
DirectoryInfo DirectoryInfo[]

 
Element definition: ArrayOfFeature [top]
Name Type Description
Feature Feature[]

 
Element definition: ArrayOfMonitorName [top]
Name Type Description
MonitorName MonitorName[]

 
Element definition: ArrayOfNetworkSnmpCredentialInfo [top]
Name Type Description
NetworkSnmpCredentialInfo NetworkSnmpCredentialInfo[]

 
Element definition: ArrayOfObjNameOrId [top]
Name Type Description
ObjNameOrId ObjNameOrId[]

 
Element definition: ArrayOfObjStatusInfo [top]
Name Type Description
ObjStatusInfo ObjStatusInfo[]

 
Element definition: ArrayOfParentDataset [top]
Name Type Description
ParentDataset ParentDataset[]

 
Element definition: ArrayOfParentGroup [top]
Name Type Description
ParentGroup ParentGroup[]

 
Element definition: ArrayOfParentObject [top]
Name Type Description
ParentObject ParentObject[]

 
Element definition: ArrayOfParentResourcepool [top]
Name Type Description
ParentResourcepool ParentResourcepool[]

 
Element definition: ArrayOfPlugin [top]
Name Type Description
Plugin Plugin[]

 
Element definition: ArrayOfResourcePropertyValues [top]
Name Type Description
ResourcePropertyValues ResourcePropertyValues[]

 
Element definition: BackupType [top]
Type of DFM database backup. Possible Values are 'archive' and 'Snapshot'. The 'archive' Type Backups are used when the data resides on a conventional disk. The 'Snapshot' Type Backups are used for data residing on a LUN.
[none]

 
Element definition: NetworkAddress [top]
IP Address of the network or Host
[none]

 
Element definition: ObjNameOrId [top]
Name or internal ID of a DFM object. This typedef is an alias for the builtin ZAPI Type string. An ObjNameOrId must contain between 1 and 64 characters, and must conform To one of the following formats:
  • It must have the format of an ObjName, or
  • It must be the decimal numeric string form of a positive integer whose Value is in the range [1..2^31 - 1].
  • In case of application resources From the Host Service, this field can contain unique identifier assigned To the object by the Host Service e.g. for a Virtual Machine, it can be a GUID of the VM. One exception is when such unique identifier is a decimal numeric string containing only digits From 0 through 9. In that case, you cannot use such identifier as ObjNameOrId input.
Elements of Type ObjNameOrId are used only as inputs To ZAPIs. The Value must Match either the Name or internal ID of an existing DFM object. The ZAPI must specify the object's DFM object Type (e.g. Dataset, Host, DP Policy, etc.). Some ZAPIs allow the object To be one of several different types.

If the format of an ObjNameOrId input element does not conform, or the Value does not Match the Name or ID of an existing object, then generally the ZAPI documents that it fails with Error code EOBJECTNOTFOUND. A ZAPI may return more specific Error codes. In such cases, the ZAPI specification must document its behavior.

If a ZAPI can accept a null Value (e.g. reference To no object at all) for such an element, then the element is declared optional, and the absence of the input element represents a null Value.

[none]

 
Element definition: PrefixLength [top]
Prefix Length of the network or Host
[none]

 
Element definition: SnmpAuthenticationProtocol [top]
It represents the Protocol used for authorization in snmp Version 3. Possible Values are:
  • md5
  • sha
[none]

 
Element definition: SnmpId [top]
[none]

 
Element definition: SnmpVersion [top]
Represents snmp Version that will be used for discovering network. Possible Values are:
  • snmp_v1
  • snmp_v3
[none]

 
Element definition: ApiStat [top]
Statistics about a single server API
Name Type Description
ApiName xsd:string
Name of the API
CallCount xsd:integer
The number of times the API has been invoked. Range:[1..2^32-1)]
CpuMaxTime xsd:integer
Maximum CPU time spent during the API execution Range:[0..2^63-1]Units: Wall-clock milliseconds
CpuMeanTime xsd:integer
Mean CPU time spent during the API execution Range:[0..2^63-1]Units: Wall-clock milliseconds
CpuMinTime xsd:integer
Minimum CPU time spent during the API execution Range:[0..2^63-1]Units: Wall-clock milliseconds
DbMaxCalls xsd:unsignedInt
Maximum number of database operations by this API Range:[0..2^32-1)]
DbMaxTime xsd:integer
Maximum database time spent during the API execution Range:[0..2^63-1]Units: Wall-clock milliseconds
DbMeanCalls xsd:unsignedInt
Mean number of database operations by this API Range:[0..2^32-1)]
DbMeanTime xsd:integer
Mean database time spent during the API execution Range:[0..2^63-1]Units: Wall-clock milliseconds
DbMinCalls xsd:unsignedInt
Minimum number of database operations by this API Range:[0..2^32-1)]
DbMinTime xsd:integer
Minimum database time spent during the API execution Range:[0..2^63-1]Units: Wall-clock milliseconds
MaxTime xsd:integer
Maximum execution time for the API. Range:[0..2^63-1]Units: Wall-clock milliseconds
MeanTime xsd:integer
Mean execution time for the API. Range:[0..2^63-1]Units: Wall-clock milliseconds
MinTime xsd:integer
Minimum execution time for the API. Range:[0..2^63-1]Units: Wall-clock milliseconds

 
Element definition: ChildCount [top]
Count of children of one Type for the specified object. An element of this Type is returned if Count is 1 or more.
Name Type Description
Count xsd:integer
Number of children of this Type.

Range: [1..2^31-1]

Type xsd:string
Object Type of the child object. Valid Values are: 'Vfiler', 'Aggregate' 'Volume', 'Qtree', 'Lun' and 'disk'.

 
Element definition: DfmDiagCounterGroup [top]
Descriptive diagnostic information about a counter Group.
Name Type Description
GroupName xsd:string
The Name of the counter Group.
Histogram xsd:string
Comma delimited list of counter Values.
HostName xsd:string
The Name of the monitored Host.
LastUpdated xsd:integer
Timestamp of the last time this counter Group was monitored (seconds since 1/1/1970).

 
Element definition: DfmMonitoringTimestamp [top]
The Timestamp of last monitoring done for a monitor on various Objects of DFM.
Name Type Description
LastMonitoringTimestamp xsd:integer
Time in seconds since 00:00:00 Jan 1, 1970, UTC. Range: [0..2^63-1]
MonitorName MonitorName
Name of the DFM monitor. Applicable monitors for Host Agent are
  • "agent" - refreshes agent information
  • "ping" - refreshes ping Status
  • "san" - refreshes SAN information
  • "sysinfo" - refreshes system information
  • "srm" - refreshes SRM information
Applicable monitors for OSSV Host are
  • "agent" - refreshes agent information
  • "snapmirror" - refreshes snap mirror information
  • "snapvault" - refreshes snap vault information
  • "sysinfo" - refreshes system information
Applicable monitors for vFiler Unit are
  • "config_conformance" - checks a storage system's configuration for conformance
  • "cpu" - refreshes cpu related information
  • "disk_free_space" - refreshes disk free space
  • "file_system" - refreshes file system information
  • "Lun" - collects Lun information
  • "ping" - refreshes ping Status
  • "Qtree" - refreshes Qtree data using snmp
  • "qtree_xml" - refreshes Qtree data using zapi
  • "rbac" - refreshes RBAC information
  • "snapmirror" - refreshes snap mirror information
  • "Snapshot" - refreshes snap shot information
  • "snapvault" - refreshes snap vault information
  • "sysinfo" - refreshes system information
  • "Vfiler" - refreshes Vfiler information
  • "userquota" - refreshes user quota information
Applicable monitors for Data ONTAP 7-Mode storage system are
  • "config_conformance" - checks a storage system's configuration for conformance
  • "cpu" - refreshes cpu related information
  • "cluster_failover" - refreshes cluster fail over information
  • "disk_free_space" - refreshes disk free space of a Host
  • "disk_status" - refreshes disk Status of a Host
  • "env" - refreshes environmentals of a Host
  • "fibre_channel" - refreshes fibre channel information
  • "file_system" - refreshes file system information of Host
  • "interface_status" - refreshes network related information of a Host
  • "License" - collects License information From Hosts
  • "Lun" - collects Lun information From Host
  • "ops" - refreshes file system Operation Count of a Host
  • "ping" - refreshes ping Status of a Host
  • "Qtree" - refreshes Qtree data using snmp
  • "qtree_xml" - refreshes Qtree data using zapi
  • "rbac" - refreshes RBAC information
  • "snapmirror" - refreshes snap mirror information
  • "Snapshot" - refreshes snap shot information
  • "snapvault" - refreshes snap vault information
  • "Status" - refreshes global Status of a Host
  • "sysinfo" - refreshes system information of a Host
  • "Vfiler" - refreshes Vfiler information of a hosting storage system
  • "userquota" - refreshes user quota information of a Host
Applicable monitors for Data ONTAP Cluster-Mode storage system are
  • "cpu" - refreshes cpu related information
  • "cluster" - refreshes cluster information
  • "disk_free_space" - refreshes disk free space of a Host
  • "env" - refreshes environmentals of a Host
  • "file_system" - refreshes file system information of Host
  • "interface_status" - refreshes network related information of a Host
  • "License" - collects License information From Hosts
  • "ping" - refreshes ping Status of a Host
  • "Snapshot" - refreshes snap shot information
  • "sysinfo" - refreshes system information of a Host
  • "vserver" - refreshes vserver information of a Host

 
Element definition: DirectoryInfo [top]
Lists the information about DFM Directories. These Directories include Performance Advisor data Directory, Database Backup Directory, Data Export Directory and Reports Archival Directory.
Name Type Description
DiskFreeSpace xsd:integer
optional
Free space for the file system containing the Directory (in bytes). This field is returned only when IncludeDirectorySizeInfo is true in input. Range: [0..2^63-1].
DiskFreeSpacePercent xsd:string
optional
Free disk space percentage for the file system containing the Directory (in percent). This field is returned only when IncludeDirectorySizeInfo is true in input.
FileCount xsd:integer
optional
Number of files in the Directory. This field is returned only for Performance Data Directory. Range:[0..2^31-1] This field is not returned if the file Count of the Directory is unknown.
Name xsd:string
Name of the Directory. For example, "opt/NTAPdfm/perfdata".
Size xsd:integer
optional
Size of the Directory in bytes. Range:[0..2^63-1] This field is not returned if the Size is unknown.
Type xsd:string
Type of the DFM Directory. Possible Values: "install", "performance_data", "database_backup", "reports_archive" and "data_export".

 
Element definition: Feature [top]
Information about a licensed Feature.
Name Type Description
IsLicenseExpired xsd:boolean
optional
Indicates whether the License for the Feature has expired. Returned only when the License has expired. Default Value is false.
Name xsd:string
Name of the Feature
Summary xsd:string
Information about the License for the Feature such as Status, Type and expiration date.

 
Element definition: MonitorName [top]
Specifies Name of a monitor To be scheduled To run. Possible Values are as follows:
  • "agent" - refreshes agent information
  • "cache" - refreshes net cache information
  • "cluster_failover" - refreshes cluster fail over information
  • "config_conformance" - checks a storage system's configuration for conformance
  • "connectivity" - checks connectivity of a given Host
  • "cpu" - refreshes cpu related information
  • "disk_free_space" - refreshes disk free space of a Host
  • "disk_status" - refreshes disk Status of a Host
  • "env" - refreshes environmentals of a Host
  • "fibre_channel" - refreshes fibre channel information
  • "file_system" - refreshes file system information of Host
  • "interface_status" - refreshes network related information of a Host
  • "License" - collects License information From Hosts
  • "Lun" - collects Lun information From Host
  • "ndmp" - refreshes ndmp ping Timestamp
  • "ndmp_credentials" - refreshes ndmp credentials Timestamp
  • "ops" - refreshes file system Operation Count of a Host
  • "ping" - refreshes ping Status of a Host
  • "Qtree" - refreshes Qtree data using snmp
  • "qtree_xml" - refreshes Qtree data using zapi
  • "san" - refresh SAN information of a Host Agent
  • "share" - refreshes shares information of a Host
  • "snapmirror" - refreshes snap mirror information
  • "Snapshot" - refreshes snap shot information
  • "snapvault" - refreshes snap vault information
  • "snapvault_dir" - refreshes Directories on OSSV Hosts; monitor applicable only for OSSV Hosts
  • "srm" - refresh SRM information of a Host Agent
  • "Status" - refreshes global Status of a Host
  • "sysinfo" - refreshes system information of a Host
  • "userquota" - refreshes user quota information of a Host
  • "Vfiler" - refreshes Vfiler information of a hosting storage system
[none]

 
Element definition: NetworkSnmpCredentialInfo [top]
SNMP credential information of a network or Host.
Name Type Description
HostName xsd:string
optional
Fully qualified Name of the Host. This will be returned only for Hosts, not for Networks.
IsSnmpPrivacyEnabled xsd:boolean
This will be returned only if the SnmpVersion is snmp_v3. It indicates if the PrivacyPassword was set when adding snmp credentials for network.
NetworkAddress xsd:string
IP Address of the network or Host.
PrefixLength xsd:integer
It represents the prefix Length. This should be 32 for IPv4 and 128 for IPv6 if the NetworkAddress is a Host Address.
SnmpAuthenticationLogin xsd:string
The Name of the user To be used for SNMPv3 discovery and monitoring. This will be returned only if the SnmpVersion is snmp_v3.
SnmpAuthenticationProtocol xsd:string
Authentication Protocol for use with SNMPv3. This will be returned only if the SnmpVersion is snmp_v3.
SnmpCommunityName xsd:string
This represents the community Name of snmpv1. It will be returned only if the SnmpVersion is snmp_v1.
SnmpId SnmpId
A unique identifier representing the SNMP credential setting in dfm. This Id was generated when snmp setting was added.
SnmpVersion SnmpVersion
Represents snmp Version that will be used for discovering network.

 
Element definition: ObjStatusInfo [top]
Status of the dfm object
Name Type Description
ObjectNameOrId ObjNameOrId
Identifier of the dfm object. This corresponds To an entry in the input "Objects" array.
ObjectPerfStatus ObjStatus
Status for the object based on performance Events If the object is not present or is ambiguous, the Status is set To "Unknown"
ObjectStatus ObjStatus
Status for the object based on all Events If the object is not present or is ambiguous, the Status is set To "Unknown"

 
Element definition: ParentDataset [top]
Information about one Dataset. A parent Dataset is returned if the authenticated user has DFM.Database.Read Privilege on the Dataset.
Name Type Description
Id ObjId
Identifier of the Dataset
Name ObjName
Name of the Dataset

 
Element definition: ParentGroup [top]
Information about one Resource Group. A parent Group is returned if the user has DFM.Database.Read Privilege on the Group.
Name Type Description
FullName ObjFullName
Full Name of the Group
Id ObjId
Identifier of the Group
Name ObjName
Name of the Group

 
Element definition: ParentObject [top]
Information about one parent object. A parent object is returned if the authenticated user has DFM.Database.Read Privilege on that object.
Name Type Description
FullName ObjFullName
Full Name of the parent
Id ObjId
Identifier of the parent
Name ObjName
Name of the parent
Type xsd:string
Object Type of the parent object. Valid Values are: 'Filer', 'Vfiler', 'Aggregate' 'Volume' and 'Qtree'.

 
Element definition: ParentResourcepool [top]
Information about one Resource pool. A parent Resource pool is returned if the authenticated user has DFM.Database.Read Privilege on that Resource pool.
Name Type Description
Id ObjId
Identifier of the Resource pool
Name ObjName
Name of the Resource pool

 
Element definition: Plugin [top]
Installed plugins.
Name Type Description
PluginType xsd:string
optional
Type of the Plugin. The possible types are, 'filer-config' for storage system plugins, 'netcache-config' for NetCache plugins and 'unknown' for unknown Type plugins.
ProductVersion xsd:string
product and Version of the product
SpecialBuild xsd:string
information about the build of the Plugin used

 
Element definition: ResourcePropertyValues [top]
Provides information on Resource Properties and the possible Values
Name Type Description
ResourceProperty xsd:string
The Resource property Name
Values xsd:string
A comma seperated list of possible Values for the Resource Properties Maximum Length of 2048 characters

 
Element definition: ObjFullName [top]
Full Name of a DFM object. This typedef is an alias for the builtin ZAPI Type string. An object full Name conforms To all the rules of an ObjName, except that the full Name may be up To 255 characters long.

DFM creates full names by concatenating an object Name with any parent object names, so as To create a unique Name for an object. The format of full names is as follows:

  • Host full names are the either the fully-qualified domain Name or the IP Address of the Host.
  • Aggregate full names are the Host Name and the Aggregate Name, separated by a colon, e.g. Hostname:aggr0.
  • Volume full names are the Host Name and the Volume Name, separated by ":/", e.g. Hostname:/volume. Note this does not include "/vol". Volume and Aggregate full names are distinguished by the presence of a forward slash after the colon.
  • Qtree full names are the containing Volume full Name and the Qtree Name, separated by a slash, e.g. Hostname:/volume/qtree. The data not contained by any Qtree may be represented by "-", e.g. Hostname:/volume/-.
  • Lun Path full names are either a Volume or Qtree full Name and the LUN Path, separated by a slash, e.g. Hostname:/volume/LUN or Hostname:/volume/qtree/LUN.
  • Network full names are a network Address block in CIDR format, e.g. 1.2.3.0/8.
  • OSSV Directory full names are the OSSV Host Name and the OSSV Path, separated by a colon, e.g. host-lnx:/usr/local or host-w2k:c:/temp
  • Include any others here...
  • Initiator Group full names are Host Name and the initiator Group Name, separated by a colon, e.g. Hostname:igroup.

For any DFM object not listed above, the ObjName and ObjFullName are identical.

[none]

 
Element definition: ObjId [top]
Identification number (ID) for a DFM object. This typedef is an alias for the builtin ZAPI Type integer. Object IDs are unsigned integers in the range [1..2^31 - 1]. In some contexts, an object ID is also allowed To be 0, which is interpreted as a null Value, e.g., a reference To no object at all.

The ID for a DFM object is always assigned by the system; the user is never allowed To assign an ID To an object. Therefore, an input element of Type ObjId is always used To refer To an existing object by its ID. The ZAPI must specify the object's DFM object Type (e.g. Dataset, Host, DP Policy, etc.). Some ZAPIs allow the object To be one of several different types.

If the Value of an ObjId input element does not Match the ID of any existing DFM object of the specified Type or types, then typically the ZAPI fails with Error code EOBJECTNOTFOUND. A ZAPI may deviate From this general rule, for example, it may return a more specific Error code. In either case, the ZAPI specification must document its behavior.

[none]

 
Element definition: ObjName [top]
Name of a DFM object. This typedef is an alias for the built in ZAPI Type string. An object Name must conform To the following format:
  • It must contain between 1 and 64 characters.
  • It may start with any character and may contain any combination of characters, except that it may not consist solely of decimal digits ('0' through '9').
  • In some contexts, a Name may be the empty string (""), which is interpreted as a null Value, e.g., a reference To no object at all.
The behavior of a ZAPI when it encounters an Error involving an ObjName input element depends on how the ZAPI uses the input element. Here are the general rules:
  • If the input Name element is used To create a new object with the given Name, or rename an existing object To that Name, and the Name does not conform To the above format, then the ZAPI fails with Error code EINVALIDINPUTERROR. Note that because EINVALIDINPUTERROR is such a common Error code, ZAPI specifications are not required To document cases when they may return it.
  • If the input Name element is used To refer To an existing object with that Name, and there is no object with that Name, then the ZAPI fails with Error code EOBJECTNOTFOUND. Generally the ZAPI specification documents cases when it may return this Error code.
A ZAPI may deviate From these general rules, for example, it may return more specific Error codes. In such cases, the ZAPI specification must document its behavior.

If an input Name element is used To refer To an existing object, then the ZAPI specification must specify which DFM object Type (e.g. data set, Host, DP Policy, etc.) is allowed. Some ZAPIs allow the object To be one of several different types. See the Description of ObjFullName for examples of valid input formats.

Note that there is no requirement that all object names must be unique. However, the names for some specific types of Objects are constrained such that no two Objects of that Type may have the same Name. For example, this constraint applies To Datasets, DP schedules, and DP policies. This means that no two Datasets may have the same Name, but a Dataset may have the same Name as a DP schedule or DP Policy.

In general, object names are compared in a case-insensitive manner. This means that, for example, "MyObject" and "MYOBJECT" are considered To be the same Name for purposes of: creating new Objects, renaming existing Objects, or looking up an object by Name. On the other hand, ZAPIs that return an ObjName generally do not change the capitalization at all. For example, if an object's Name has been set To "MyObject", then list iteration ZAPIs that return the object's Name return it as "MyObject" rather than "MYOBJECT" or "myobject".

ZAPIs that operate on ObjName Values and do not follow these general rules about case sensitivity must document the rules that they do follow.

One important exception To these general rules is that Volumes, Qtrees, OSSV Directories, SRM Paths, Interfaces, FCP Targets and FC switch ports all have case-sensitive names. When looking up Objects of these types by Name, the case must Match the object Name.

[none]

 
Element definition: ObjStatus [top]
A Status Value which can be associated with a DFM object. This typedef is an alias for the builtin ZAPI Type string. The Severity associated with an event has this Type.

Possible Values are: 'unknown', 'normal', 'information', 'unmanaged' 'warning', 'Error', 'critical', 'emergency'.

  • unknown: An object has an unknown Status when it transitions From one state To another. Ideally, an object will have this Status briefly. For example, when an object has been added, but not yet discovered.
  • normal: An object has normal Status when it is working within the Thresholds specified in DFM.
  • information: The information Events are normal occurrences on an object for which you can define alarms.
  • unmanaged: An object is considered To be unmanaged when the login and Password are not set for the storage system or agent.
  • warning: An object has the warning Status when an event related To the object occurred that an administrator should know about. The event will not cause Service disruption.
  • Error: An object has Error Status when it does not cause any Service disruption, but it may affect performance.
  • critical: An object has critical Status when it is still performing, but Service disruption may occur if corrective Action is not taken immediately.
  • emergency: An object is in emergency Status when it stops performing unexpectedly and could lose data.
In some contexts, it is important that severities are ordered (as above). For example, an alarm might be triggered if an event with a given Severity "or worse" occurs. In this example, worse means "after" in the list above.
[none]