APIs in Category: Disk
API version 4.0

 
DiskListInfoIterEnd
DiskListInfoIterNext
DiskListInfoIterStart
DFM tracks all the Disks it discovers on storage systems it is monitoring. These APIs give the user access To the information DFM has collected about Disks.

NetApp Manage ONTAP API version 4.0
 
DiskListInfoIterEnd (supported) [top]

The DiskListInfoIter* set of APIs are used To retrieve the list of Disks. DiskListInfoIterEnd is used To tell the DFM station that the temporary store used by DFM To support the DiskListInfoIterNext API for the particular Tag is no longer necessary.
Input Name Type
DiskListInfoIterEnd DiskListInfoIterEnd
 
Output Name Type
DiskListInfoIterEndResult DiskListInfoIterEndResult
 Error Name  Description
 EINVALIDTAG

 
DiskListInfoIterNext (supported) [top]
For more documentation please check DiskListInfoIterStart. The DiskListInfoIterNext API is used To iterate over the Members of the Disks stored in the temporary store created by the DiskListInfoIterStart API.
Input Name Type
DiskListInfoIterNext DiskListInfoIterNext
 
Output Name Type
DiskListInfoIterNextResult DiskListInfoIterNextResult
 Error Name  Description
 EINVALIDINPUTERROR
 EINVALIDTAG

 
DiskListInfoIterStart (supported) [top]
The DiskListInfoIter* set of APIs are used To retrieve the list of Disks in DFM. DiskListInfoIterStart returns the disk belonging To Objects specified. It loads the list of Disks into a temporary store. The API returns a Tag that identifies that temporary store so that subsequent APIs can be used To iterate over the Disks in the temporary store. If DiskListInfoIterStart is invoked twice, then two distinct temporary stores are created.
Input Name Type
DiskListInfoIterStart DiskListInfoIterStart
 
Output Name Type
DiskListInfoIterStartResult DiskListInfoIterStartResult
 Error Name  Description
 EACCESSDENIED
 EAPIERROR
 EDATABASEERROR
 EINTERNALERROR
 EINVALIDINPUTERROR
 EOBJECTAMBIGUOUS
 EOBJECTNOTFOUND

 
Element definition: DiskListInfoIterEnd [top]
The DiskListInfoIter* set of APIs are used To retrieve the list of Disks. DiskListInfoIterEnd is used To tell the DFM station that the temporary store used by DFM To support the DiskListInfoIterNext API for the particular Tag is no longer necessary.
Name Type Description
Tag xsd:string
An internal opaque handle used by the DFM station

 
Element definition: DiskListInfoIterEndResult [top]
[none]

 
Element definition: DiskListInfoIterNext [top]
For more documentation please check DiskListInfoIterStart. The DiskListInfoIterNext API is used To iterate over the Members of the Disks stored in the temporary store created by the DiskListInfoIterStart API.
Name Type Description
Maximum xsd:integer
The Maximum number of entries To retrieve. Range: [1..2^31-1]
Tag xsd:string
Tag From a previous DiskListInfoIterStart. It's an opaque handle used by the DFM station To identify the temporary store created by DiskListInfoIterStart.

 
Element definition: DiskListInfoIterNextResult [top]
Name Type Description
Disks ArrayOfDiskInfo
List of Disks.
Records xsd:integer
The number of Records actually returned. Range: [1..2^31-1]

 
Element definition: DiskListInfoIterStart [top]
The DiskListInfoIter* set of APIs are used To retrieve the list of Disks in DFM. DiskListInfoIterStart returns the disk belonging To Objects specified. It loads the list of Disks into a temporary store. The API returns a Tag that identifies that temporary store so that subsequent APIs can be used To iterate over the Disks in the temporary store. If DiskListInfoIterStart is invoked twice, then two distinct temporary stores are created.
Name Type Description
ObjectManagementFilter ObjectManagementInterface
optional
Filter the object based on the Data ONTAP Interface that provides complete management for the object i.e. ONTAP CLIs, SNMP, ONTAPI etc. If no filter is supplied, all Objects will be considered.
ObjectNameOrId ObjNameOrId
optional
Name or identifier of an object To list Disks for. The allowed object types for this argument are:
  • Resource Group
  • Host
  • Aggregate
Disks are not Objects in DFM. So, a single disk cannot be listed. If ObjectNameOrId is specified, all Disks that belong To the object specified will be listed. If no ObjectNameOrId is provided, all Disks will be listed.

 
Element definition: DiskListInfoIterStartResult [top]
Name Type Description
Records xsd:integer
Number which tells you how many items have been saved for future retrieval with DiskListInfoIterNext. Range: [1..2^31-1]
Tag xsd:string
Tag To be used in subsequent calls To DiskListInfoIterNext. It is an opaque handle used by the DFM station To identify a temporary store.

 
Element definition: ArrayOfDiskInfo [top]
Name Type Description
DiskInfo DiskInfo[]

 
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].
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: ObjectManagementInterface [top]
Specify the management Interface of ONTAP that provides complete management for the object i.e. ONTAP CLIs, SNMP, ONTAPI etc. Possible Values are:
  • "node" - For Objects manageable by node management Interface
  • "cluster" - For Objects manageable by cluster management Interface
[none]

 
Element definition: DiskInfo [top]
Information about a disk.
Name Type Description
AggregateId ObjId
optional
Identifier of Aggregate To which the disk belongs. When Aggregate the disk belongs To is not known or disk is a spare disk, AggregateId will not be returned.
AggregateName ObjFullName
optional
Name of Aggregate To which the disk belongs. When Aggregate the disk belongs To is not known or disk is a spare disk, AggregateName will not be returned. The Name is any simple Name such as myaggr.
DiskId ObjId
Identifier of the disk. Always present in the output.
DiskName xsd:string
Name of the disk. Always present in the output. The Name will look like "data disk 0b.18", "parity disk 0b.17", "dparity disk 0b.16" etc. Maximum Length of 64 characters.
DiskSize xsd:integer
Disk Size in bytes. Range : [0..2^63-1].
DiskType xsd:string
Type of the disk. Maximum Length of 64 characters.
DiskUidOrWwn xsd:string
optional
Identifier of the disk. For Hosts running Data ONTAP versions prior To 7.0.1, this will be the World Wide Name (WWN) of the disk. For Hosts running Data ONTAP versions 7.0.1 and later, this will be the Unique Identifier (UID) of the disk. When UID or WWN of a disk is not known, this field will not be returned. Maximum Length of 90 characters. Format of disk WWN will look like: 20:00:00:0c:50:45:7d:bc Format of disk UUID will look like: 2000000C:50A9022F:00000000:00000000:00000000:00000000: 00000000:00000000:00000000:00000000
HostId ObjId
Identifier of Host To which the disk belongs. Always present in the output.
HostName ObjName
Name of Host To which the disk belongs. Always present in the output. The Name is any simple Name such as myhost.
PlexName xsd:string
optional
Name of plex To which the disk belongs. The Name is any simple Name such as plex0. When plex the disk belongs To is not known or disk is a spare disk, PlexName will not be returned. Maximum Length of 64 characters.
RaidgroupName xsd:string
optional
Name of raidgroup To which the disk belongs. The Name is any simple Name such as rg0. When raidgroup the disk belongs To is not known or disk is a spare disk, RaidgroupName will not be returned. Maximum Length of 64 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]