Input Name	Type
DfmAbout	DfmAbout
Output Name	Type
DfmAboutResult	DfmAboutResult

Error Name	Description
EAPIPRIVILEDGE

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

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

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

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

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

Retrieve server diagnostic information

Input Name	Type
DfmServerListDiagnosticInfo	DfmServerListDiagnosticInfo
Output Name	Type
DfmServerListDiagnosticInfoResult	DfmServerListDiagnosticInfoResult

Error Name	Description
EAPIPRIVILEDGE

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

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.

Name	Type	Description
CpuCount	xsd:string	CPU Count.
DfmDirectories	ArrayOfDirectoryInfo	CPU Count.
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

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.

Name	Type	Description
ApiStatistics	ArrayOfApiStat	Lists the statistics about the API call frequencies on the DFM server.

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

Name	Type	Description
ResourcePropertyValues	ArrayOfResourcePropertyValues	The Values for the Resource Properties

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.

[none]

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

Name	Type	Description
ObjectsStatus	ArrayOfObjStatusInfo	Status of the passed in input Objects.

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

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.

Retrieve server diagnostic information

[none]

Name	Type	Description
DiagInfo	ArrayOfDfmDiagCounterGroup	Diagnostic information collected From the dfm server.

Retrieve current user's global Privilege. This api is no longer the preferred way To getting user privileges. Use RbacAccessCheck.

[none]

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.

Name	Type	Description
ApiStat	ApiStat[]

Name	Type	Description
ChildCount	ChildCount[]

Name	Type	Description
DfmDiagCounterGroup	DfmDiagCounterGroup[]

Name	Type	Description
DirectoryInfo	DirectoryInfo[]

Name	Type	Description
Feature	Feature[]

Name	Type	Description
MonitorName	MonitorName[]

Name	Type	Description
ObjNameOrId	ObjNameOrId[]

Name	Type	Description
ObjStatusInfo	ObjStatusInfo[]

Name	Type	Description
ParentDataset	ParentDataset[]

Name	Type	Description
ParentGroup	ParentGroup[]

Name	Type	Description
ParentObject	ParentObject[]

Name	Type	Description
ParentResourcepool	ParentResourcepool[]

Name	Type	Description
Plugin	Plugin[]

Name	Type	Description
ResourcePropertyValues	ResourcePropertyValues[]

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]. 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]

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

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'.

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).

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
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: "performance_data", "database_backup", "reports_archive" and "data_export".

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.

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]

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"

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

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

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'.

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

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

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

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]

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]

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]

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]