APIs in Category: Aggregate | API version 5.0

AggregateListInfoIterEnd AggregateListInfoIterNext AggregateListInfoIterStart AggregateModify AggregateSpaceManagementAddOperation AggregateSpaceManagementBegin AggregateSpaceManagementCommit AggregateSpaceManagementRemoveOperation AggregateSpaceManagementRollback | DFM tracks all the Aggregates it discovers on storage systems it is monitoring. These APIs give the user access To the information DFM has collected about Aggregates.

NetApp Manage ONTAP API version 5.0

AggregateListInfoIterEnd (supported) | [top]

> The AggregateListInfoIter* set of APIs are used To retrieve the list of Aggregates. AggregateListInfoIterEnd is used To tell the DFM station that the temporary store used by DFM To support the AggregateListInfoIterNext API for the particular Tag is no longer necessary.

> Input Name | Type
> AggregateListInfoIterEnd | AggregateListInfoIterEnd
> Output Name | Type
> AggregateListInfoIterEndResult | AggregateListInfoIterEndResult

> Error Name | Description
> EINVALIDTAG |  |

AggregateListInfoIterNext (supported) | [top]

> For more documentation please check AggregateListInfoIterStart. The AggregateListInfoIterNext API is used To iterate over the Members of the Aggregates stored in the temporary store created by the AggregateListInfoIterStart API.

> Input Name | Type
> AggregateListInfoIterNext | AggregateListInfoIterNext
> Output Name | Type
> AggregateListInfoIterNextResult | AggregateListInfoIterNextResult

> Error Name | Description
> EINVALIDINPUTERROR |  |
> EINVALIDTAG |  |

AggregateListInfoIterStart (supported) | [top]

> The AggregateListInfoIter* set of APIs are used To retrieve the list of Aggregates in DFM. The AggregateListInfoIterStart API is used To load the list of Aggregates 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 Aggregates in the temporary store. If AggregateListInfoIterStart is invoked twice, then two distinct temporary stores are created. If neither AggregateNameOrId or aggr-group-name-or-id are provided, all Aggregates will be listed. If either, but not both are provided, the Aggregate or all Aggregates in the Group will be listed respectively. If AggregateNameOrId and aggr-group-name-or-id are provided, the Aggregate will be listed only if it is under the specified Group.

> Input Name | Type
> AggregateListInfoIterStart | AggregateListInfoIterStart
> Output Name | Type
> AggregateListInfoIterStartResult | AggregateListInfoIterStartResult

> Error Name | Description
> EACCESSDENIED |  |
> EAPIERROR |  |
> EDATABASEERROR |  |
> EINTERNALERROR |  |
> EINVALIDINPUTERROR |  |
> EOBJECTAMBIGUOUS |  |
> EOBJECTNOTFOUND |  |

AggregateModify (supported) | [top]

> Modify an Aggregate's information. If modifying of one property fails, nothing will be changed. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Write Capability on the specified Aggregate. EINVALIDINPUT - When invalid input specified. EOBJECTNOTFOUND - When the AggregateNameOrId does not correspond To an Aggregate. EDATABASEERROR - On database Error.

> Input Name | Type
> AggregateModify | AggregateModify
> Output Name | Type
> AggregateModifyResult | AggregateModifyResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> EINVALIDINPUT |  |
> EOBJECTNOTFOUND |  |

AggregateSpaceManagementAddOperation (supported) | [top]

> Add a space management Operation as part of this space management session. The actual Operation is not carried out unless AggregateSpaceManagementCommit is called. If this Operation cannot be carried out, then ESPACEMGMTCONFLICTOP will be returned The following rules apply when adding an Operation To the session. A session cannot have 2 operations of same Type for a give Volume. For example two Volume resize operations cannot be added for the same Volume To a session. If this check fails the api will return ESPACEMGMTCONFLICTOP Error. If a Volume migration Operation is added To a session then other session management operations cannot be added To the session. Similarly a Volume migration cannot be added To a session if other Type of Operation is already added To session. If this check fails the api will return ESPACEMGMTCONFLICTOP Error. If this Operation leads To Errors in DryRunResults that are returned, then this Operation is not added To the session.

> Input Name | Type
> AggregateSpaceManagementAddOperation | AggregateSpaceManagementAddOperation
> Output Name | Type
> AggregateSpaceManagementAddOperationResult | AggregateSpaceManagementAddOperationResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> EINVALIDINPUT |  |
> EINVALIDOBJECTTYPE |  |
> EOBJECTAMBIGUOUS |  |
> EOBJECTNOTFOUND |  |
> ESPACEMGMTCONFLICTOP |  |
> ESPACEMGMTSESSIONNOTFOUND |  |

AggregateSpaceManagementBegin (supported) | [top]

> Open a space management session To run space management operations on an Aggregate. This allows adding a set of space management operations in a session, getting the difference in space consumption due To these set of operations and then committing all the operations. A space management session must be started before invoking the following ZAPIs: AggregateSpaceManagementAddOperation AggregateSpaceManagementRemoveOperation AggregateSpaceManagementCommit AggregateSpaceManagementRollback Use AggregateSpaceManagementCommit To commit the changes and To start Jobs which will carry out the space management operations. Use AggregateSpaceManagementRollback To rollback the session. This will not submit any Jobs for space management operations. After 24 hours, a session can be opened on the same Aggregate by another client without the Force Option. This will cause any space management operations that were part of the session To be discarded.

> Input Name | Type
> AggregateSpaceManagementBegin | AggregateSpaceManagementBegin
> Output Name | Type
> AggregateSpaceManagementBeginResult | AggregateSpaceManagementBeginResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> EINVALIDINPUT |  |
> EOBJECTAMBIGUOUS |  |
> EOBJECTNOTFOUND |  |
> ESPACEMGMTSESSIONINPROGRESS |  |

AggregateSpaceManagementCommit (supported) | [top]

> Commit the space management operations added as part of this space management session. The session that was opened on the Aggregate will be released once all the space management Jobs that were part of the session are queued To be executed eventually. This will not wait for the Jobs To be executed. Use the DryRun Option To test the commit. It returns a set of DryRun Results for each space management Operation that was added as part of this session. DryRunResults is a set of steps that the server will take To carry out the space management Operation When DryRun is true, it also returns the projected used and committed space of the Aggregate on which the space management session was opened and other dependent Aggregates in case of migration operations. If DryRun is false, then before the call returns, the system submits Jobs To the provisioning engine To execute.

> Input Name | Type
> AggregateSpaceManagementCommit | AggregateSpaceManagementCommit
> Output Name | Type
> AggregateSpaceManagementCommitResult | AggregateSpaceManagementCommitResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> ESPACEMGMTSESSIONNOTFOUND |  |

AggregateSpaceManagementRemoveOperation (supported) | [top]

> Remove a space management Operation that was added as part of this space management session.

> Input Name | Type
> AggregateSpaceManagementRemoveOperation | AggregateSpaceManagementRemoveOperation
> Output Name | Type
> AggregateSpaceManagementRemoveOperationResult | AggregateSpaceManagementRemoveOperationResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> EINVALIDINPUT |  |
> EOBJECTAMBIGUOUS |  |
> EOBJECTNOTFOUND |  |
> ESPACEMGMTSESSIONNOTFOUND |  |
> ESPCMGMTNOSUCHOP |  |

AggregateSpaceManagementRollback (supported) | [top]

> Release the session opened for space management on an Aggregate. All the space management operations that were submitted as part of the space management session would be discarded.

> Input Name | Type
> AggregateSpaceManagementRollback | AggregateSpaceManagementRollback
> Output Name | Type
> AggregateSpaceManagementRollbackResult | AggregateSpaceManagementRollbackResult

> Error Name | Description
> EACCESSDENIED |  |
> ESPACEMGMTSESSIONNOTFOUND |  |

Element definition: AggregateListInfoIterEnd | [top]

> The AggregateListInfoIter* set of APIs are used To retrieve the list of Aggregates. AggregateListInfoIterEnd is used To tell the DFM station that the temporary store used by DFM To support the AggregateListInfoIterNext 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: AggregateListInfoIterEndResult | [top]

> [none]

Element definition: AggregateListInfoIterNext | [top]

> For more documentation please check AggregateListInfoIterStart. The AggregateListInfoIterNext API is used To iterate over the Members of the Aggregates stored in the temporary store created by the AggregateListInfoIterStart 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 AggregateListInfoIterStart. It's an opaque handle used by the DFM station To identify the temporary store created by AggregateListInfoIterStart.

Element definition: AggregateListInfoIterNextResult | [top]

> Name | Type | Description
> Aggregates | ArrayOfAggregateInfo | List of Aggregates.
> Records | xsd:integer | The number of Records actually returned. Range: [1..2^31-1]

Element definition: AggregateListInfoIterStart | [top]

> The AggregateListInfoIter* set of APIs are used To retrieve the list of Aggregates in DFM. The AggregateListInfoIterStart API is used To load the list of Aggregates 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 Aggregates in the temporary store. If AggregateListInfoIterStart is invoked twice, then two distinct temporary stores are created. If neither AggregateNameOrId or aggr-group-name-or-id are provided, all Aggregates will be listed. If either, but not both are provided, the Aggregate or all Aggregates in the Group will be listed respectively. If AggregateNameOrId and aggr-group-name-or-id are provided, the Aggregate will be listed only if it is under the specified Group.

> Name | Type | Description
> AggregateType | xsd:string optional | Filter by Type of Aggregate. Possible Values are: traditional Aggregate striped If no AggregateType input is supplied, all types of Aggregates will be listed.
> BlockType | FileSystemBlockType optional | Filter by file system block Type of the Aggregate. If no BlockType input is supplied, all types of Aggregates will be listed.
> IncludeDatasetSpaceInfo | xsd:boolean optional | If true, a list of Datasets that consume space From this Aggregate and the actual space consumed is returned in DatasetsSpaceInfo. Default Value: false.
> IncludeIsAvailable | xsd:boolean optional | If true, the IsAvailable Status is calculated for each Aggregate which may make the call To this zapi take much longer. Default is false.
> IsDirectMemberOnly | xsd:boolean optional | If true, only return the Aggregates that are direct Members of the specified Resource Group. Default Value is false. This field is meaningful only if a Resource Group Name or Id is given for the ObjectNameOrId field.
> IsDpIgnored | xsd:boolean optional | If true, only list Aggregates that have been set To be ignored for purposes of data protection. If false, only list Aggregates that have not been set To be ignored for purposes of data protection. If not specified, list all Aggregates without taking into account whether they have been ignored or not.
> IsInDataset | xsd:boolean optional | If true, only list Aggregates which only contain data which is protected by a Dataset. If false, only list Aggregates containing data which is not protected by a Dataset. If not specified, list all Aggregates whether they are in a Dataset or not.
> IsUnprotected | xsd:boolean optional | If true, only list Aggregates that are not protected, which means the Aggregate is: 1. not in any Resource pool. 2. not a child of a Host that is a member of any Resource pool. and 3. not a member of a node in a Dataset with protection Policy assigned. If false or not set, list all Aggregates.
> 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 | xsd:string optional | Name or identifier of an object To list Aggregates for. The allowed object types for this argument are: Resource Group Resource Pool Dataset Storage Set Host Aggregate Volume Qtree GenericAppObject If ObjectNameOrId identifies an Aggregate, that single Aggregate will be returned. If ObjectNameOrId resolves To more than one Aggregate, all of them will be returned. If no ObjectNameOrId is provided, all Aggregates will be listed.
> RbacOperation | xsd:string optional | Name of an RBAC Operation. If specified, only return Aggregates for which authenticated admin has the required Capability. A Capability is an operation/resource pair. The Resource is the Volume where the Aggregate lives. The possible Values that can be specified for Operation can be obtained by calling RbacOperationInfoList. If Operation is not specified, then it defaults To DFM.Database.Read. For more information about operations, Capabilities and user roles, see the RBAC APIs.
> ResourcepoolFilter | xsd:string optional | Possible Value: 'in_rpool', 'not_in_rpool', 'all'. If set To 'in_rpool', only list Aggregates that are in a Resource pool. If set To 'not_in_rpool', only list Aggregates that are not in a Resource pool. If set To 'all', then list all Aggregates. If a Value is not specified, then 'all' will be the default. An Aggregate is said To be in a Resource pool if either the Aggregate or the storage system containing the Aggregate is a member of a Resource pool.
> VolumesToMigrate | ArrayOfObjectNameOrId optional | This is a filter To return a list of candidate destination Aggregates where the Volumes in VolumesToMigrate can be migrated To. An ordered list of candidate Aggregates are returned based on free space. Each ObjectNameOrId in VolumesToMigrate input should be the identifier or full Name of a Volume and they should all belong To the same Source Aggregate. Returning the list of candidate Aggregates for migration can potentially take some time To compute.

Element definition: AggregateListInfoIterStartResult | [top]

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

Element definition: AggregateModify | [top]

> Modify an Aggregate's information. If modifying of one property fails, nothing will be changed. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Write Capability on the specified Aggregate. EINVALIDINPUT - When invalid input specified. EOBJECTNOTFOUND - When the AggregateNameOrId does not correspond To an Aggregate. EDATABASEERROR - On database Error.

> Name | Type | Description
> AggregateNameOrId | xsd:string | Name or identifier of the Aggregate To modify.
> IsDpIgnored | xsd:boolean optional | True if an administrator has chosen To ignore this object for purposes of data protection.

Element definition: AggregateModifyResult | [top]

> [none]

Element definition: AggregateSpaceManagementAddOperation | [top]

> Add a space management Operation as part of this space management session. The actual Operation is not carried out unless AggregateSpaceManagementCommit is called. If this Operation cannot be carried out, then ESPACEMGMTCONFLICTOP will be returned The following rules apply when adding an Operation To the session. A session cannot have 2 operations of same Type for a give Volume. For example two Volume resize operations cannot be added for the same Volume To a session. If this check fails the api will return ESPACEMGMTCONFLICTOP Error. If a Volume migration Operation is added To a session then other session management operations cannot be added To the session. Similarly a Volume migration cannot be added To a session if other Type of Operation is already added To session. If this check fails the api will return ESPACEMGMTCONFLICTOP Error. If this Operation leads To Errors in DryRunResults that are returned, then this Operation is not added To the session.

> Name | Type | Description
> SpaceManagementOperationInfo | SpaceManagementOperationInfo | Details of a space management Operation To be added To the session.
> SpaceManagementSessionId | xsd:integer | Identifier of the space management session on an Aggregate To which this space management Operation has To be added. Range: [1..2^31-1]

Element definition: AggregateSpaceManagementAddOperationResult | [top]

> Name | Type | Description
> AggregateDiffSpaceInfos | ArrayOfAggregateSpaceInfo | Returns the difference in Aggregate space consumption (i.e used space and committed space) due To this space management Operation only on the session Aggregate as well as other Aggregates affected by this Operation (for example Volume migration affects both session Aggregate and destination Aggregate.) The Values returned in AggregateSpaceInfo can be positive or negetive depending on whether the Operation consumes or frees up space on the Aggregates. For example Volume migration frees up space on the Source Aggregate and consumes space on the destination Aggregate.
> DryRunResults | ArrayOfDryRunResult optional | Results of a dry run. Each Result describes one Action the system would take and the predicted effects of that Action.

Element definition: AggregateSpaceManagementBegin | [top]

> Open a space management session To run space management operations on an Aggregate. This allows adding a set of space management operations in a session, getting the difference in space consumption due To these set of operations and then committing all the operations. A space management session must be started before invoking the following ZAPIs: AggregateSpaceManagementAddOperation AggregateSpaceManagementRemoveOperation AggregateSpaceManagementCommit AggregateSpaceManagementRollback Use AggregateSpaceManagementCommit To commit the changes and To start Jobs which will carry out the space management operations. Use AggregateSpaceManagementRollback To rollback the session. This will not submit any Jobs for space management operations. After 24 hours, a session can be opened on the same Aggregate by another client without the Force Option. This will cause any space management operations that were part of the session To be discarded.

> Name | Type | Description
> AggregateNameOrId | ObjNameOrId | Name or identifier of the Aggregate on which To open the space management session.
> Force | xsd:boolean optional | By default, Force is false. If true, and a space management session is already in progress on the specified Aggregate the previous space management session is rolled back and a new edit session is begun.

Element definition: AggregateSpaceManagementBeginResult | [top]

> Name | Type | Description
> SpaceManagementSessionId | xsd:integer | Identifier of the space management session. Range: [1..2^31-1]

Element definition: AggregateSpaceManagementCommit | [top]

> Commit the space management operations added as part of this space management session. The session that was opened on the Aggregate will be released once all the space management Jobs that were part of the session are queued To be executed eventually. This will not wait for the Jobs To be executed. Use the DryRun Option To test the commit. It returns a set of DryRun Results for each space management Operation that was added as part of this session. DryRunResults is a set of steps that the server will take To carry out the space management Operation When DryRun is true, it also returns the projected used and committed space of the Aggregate on which the space management session was opened and other dependent Aggregates in case of migration operations. If DryRun is false, then before the call returns, the system submits Jobs To the provisioning engine To execute.

> Name | Type | Description
> DryRun | xsd:boolean optional | If true, return the DryRunResults list for each space management Operation and AggregateSpaceInfos which gives the projected used and committed space of the Aggregate(s) as a Result of space management operations added To the session. The DryRunResults list contains actions that would be taken should the changes be committed without actually committing the changes. The session is not released after a dry run. By default, DryRun is false.
> SpaceManagementSessionId | xsd:integer | Identifier of the space management session on an Aggregate Range: [1..2^31-1]

Element definition: AggregateSpaceManagementCommitResult | [top]

> Name | Type | Description
> AggregateSpaceInfos | ArrayOfAggregateSpaceInfo optional | Returns overall Effect of space management operations added To the session on the used and committed space of all affected Aggregates (i.e Aggregate on which the space management session is started and the Aggregates affected by space management operations added To the session. For example migration effects two Aggregates, session Aggregate and destination Aggregate). The space Effect is calculated by obtaining the space freed or consumed by each Operation and by adding or subtracting it From the current used and committed space of the Aggregate. Returned only if DryRun is true.
> SpaceManagementResults | ArrayOfSpaceManagementResultInfo | Results of a commit Operation for each space management Operation that was added in this session.

Element definition: AggregateSpaceManagementRemoveOperation | [top]

> Remove a space management Operation that was added as part of this space management session.

> Name | Type | Description
> ObjectNameOrId | ObjNameOrId | Object whose space management Operation has To be removed From this session.
> SpaceManagementOpType | SpaceManagementOpType | Type of space management Operation To be removed for the object From this session.
> SpaceManagementSessionId | xsd:integer | Identifier of the space management session on an Aggregate From which this space management Operation has To be removed. Range: [1..2^31-1]

Element definition: AggregateSpaceManagementRemoveOperationResult | [top]

> Name | Type | Description
> AggregateDiffSpaceInfos | ArrayOfAggregateSpaceInfo | Returns difference in Aggregate space consumption (i.e used space and committed space) caused by removing this space magagement Operation From the session. The Values returned here are same as the Values returned by AggregateSpaceManagementAddOperation zapi (called when adding this Operation To the session) but with the signs reversed.

Element definition: AggregateSpaceManagementRollback | [top]

> Release the session opened for space management on an Aggregate. All the space management operations that were submitted as part of the space management session would be discarded.

> Name | Type | Description
> SpaceManagementSessionId | xsd:integer | Identifier of the space management session on an Aggregate To be rolled back. Range: [1..2^31-1]

Element definition: AggregateSpaceManagementRollbackResult | [top]

> [none]

Element definition: ArrayOfAggregateInfo | [top]

> Name | Type | Description
> AggregateInfo | AggregateInfo[] |

Element definition: ArrayOfAggregateSpaceInfo | [top]

> Name | Type | Description
> AggregateSpaceInfo | AggregateSpaceInfo[] |

Element definition: ArrayOfDryRunResult | [top]

> Name | Type | Description
> DryRunResult | DryRunResult[] |

Element definition: ArrayOfObjectNameOrId | [top]

> Name | Type | Description
> ObjectNameOrId | ObjectNameOrId[] |

Element definition: ArrayOfSpaceManagementResultInfo | [top]

> Name | Type | Description
> SpaceManagementResultInfo | SpaceManagementResultInfo[] |

Element definition: FileSystemBlockType | [top]

> Block Type of the file system. The Volumes on both the Source and destination sides of a SnapMirror relationship must be of the same block Type. Volumes contained in a larger parent agregate may have a BlockType of 64_bit. For upgraded systems it is possible that this Value may be unknown until the system can determine the BlockType. Possible Values are: 32_bit 64_bit unknown

> [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: 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: SpaceManagementOpType | [top]

> Type of space management Operation Possible Values: resize_volume delete_snapshot delete_backup migrate_volume dedupe_volume

> [none]

Element definition: SpaceManagementOperationInfo | [top]

> Details of a space management Operation. Only one of the Request info in SpaceManagementOperationInfo should be sent in input.

> Name | Type | Description
> BackupDeletionRequestInfo | BackupDeletionRequestInfo optional | Details of Backups To be deleted as part of this space management Operation. The Backups To be deleted should be on a Volume in the Aggregate on which the space management session was opened.
> DedupeRequestInfo | DedupeRequestInfo optional | Details of deduplication scan To be run on a Volume.
> ObjectNameOrId | ObjNameOrId | Name or Id of the Volume on which a space management Operation needs To be performed.
> ResizeVolumeRequestInfo | ResizeVolumeRequestInfo optional | Details of a resize Request To be carried out as part of this space management Operation. The resize Request should be on a Volume in the Aggregate on which the space management session was opened.
> SnapshotDeletionRequestInfo | SnapshotDeletionRequestInfo optional | Details of a Snapshot deletion Request To be carried out as part of this space management Operation. The Snapshot deletion Request should be on a Volume in the Aggregate on which the space management session was opened.
> SpaceManagementOpType | SpaceManagementOpType | Type of space management Operation.
> VolumeMigrationRequestInfo | VolumeMigrationRequestInfo optional | Details of Volume migration Operation To be carried out. The Volumes To be migrated should belong To the Aggregate on which the space management session was opened.

Element definition: AggregateInfo | [top]

> Information about a Aggregate.

> Name | Type | Description
> AggregateFullThreshold | xsd:integer | The Value (as an integer percentage) of the fullness threshold used To generate an "Aggregate full" event for this Aggregate. If the Value is empty, then the global setting for Aggregate full threshold is considered and this can be obtained From DfmGetOption API with OptionName as "aggregateFullThreshold". Range: [0..1000]
> AggregateId | xsd:integer | Identifier of the Aggregate. Range: [1..2^31-1]
> AggregateName | xsd:string | Simple Name of the Aggregate. Always present in the output. The Name is any simple Name such as myaggr.
> AggregateNearlyFullThreshold | xsd:integer | The Value (as an integer percentage) of the fullness threshold used To generate an "Aggregate nearly full" event for this Aggregate. If the Value is empty, then the global setting for Aggregate nearly full threshold is considered and this can be obtained From DfmGetOption API with OptionName as "aggregateNearlyFullThreshold". Range: [0..1000]
> AggregateNearlyOvercommittedThreshold | xsd:unsignedShort | The Value (as an integer percentage) is used To generate "Aggregate nearly overcommitted" event for this Aggregate. If the Value is empty, then the global setting for Aggregate nearly over committed threshold is considered and this can be obtained From DfmGetOption API with OptionName as "aggregateNearlyOverCommittedThreshold". Range: [0..65535]
> AggregateOvercommittedThreshold | xsd:unsignedShort | The Value (as an integer percentage) is used To generate "Aggregate overcommitted" event for this Aggregate. If the Value is empty, then the global setting for Aggregate over committed threshold is considered and this can be obtained From DfmGetOption API with OptionName as "aggregateOverCommittedThreshold". Range: [0..65535]
> AggregatePerfStatus | ObjStatus optional | Current Status of the Aggregate based on performance Events
> AggregateSize | AggregateSize | Sizes of various parameters of the Aggregate.
> AggregateSpaceStatus | ObjectSpaceStatus | Space Status of the Aggregate. This indicates the fullness of the Aggregate in terms of whether the percentage of used space with respect To Total Size of the Aggregate has reached or crossed the fullness Thresholds given in AggregateNearlyFullThreshold and AggregateFullThreshold.
> AggregateStatus | ObjStatus optional | Current Status of the Aggregate based on all Events
> AggregateType | xsd:string | Type of Aggregate. Possible Values are: traditional Aggregate striped
> BlockType | FileSystemBlockType | File system block Type of the Aggregate. The Volumes on both the Source and destination sides of a SnapMirror relationship must be of the same block Type.
> Datasets | ArrayOfDatasetReference | List of Dataset IDs and names containing this Volume. If IsInDataset is false, this list will be empty.
> DatasetsSpaceInfo | ArrayOfDatasetSpaceInfo optional | Space used by each Dataset in the Aggregate. Returned only when IncludeDatasetSpaceInfo is set To true in AggregateListInfoIterStart.
> FilerId | xsd:integer | Identifier of controller when AggregateType is traditional or Aggregate. Identifier of cluster when AggregateType is striped. Always present in the output. Range: [1..2^31-1]
> FilerName | xsd:string | Name of controller when AggregateType is traditional or Aggregate. Name of cluster when AggregateType is striped. Always present in the output. The Name is any simple Name such as myhost.
> IsAvailable | xsd:boolean optional | True if this object and all of it's parents are up or online. Only output if the call To iter-start included the "IncludeIsAvailable" flag.
> IsDpIgnored | xsd:boolean | True if an admin wants To ignore this Aggregate for purposes of data protection.
> IsInDataset | xsd:boolean | True indicates if this Aggregate is a member of any Dataset.
> ResourcepoolName | ObjName optional | Name of the Resource pool of which the Aggregate is a member. This element will not be present if the Aggregate is not a member of a Resource pool.
> TimeToFull | xsd:integer | Estimated amount of time left in seconds for the Aggregate To become full. This is returned as empty when the estimated amount of time is more than a Year. This can happen due To very low or negative rate of consumption of space in the Aggregate. Range: [0..31536000]

Element definition: AggregateSpaceInfo | [top]

> Information about space charecteristics of an Aggregate.

> Name | Type | Description
> AggregateId | ObjId | Aggregate identifier
> AggregateName | ObjName | Aggregate Name
> CommittedSpace | xsd:integer | Information about committed space of an Aggregate in bytes. Range: [0..2^63-1]
> UsedSpace | xsd:integer | Information about used space of an Aggregate in bytes. Range: [0..2^63-1]

Element definition: BackupDeletionRequestInfo | [top]

> Details of backup To be deleted.

> Name | Type | Description
> BackupIds | ArrayOfBackupId | List of Backups To be deleted on a Volume.

Element definition: DedupeRequestInfo | [top]

> Deduplication Request details

> Name | Type | Description
> FullVolumeDedupe | xsd:boolean optional | If true, full Volume dedupe scan is performed. Otherwise only new data since last deduplication Operation is scanned. Default Value is false.

Element definition: DryRunResult | [top]

> A Description of one Action and the predicted effects of taking that Action.

> Name | Type | Description
> DryRunAction | xsd:string | An Action the system would take.
> DryRunEffect | xsd:string | The predicted Effect of the Action.
> DryRunReason | xsd:string optional | Present only if Severity is Error or warning. Specifies possible reasons for the Error, warning. If there are no reasons To specify, this element will not be present.
> DryRunReasonDetails | ArrayOfResultDetail optional | These details apply To the associated DryRunReason within the same DryRunResult. These offer additional information such as the reasons individual reasources may not have been selected for the DryRunAction in this same DryRunResult.
> DryRunSeverity | ObjStatus | Severity of the DryRun Result. Possible Values are "information", "Error" or "warning".
> DryRunSuggestion | xsd:string | Present only if Severity is Error or warning. Specifies any suggestions To rectify the warnings, Errors. If there are no suggestions To specify, this element will not be present.

Element definition: ObjectNameOrId | [top]

> Name or ID of an object.

> [none]

Element definition: ResizeVolumeRequestInfo | [top]

> Details of the resize Request. Atleast one of NewSize, MaximumCapacity or SnapReserve needs To be specified.

> Name | Type | Description
> MaximumCapacity | xsd:integer optional | Specify the new Maximum capacity Value for a flexbile Volume. The Value is specified in bytes. Valid only if the storage syste, To which the Volume belongs is of ONTAP Version 7.1 or above only and if autosize is enabled on the Volume. Range: [1..2^44-1]
> NewSize | xsd:integer optional | Specify the new Size of the Volume. The Value is specified in bytes. Range: [1..2^44-1]
> SnapReserve | xsd:integer optional | Specifies the percetage of space set aside for Snapshots in a Volume. The Value is specified in percentage of the Total Size of the Volume. Range: [0..100]

Element definition: SnapshotDeletionRequestInfo | [top]

> Details of Snapshot deletion Request

> Name | Type | Description
> Snapshots | ArrayOfSnapshot | List of Snapshot copies To be deleted From the Volume. A minimum of 1 and a Maximum of 255 Snapshot copies can be listed for deletion.

Element definition: SpaceManagementResultInfo | [top]

> Results of the space management session.

> Name | Type | Description
> DryRunResults | ArrayOfDryRunResult optional | Results of a dry run. Each Result describes one Action the system would take and the predicted effects of that Action. Only returned if DryRun is true.
> JobId | xsd:integer optional | Identifier of job started for the provisioning Request. Returned only when DryRun is false.
> ObjectId | ObjId | Identifier of the object on which the space management Operation is invoked.
> ObjectName | ObjFullName | Name of the object on which space management Operation is invoked.
> SpaceManagementOpType | SpaceManagementOpType | Type of space management Operation.

Element definition: VolumeMigrationRequestInfo | [top]

> Details of Volume migration Request

> Name | Type | Description
> CleanupStaleStorage | CleanupStaleStorage optional | Indicates when should the Volumes in the Source Aggregate should be destroyed after successful migration. Default Value is "cleanup_after_migration".
> DestinationAggregateNameOrId | ObjNameOrId optional | Name or identifier of the destination Aggregate To which all the Volumes has To be migrated To. If the destination Aggregate is not provided, the system will select a suitable Aggregate From the Resource pools associated with the Dataset node To which the Volumes belong To.
> RetentionType | DpBackupRetentionType optional | Retention Type To which the backup Version created should be archived for the Backups created as part of running an on-demand update after successful migration. This element is ignored if RunOnDemandUpdate is false. Default Value is "daily".
> RunDedupeScan | xsd:boolean optional | Indicates whether a full deduplication scan has To be run on the new Volume after migration. This Option is applicable only for Volumes that are enabled for deduplication and is useful To regenerate the fingerprint database used in deduplication and will be ignored for other Volumes. Default Value is false.
> RunOnDemandUpdate | xsd:boolean optional | Indicates whether an on-demand update has To be triggered after successful migration on the Dataset To which the Volumes that were migrated belong To. Default Value is false.

Element definition: AggregateSize | [top]

> Sizes of various parameters of an Aggregate.

> Name | Type | Description
> SizeAvailable | xsd:integer | Available bytes in the Aggregate. Range: [0..2^63-1].
> SizeTotal | xsd:integer | Aggregate Total Size in bytes. Range : [0..2^63-1].
> SizeUsed | xsd:integer | Aggregate bytes used. Range: [0..2^63-1].
> SpaceTotalCommitted | xsd:integer optional | Total space committed in bytes. Range: [0..2^63-1]

Element definition: ArrayOfBackupId | [top]

> Name | Type | Description
> BackupId | BackupId[] |

Element definition: ArrayOfDatasetReference | [top]

> Name | Type | Description
> DatasetReference | DatasetReference[] |

Element definition: ArrayOfDatasetSpaceInfo | [top]

> Name | Type | Description
> DatasetSpaceInfo | DatasetSpaceInfo[] |

Element definition: ArrayOfResultDetail | [top]

> Name | Type | Description
> ResultDetail | ResultDetail[] |

Element definition: ArrayOfSnapshot | [top]

> Name | Type | Description
> Snapshot | Snapshot[] |

Element definition: CleanupStaleStorage | [top]

> Indicates when the Volumes in the Source Aggregate should be destroyed after successful migration. Possible Values are: cleanup_after_update cleanup_after_migration no_cleanup

> [none]

Element definition: DpBackupRetentionType | [top]

> Retention Type To which the backup should be archived. Possible Values are: 'hourly', 'daily', 'weekly', 'monthly' and 'unlimited'.

> [none]

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]

Element definition: ObjectSpaceStatus | [top]

> Space Status of the object. This indicates the fullness of the object in terms of whether the percentage of used space with respect To Total Size of the object has reached the fullness Thresholds. Possible Values: ok - when the percentage of used space of the object is within the nearly full and full threshold of the object. nearly_full - when the percentage of used space of the object is within the full threshold of the object but has reached or crossed the nearly full threshold. full - when the percentage of used space of the object has reached or crossed the full threshold of the object.

> [none]

Element definition: BackupId | [top]

> Identifier of the backup Instance To be deleted. Range: [1..2^31-1]

> [none]

Element definition: DatasetReference | [top]

> The Name and Id of a Dataset.

> Name | Type | Description
> DatasetId | ObjId | Identifier for the Dataset. Range: [1..2^31-1]
> DatasetName | ObjName | Name of the Dataset.

Element definition: DatasetSpaceInfo | [top]

> Information about a datset consuming space From the Aggregate.

> Name | Type | Description
> DatasetId | ObjId | Database identifier of the Dataset.
> DatasetName | ObjName | Name of the Dataset.
> DpNodeId | xsd:integer | Identifier of the node in the Dataset that is consuming space From the Aggregate. If there is no protection Policy associated with the Dataset, NodeId will be 1. Range: [1..2^32-1]
> DpNodeName | xsd:string | Name of the node in the Dataset that is consuming space From the Aggregate. If there is no protection Policy associated with the Dataset, this would return the Name of the Dataset.
> IsCapableOfMigration | xsd:boolean | Indicates whether the Dataset is capable of migration. This is returned true only if the Dataset can be migrated in a transparent way using vFiler migration.
> IsDpNodeEffectivePrimary | xsd:boolean | Specifies whether the node in the Dataset that is consuming space From the Aggregate is the effective primary node or not.
> UsedSpace | xsd:unsignedLong | Space used by the Dataset on the Aggregate in bytes. Range: [0..2^64-1].

Element definition: ResultDetail | [top]

> Details on a specific Action that adds information intended To explain more about a higher level Result. For example, the detail may be used To explain a DryRun Result by explaining why resources were not selected.

> Name | Type | Description
> Action | xsd:string | An Action or check the system had taken.
> Effect | xsd:string | The Result of the Action or check.
> Reason | xsd:string optional | Specifies possible reasons for the this Result. If there are no reasons To specify, this element will not be present.
> Severity | ObjStatus | Severity of the Result Result. Possible Values are "information", "Error" "warning". It is normal for "information" To be used To explain why a Resource was not selected.
> Suggestion | xsd:string | Specifies any suggestions To rectify the information, warnings, Errors. If there are no suggestions To specify, this element will not be present.

Element definition: Snapshot | [top]

> Information of one Snapshot copy. Either UniqueId or Name of the Snapshot copy should be specified.

> Name | Type | Description
> SnapshotName | xsd:string optional | Name of the Snapshot copy. If UniqueId is specified, then this element is ignored.
> UniqueId | xsd:string optional | Unique identifier of the Snapshot copy. Currently, this is the Snapshot copy's creation time.