APIs in Category: Resourcepool | API version 5.0

ResourcepoolAddMember ResourcepoolCreate ResourcepoolDestroy ResourcepoolGetDefaults ResourcepoolListInfoIterEnd ResourcepoolListInfoIterNext ResourcepoolListInfoIterStart ResourcepoolMemberListInfoIterEnd ResourcepoolMemberListInfoIterNext ResourcepoolMemberListInfoIterStart ResourcepoolModify ResourcepoolModifyMember ResourcepoolRemoveMember ResourcepoolUpdateFreeSpaceStatus | A Resource pool typically describes physical resources such as spare Disks, Aggregates or storage systems which are used for provisioning. When a Resource pools contains a storage system, all Aggregates and spare Disks on the storage system are available for provisioning.

NetApp Manage ONTAP API version 5.0

ResourcepoolAddMember (supported) | [top]

> Add member -- storage system or Aggregate -- To an existing Resource pool. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Write Capability on the specified Resource pool or DFM.Database.Read Privilege on the object being added. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. EOBJECTNOTFOUND - When the specified object of valid Type To add is not found or object does not exist at all. EINVALIDMEMBERTYPE - When an Aggregate To add contains traditional Volume or it is Aggregate Snapshot. EOBJECTINANOTHERDYNAMICREFERENCE - When the specified object or its relative Members, are already in another Resource pool/storage set. Try again with move flag To move resources across Resource pools. When used by storage set, you need To manually remove Resource From storage set and add it To Resource pool. EOBJECTINDIRECTMEMOFANOTHERDYNAMICREF - Object being added To Resource pool is in another Resource pool and it's a indirect member of the Resource pool. EOBJECTEXISTSINRESOURCEPOOL - When the specified object already exists in the Resource pool. EOBJECTAMBIGUOUS - When the specified object Name is ambiguous To denote whether its storage system or Aggregate. Try again with fully qualified Name or object Id. EDATABASEERROR - On database Error.

> Input Name | Type
> ResourcepoolAddMember | ResourcepoolAddMember
> Output Name | Type
> ResourcepoolAddMemberResult | ResourcepoolAddMemberResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> EINVALIDMEMBERTYPE |  |
> EOBJECTAMBIGUOUS |  |
> EOBJECTEXISTSINRESOURCEPOOL |  |
> EOBJECTINANOTHERDYNAMICREFERENCE |  |
> EOBJECTINDIRECTMEMOFANOTHERDYNAMICREF |  |
> EOBJECTNOTFOUND |  |
> ERESOURCEPOOLDOESNOTEXIST |  |

ResourcepoolCreate (supported) | [top]

> Create a new, empty Resource pool. Error Conditions: EINVALIDINPUT - When invalid Name specified. A valid Name is non empty and constitutes at least one non-numeric character. ERESOURCEPOOLEXISTS - When the specified Resource pool already exists. EDATABASEERROR - On database Error.

> Input Name | Type
> ResourcepoolCreate | ResourcepoolCreate
> Output Name | Type
> ResourcepoolCreateResult | ResourcepoolCreateResult

> Error Name | Description
> EDATABASEERROR |  |
> EINVALIDINPUT |  |
> ERESOURCEPOOLEXISTS |  |

ResourcepoolDestroy (supported) | [top]

> Destroy a Resource pool. If the Resource pool is in use by a storage set or Resource pool is not empty, the Resource pool may only be destroyed by specifying the Force flag. If the Resource pool is in use by the storage Service, the Resource pool can be destroyed only after removing it From the storage Service. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Delete Capability on the specified Resource pool. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. ERESOURCEPOOLNOTEMPTY - When the specified Resource pool is not empty. Try again with Force flag. ERESOURCEPOOLINUSE - When the specified Resource pool is in use by a storage set. Try again with Force flag. EDATABASEERROR - On database Error.

> Input Name | Type
> ResourcepoolDestroy | ResourcepoolDestroy
> Output Name | Type
> ResourcepoolDestroyResult | ResourcepoolDestroyResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> ERESOURCEPOOLDOESNOTEXIST |  |
> ERESOURCEPOOLINUSE |  |
> ERESOURCEPOOLNOTEMPTY |  |

ResourcepoolGetDefaults (supported) | [top]

> Get the default Values of Attributes defined by this ZAPI set.

> Input Name | Type
> ResourcepoolGetDefaults | ResourcepoolGetDefaults
> Output Name | Type
> ResourcepoolGetDefaultsResult | ResourcepoolGetDefaultsResult

ResourcepoolListInfoIterEnd (supported) | [top]

> Ends iteration of Resource pools.

> Input Name | Type
> ResourcepoolListInfoIterEnd | ResourcepoolListInfoIterEnd
> Output Name | Type
> ResourcepoolListInfoIterEndResult | ResourcepoolListInfoIterEndResult

> Error Name | Description
> EINVALIDTAG |  |

ResourcepoolListInfoIterNext (supported) | [top]

> Get next Records in the iteration started by ResourcepoolListInfoIterStart.

> Input Name | Type
> ResourcepoolListInfoIterNext | ResourcepoolListInfoIterNext
> Output Name | Type
> ResourcepoolListInfoIterNextResult | ResourcepoolListInfoIterNextResult

> Error Name | Description
> EINVALIDTAG |  |

ResourcepoolListInfoIterStart (supported) | [top]

> Starts iteration To list Resource pools. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Read Capability on the specified Resource pools. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool is not found in the database. EDATABASEERROR - On database Error.

> Input Name | Type
> ResourcepoolListInfoIterStart | ResourcepoolListInfoIterStart
> Output Name | Type
> ResourcepoolListInfoIterStartResult | ResourcepoolListInfoIterStartResult

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

ResourcepoolMemberListInfoIterEnd (supported) | [top]

> Ends iteration of Resource pools.

> Input Name | Type
> ResourcepoolMemberListInfoIterEnd | ResourcepoolMemberListInfoIterEnd
> Output Name | Type
> ResourcepoolMemberListInfoIterEndResult | ResourcepoolMemberListInfoIterEndResult

> Error Name | Description
> EINVALIDTAG |  |

ResourcepoolMemberListInfoIterNext (supported) | [top]

> Get next Records in the iteration started by ResourcepoolMemberListInfoIterStart.

> Input Name | Type
> ResourcepoolMemberListInfoIterNext | ResourcepoolMemberListInfoIterNext
> Output Name | Type
> ResourcepoolMemberListInfoIterNextResult | ResourcepoolMemberListInfoIterNextResult

> Error Name | Description
> EINVALIDTAG |  |

ResourcepoolMemberListInfoIterStart (supported) | [top]

> Starts iteration To list Members of specified Resource pool. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Read Capability on the specified Resource pools. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. EDATABASEERROR - On database Error.

> Input Name | Type
> ResourcepoolMemberListInfoIterStart | ResourcepoolMemberListInfoIterStart
> Output Name | Type
> ResourcepoolMemberListInfoIterStartResult | ResourcepoolMemberListInfoIterStartResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> ERESOURCEPOOLDOESNOTEXIST |  |

ResourcepoolModify (supported) | [top]

> Modify a Resource pool'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 Resource pool. EINVALIDINPUT - When invalid input specified. A ResourcepoolName should be non empty and constitutes at least one non-numeric character. The ResourcepoolContact Value should be email Address which does not have any white space. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. ERESOURCEPOOLEXISTS - Already a Resource pool exists with the new Name. EDATABASEERROR - On database Error.

> Input Name | Type
> ResourcepoolModify | ResourcepoolModify
> Output Name | Type
> ResourcepoolModifyResult | ResourcepoolModifyResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> EINVALIDINPUT |  |
> EINVALIDTIMEZONE |  |
> ERESOURCEPOOLDOESNOTEXIST |  |
> ERESOURCEPOOLEXISTS |  |

ResourcepoolModifyMember (supported) | [top]

> Modify the Properties of Members of Resource pool. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Write Capability on the specified Resource pool or DFM.Database.Write Privilege on the object being modified. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. EOBJECTNOTFOUND - When the specified object of valid Type To add is not found or object does not exist at all. EINVALIDMEMBERTYPE - When an object is not a mamber of Resourcepool. EOBJECTAMBIGUOUS - When the specified object Name is ambiguous To denote whether its Filer or Aggregate. Try again with fully qualified Name or object Id. EDATABASEERROR - On database Error.

> Input Name | Type
> ResourcepoolModifyMember | ResourcepoolModifyMember
> Output Name | Type
> ResourcepoolModifyMemberResult | ResourcepoolModifyMemberResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> EOBJECTAMBIGUOUS |  |
> EOBJECTNOTFOUND |  |
> EOBJECTNOTINRESOURCEPOOL |  |
> ERESOURCEPOOLDOESNOTEXIST |  |

ResourcepoolRemoveMember (supported) | [top]

> Remove member -- storage system or Aggregate -- From a Resource pool. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Delete Capability on the specified Resource pool or DFM.Database.Read Privilege on the object being removed. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. EOBJECTNOTFOUND - When the specified object To remove not found. EOBJECTAMBIGUOUS - When the specified object Name is ambiguous To denote whether its storage system or Aggregate. Try again with fully qualified Name or object Id. EOBJECTNOTINRESOURCEPOOL - When the specified object does not exist in the Resource pool. EDATABASEERROR - On database Error.

> Input Name | Type
> ResourcepoolRemoveMember | ResourcepoolRemoveMember
> Output Name | Type
> ResourcepoolRemoveMemberResult | ResourcepoolRemoveMemberResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> EOBJECTAMBIGUOUS |  |
> EOBJECTNOTFOUND |  |
> EOBJECTNOTINRESOURCEPOOL |  |
> ERESOURCEPOOLDOESNOTEXIST |  |

ResourcepoolUpdateFreeSpaceStatus (supported) | [top]

> Check the free space in the Resource pool against the nearly-full and full Thresholds and generate appropriate Events for the Resource pool.

> Input Name | Type
> ResourcepoolUpdateFreeSpaceStatus | ResourcepoolUpdateFreeSpaceStatus
> Output Name | Type
> ResourcepoolUpdateFreeSpaceStatusResult | ResourcepoolUpdateFreeSpaceStatusResult

> Error Name | Description
> EACCESSDENIED |  |
> EDATABASEERROR |  |
> ERESOURCEPOOLDOESNOTEXIST |  |

Element definition: ResourcepoolAddMember | [top]

> Add member -- storage system or Aggregate -- To an existing Resource pool. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Write Capability on the specified Resource pool or DFM.Database.Read Privilege on the object being added. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. EOBJECTNOTFOUND - When the specified object of valid Type To add is not found or object does not exist at all. EINVALIDMEMBERTYPE - When an Aggregate To add contains traditional Volume or it is Aggregate Snapshot. EOBJECTINANOTHERDYNAMICREFERENCE - When the specified object or its relative Members, are already in another Resource pool/storage set. Try again with move flag To move resources across Resource pools. When used by storage set, you need To manually remove Resource From storage set and add it To Resource pool. EOBJECTINDIRECTMEMOFANOTHERDYNAMICREF - Object being added To Resource pool is in another Resource pool and it's a indirect member of the Resource pool. EOBJECTEXISTSINRESOURCEPOOL - When the specified object already exists in the Resource pool. EOBJECTAMBIGUOUS - When the specified object Name is ambiguous To denote whether its storage system or Aggregate. Try again with fully qualified Name or object Id. EDATABASEERROR - On database Error.

> Name | Type | Description
> MemberNameOrId | xsd:string | Name or identifier of the member To add To the Resource pool. Possible Values are name/id of storage system or Aggregate. It should be a valid DFM object Name or object Id. A valid DFM object Name should contain at least one non-numeric character. A valid DFM object Id should be in the range of [1..2^31-1].
> MoveIfExists | xsd:boolean optional | If the object To add, or one or more of its contents, is already in a Resource pool, this flag specifies that the object should be removed From the old dynamic reference and added To the Resource pool. By default, the add Operation fails if the object, or one of its contents, is already in a storage set or Resource pool.
> ResourceTag | ResourceTag optional | Resource Tag of the member which is set on the member.
> ResourcepoolNameOrId | xsd:string | Name or identifier of the Resource pool To extend. It should be a valid DFM object Name or object Id. A valid DFM object Name should contain at least one non-numeric character. A valid DFM object Id should be in the range of [1..2^31-1].

Element definition: ResourcepoolAddMemberResult | [top]

> [none]

Element definition: ResourcepoolCreate | [top]

> Create a new, empty Resource pool. Error Conditions: EINVALIDINPUT - When invalid Name specified. A valid Name is non empty and constitutes at least one non-numeric character. ERESOURCEPOOLEXISTS - When the specified Resource pool already exists. EDATABASEERROR - On database Error.

> Name | Type | Description
> Resourcepool | WrapperOfResourcepoolInfo | New information about a Resource pool To modify. If any field is not specified, that field will not be changed. Name field should be specified and others are optional. If the optional fields are specified, they would be set during creation itself.

Element definition: ResourcepoolCreateResult | [top]

> Name | Type | Description
> ResourcepoolId | xsd:integer | Identifier of the new Resource pool. Its a valid DFM object Id. A valid DFM object Id would be in the range of [1..2^31-1].

Element definition: ResourcepoolDestroy | [top]

> Destroy a Resource pool. If the Resource pool is in use by a storage set or Resource pool is not empty, the Resource pool may only be destroyed by specifying the Force flag. If the Resource pool is in use by the storage Service, the Resource pool can be destroyed only after removing it From the storage Service. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Delete Capability on the specified Resource pool. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. ERESOURCEPOOLNOTEMPTY - When the specified Resource pool is not empty. Try again with Force flag. ERESOURCEPOOLINUSE - When the specified Resource pool is in use by a storage set. Try again with Force flag. EDATABASEERROR - On database Error.

> Name | Type | Description
> Force | xsd:boolean optional | If specified, allows destroying a Resource pool that has Members or in use by storage set.
> ResourcepoolNameOrId | xsd:string | Name or identifier of Resource pool To Destroy. It should be a valid DFM object Name or object Id. A valid DFM object Name should contain at least one non-numeric character. A valid DFM object Id should be in the range of [1..2^31-1].

Element definition: ResourcepoolDestroyResult | [top]

> [none]

Element definition: ResourcepoolGetDefaults | [top]

> Get the default Values of Attributes defined by this ZAPI set.

> [none]

Element definition: ResourcepoolGetDefaultsResult | [top]

> Name | Type | Description
> ResourcepoolDefaults | ResourcepoolDefaults | The default Values of the Attributes defined by this ZAPI.

Element definition: ResourcepoolListInfoIterEnd | [top]

> Ends iteration of Resource pools.

> Name | Type | Description
> Tag | xsd:string | Tag From a previous ResourcepoolListInfoIterStart.

Element definition: ResourcepoolListInfoIterEndResult | [top]

> [none]

Element definition: ResourcepoolListInfoIterNext | [top]

> Get next Records in the iteration started by ResourcepoolListInfoIterStart.

> Name | Type | Description
> Maximum | xsd:integer | The Maximum number of Records To retrieve. Range: [1..2^31-1]
> Tag | xsd:string | Tag From a previous ResourcepoolListInfoIterStart.

Element definition: ResourcepoolListInfoIterNextResult | [top]

> Name | Type | Description
> Records | xsd:integer | The number of Records actually returned. Value of 0 Records indicates that end of Records. Range: [1..2^31-1]
> Resourcepools | ArrayOfResourcepoolInfo | List of Resource pools.

Element definition: ResourcepoolListInfoIterStart | [top]

> Starts iteration To list Resource pools. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Read Capability on the specified Resource pools. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool is not found in the database. EDATABASEERROR - On database Error.

> Name | Type | Description
> CheckLicenses | ArrayOfLicense optional | Filter for licensed services running on Data ONTAP. If this input is present, only resourepools containing atleast one Aggregate hosted on a Filer having these Licenses will have ResourcepoolIsProvisionable flag set To TRUE.
> DpNodeName | xsd:string optional | Applicable only if ObjectNameOrId specified is of Type 'Dataset'.
> IncludeFreeSpace | xsd:boolean optional | If this Value is true, then free space information will be included with each Resource pool. If this Value is false or not specified, then no free space information is included. ResourcepoolSpaceStatus is returned only when IncludeFreeSpace is true.
> ObjectNameOrId | ObjNameOrId optional | Name or identifier of a Resource pool or Group or Dataset or storage Service. If unspecified, all Resource pools are listed.
> ResourceTag | ResourceTag optional | If this input is present, only the Resource pools having this Tag or containing atleast one member having this Tag will have ResourcepoolIsProvisionable flag set To TRUE.
> StorageReliability | StorageReliability optional | If this input is present, only the Resourcepools containing atleast one member having the required reliability will have ResourcepoolIsProvisionable flag set To TRUE.

Element definition: ResourcepoolListInfoIterStartResult | [top]

> Name | Type | Description
> Records | xsd:integer | Number of items that have been saved for future retrieval with ResourcepoolListInfoIterNext. Range: [1..2^31-1]
> Tag | xsd:string | Tag To be used in subsequent calls To ResourcepoolListInfoIterNext.

Element definition: ResourcepoolMemberListInfoIterEnd | [top]

> Ends iteration of Resource pools.

> Name | Type | Description
> Tag | xsd:string | Tag From a previous ResourcepoolMemberListInfoIterStart.

Element definition: ResourcepoolMemberListInfoIterEndResult | [top]

> [none]

Element definition: ResourcepoolMemberListInfoIterNext | [top]

> Get next Records in the iteration started by ResourcepoolMemberListInfoIterStart.

> Name | Type | Description
> Maximum | xsd:integer | The Maximum number of Records To retrieve. Range: [1..2^31-1]
> Tag | xsd:string | Tag From a previous ResourcepoolMemberListInfoIterStart.

Element definition: ResourcepoolMemberListInfoIterNextResult | [top]

> Name | Type | Description
> Records | xsd:integer | The number of Records actually returned. Value of 0 Records indicates that end of Records. Range: [1..2^31-1]
> ResourcepoolMembers | ArrayOfResourcepoolMemberInfo | List of the Members of the Resource pool.

Element definition: ResourcepoolMemberListInfoIterStart | [top]

> Starts iteration To list Members of specified Resource pool. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Read Capability on the specified Resource pools. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. EDATABASEERROR - On database Error.

> Name | Type | Description
> IncludeDatasetSpaceInfo | xsd:boolean optional | If true, space utilized by Datasets on each Aggregate is returned. Default Value: false. This is input is ignored when RunProvisioningChecks element is true.
> IncludeIndirect | xsd:boolean optional | If true, indirect Members are included. By default they are not included.
> MemberType | xsd:string optional | Type of object To be returned. Possible Values are 'Filer' or 'Aggregate'.
> ProvisionMemberRequestInfo | ProvisionMemberRequestInfo optional | Information of a provisioning Request.
> ProvisioningPolicyNameOrId | xsd:string optional | Name or Id of provisioning Policy, this input ignored if RunProvisioningChecks is false.
> ResourcepoolMemberNameOrId | xsd:string optional | Name or Id of Resource pool member.
> ResourcepoolNameOrId | xsd:string | Name or identifier of the Resource pool To Query. It should be a valid DFM object Name or object Id. A valid DFM object Name should contain at least one non-numeric character. A valid DFM object Id should be in the range of [1..2^31-1].
> RunProvisioningChecks | xsd:boolean optional | If true, provisioning related checks are run on all the Members of the Resource pool using the provisioning Policy and provisioning Request info specied as part of ProvisioningPolicyNameOrId and provisioning-member-request-info inputs elements.

Element definition: ResourcepoolMemberListInfoIterStartResult | [top]

> Name | Type | Description
> Records | xsd:integer | Number of items that have been saved for future retrieval with ResourcepoolMemberListInfoIterNext. Range: [1..2^31-1]
> Tag | xsd:string | Tag To be used in subsequent calls To ResourcepoolMemberListInfoIterNext.

Element definition: ResourcepoolModify | [top]

> Modify a Resource pool'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 Resource pool. EINVALIDINPUT - When invalid input specified. A ResourcepoolName should be non empty and constitutes at least one non-numeric character. The ResourcepoolContact Value should be email Address which does not have any white space. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. ERESOURCEPOOLEXISTS - Already a Resource pool exists with the new Name. EDATABASEERROR - On database Error.

> Name | Type | Description
> Resourcepool | WrapperOfResourcepoolInfo | New information about a Resource pool To modify. If any field is not specified, that field will not be changed. If none of the optional parameters are specified, then this API does nothing.
> ResourcepoolNameOrId | xsd:string | Name or identifier of the Resource pool To modify. It should be a valid DFM object Name or object Id. A valid DFM object Name should contain at least one non-numeric character. A valid DFM object Id should be in the range of [1..2^31-1].

Element definition: ResourcepoolModifyMember | [top]

> Modify the Properties of Members of Resource pool. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Write Capability on the specified Resource pool or DFM.Database.Write Privilege on the object being modified. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. EOBJECTNOTFOUND - When the specified object of valid Type To add is not found or object does not exist at all. EINVALIDMEMBERTYPE - When an object is not a mamber of Resourcepool. EOBJECTAMBIGUOUS - When the specified object Name is ambiguous To denote whether its Filer or Aggregate. Try again with fully qualified Name or object Id. EDATABASEERROR - On database Error.

> Name | Type | Description
> MemberNameOrId | ObjNameOrId | Name or identifier of the member To modify in the Resource pool.
> ResourceTag | ResourceTag optional | Label for the Resource pool member.
> ResourcepoolNameOrId | ObjNameOrId | Name or identifier of the Resource pool.

Element definition: ResourcepoolModifyMemberResult | [top]

> [none]

Element definition: ResourcepoolModifyResult | [top]

> [none]

Element definition: ResourcepoolRemoveMember | [top]

> Remove member -- storage system or Aggregate -- From a Resource pool. Error Conditions: EACCESSDENIED - When the user does not have DFM.Database.Delete Capability on the specified Resource pool or DFM.Database.Read Privilege on the object being removed. ERESOURCEPOOLDOESNOTEXIST - When the specified Resource pool does not exist. EOBJECTNOTFOUND - When the specified object To remove not found. EOBJECTAMBIGUOUS - When the specified object Name is ambiguous To denote whether its storage system or Aggregate. Try again with fully qualified Name or object Id. EOBJECTNOTINRESOURCEPOOL - When the specified object does not exist in the Resource pool. EDATABASEERROR - On database Error.

> Name | Type | Description
> MemberNameOrId | xsd:string | Name or identifier of member To remove From the Resource pool. Possible Values are name/id of storage system or Aggregate. It should be a valid DFM object Name or object Id. A valid DFM object Name should contain at least one non-numeric character. A valid DFM object Id should be in the range of [1..2^31-1].
> ResourcepoolNameOrId | xsd:string | Name or identifier of the Resource pool To modify. It should be a valid DFM object Name or object Id. A valid DFM object Name should contain at least one non-numeric character. A valid DFM object Id should be in the range of [1..2^31-1].

Element definition: ResourcepoolRemoveMemberResult | [top]

> [none]

Element definition: ResourcepoolUpdateFreeSpaceStatus | [top]

> Check the free space in the Resource pool against the nearly-full and full Thresholds and generate appropriate Events for the Resource pool.

> Name | Type | Description
> ResourcepoolNameOrId | ObjNameOrId | Name or identifier of Resource pool

Element definition: ResourcepoolUpdateFreeSpaceStatusResult | [top]

> [none]

Element definition: ArrayOfLicense | [top]

> Name | Type | Description
> License | License[] |

Element definition: ArrayOfResourcepoolInfo | [top]

> Name | Type | Description
> ResourcepoolInfo | ResourcepoolInfo[] |

Element definition: ArrayOfResourcepoolMemberInfo | [top]

> Name | Type | Description
> ResourcepoolMemberInfo | ResourcepoolMemberInfo[] |

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

> Details specific To the 'provision_member' Request.

> Name | Type | Description
> Comments | ArrayOfProvisionMemberComment optional | Comment Values To assign To the newly provisioned storage object.
> CreateNewVfiler | xsd:boolean optional | True, if new vFiler Unit needs To be created during provisioning. The provisioned storage container is then moved To the vFiler Unit. This input is applicable only in the context of ResourcepoolMemberListInfoIterStart zapi and RunProvisioningChecks is specified as 'true'. This input is ignored in DatasetProvisionMember and StorageServiceDatasetProvision zapi. The default Value is 'false'.
> DatasetExportInfo | DatasetExportInfo optional | Specifies the NAS or SAN export settings for the the provisioning member. Member level export settings cannot be specified, if export settings have been configured at node level.
> Description | xsd:string optional | Description of the provisioning Request. The Length of this string cannot be more than 255 characters.
> InitialSnapshotSpace | xsd:integer optional | Applicable when provisioning Members in SAN data sets (i.e. Datasets associated with provisioning Policy of Type 'san'). Specify the initial disk space in bytes that needs To be allocated upfront for Snapshot copies of the member. Range: [1..2^63-1]
> MaximumDataSize | xsd:integer optional | Maximum storage space for the Dataset member. Applicable when provisioning Members in NFS data sets (i.e. Datasets associated with provisioning Policy of Type 'nas' and export over 'NFS' Protocol). Storage clients can write data up To this limit if the containing Aggregate has space. The Value is specified in bytes. Range: [1..2^63-1]
> MaximumSnapshotSpace | xsd:integer optional | Applicable when provisioning Members in SAN data sets (i.e. Datasets associated with provisioning Policy of Type 'san'). Specify the Maximum disk space in bytes for the Snapshot copies of the member. Once the space consumed by Snapshot copies reaches this Value, further Snapshot copies will fail. Range: [1..2^63-1]
> Name | xsd:string | Name of the storage container. If this is a NAS Dataset, i.e the provisioning Policy associated with the primary node of the Dataset is of Type 'nas', then this Name corresponds To the Qtree or Volume created. If this is a SAN Dataset, i.e the provisioning Policy associated with the primary node of the Dataset is of Type 'san', then this Name corresponds To the LUN or Volume that will be provisioned as part of this Request. The Length of this string cannot be more than 255 characters.
> OnlineMigration | xsd:boolean optional | Indicates whether pre checks related To online migration has To be performed on the storage system during provisioning. This input is applicable only in the context of ResourcepoolMemberListInfoIterStart API and RunProvisioningChecks is specified as true and either CreateNewVfiler is true or VfilerNameOrId is specified. This input is ignored in StorageServiceDatasetProvision and DatasetProvisionMember APIs.
> ProvisioningPolicyId | ObjId optional | Name or identifier of the provisioning Policy used with this Request. Ignored for DatasetProvisionMember and StorageServiceDatasetProvision and is used only when listing provisioning requests and Jobs.
> ProvisioningPolicyName | ObjFullName optional | Name of the provisioning Policy used with this Request. Present only if the Request Type is 'provision_member'. Ignored for DatasetProvisionMember and StorageServiceDatasetProvision and is used only when listing provisioning requests and Jobs.
> ResourceNameOrId | ObjNameOrId optional | Name or identifier of the Resource object From which storage space will be provisioned. valid types of Objects are:- Filer Aggregate The Filer or Aggregate specified should belong To the Resource pool(s) associated with primary node of the Dataset.
> Size | xsd:integer | Amount of storage space for data. Whether this space has To allocated on demand or reserved upfront From an Aggregate in Resource pool is decided based on the provisioning Policy settings. The Value is specified in bytes. Range: [1..2^63-1]
> VfilerNameOrId | ObjNameOrId optional | Name or Id of the vFiler Unit, if specified the newly provisioned Dataset member will be moved To the specified vFiler Unit and accessed via the vFiler Unit's IP addresses. Ignored for StorageServiceDatasetProvision.

Element definition: ResourceTag | [top]

> Label for the Resource. Can be of Maximum 255 characters.

> [none]

Element definition: ResourcepoolDefaults | [top]

> The default Values of the Attributes defined by this ZAPI.

> Name | Type | Description
> ResourcepoolFullThreshold | xsd:integer optional | The Value (as an integer percentage) of the fullness threshold used To generate a "Resource pool full" event for this Resource pool. Setting threshold percentages higher than 100% allows an administrator To set it in such a way so that it never trigger these Events. Range: [0..1000]
> ResourcepoolNearlyFullThreshold | xsd:integer optional | The Value (as an integer percentage) of the fullness threshold used To generate a "Resource pool nearly full" event for this Resource pool. Setting threshold percentages higher than 100% allows an administrator To set it in such a way so that it never trigger these Events. Range: [0..1000]

Element definition: StorageReliability | [top]

> NetApp Storage Systems offer a wide range of storage availability features which provide protection against various failure like disk drive failures, shelf failures, controller failures or site failures. The required level of reliability of the Dataset can be specified in the provisioning Policy.

> Name | Type | Description
> ControllerFailure | xsd:boolean optional | Resiliency against single controller failure, i.e the Dataset can be accessed even after a controller fails. Maps To active/active pair. Default Value is "false".
> DiskFailure | xsd:string optional | Resiliency against disk failures, possible Values are "single" (Maps To RAID-4 Aggregates), "double" (Maps To RAID-DP Aggregates) or "any"(either RAID-4 or RAID-DP). Default Value is "double".
> SubSystemFailure | xsd:boolean optional | Resiliency against storage sub system failures (or back end failures) like disk shelf, disk shelf adapters, failure of FCAL loops. Maps To "SyncMirror" Aggregates. Default Value is "false".

Element definition: WrapperOfResourcepoolInfo | [top]

> Name | Type | Description
> ResourcepoolInfo | ResourcepoolInfo |

Element definition: ArrayOfProvisionMemberComment | [top]

> Name | Type | Description
> ProvisionMemberComment | ProvisionMemberComment[] |

Element definition: DatasetExportInfo | [top]

> Specifies the NAS or SAN export settings for a Dataset node.

> Name | Type | Description
> DatasetCifsExportSetting | DatasetCifsExportSetting optional | The CIFS export settings for storage exported over CIFS. This field may be present only if the DatasetExportProtocol is 'cifs' or 'mixed'.
> DatasetExportProtocol | DatasetExportProtocol optional | Specifies the Protocol over which Members of the Dataset node will be exported. This Value is always returned. If omitted during a modify Operation, the existing Value is not changed. If specified as 'none' in a modify Operation, the existing settings will be cleared. Default Value is 'none'. Depending on the export Protocol, dataset-lun-mapping, or a combination of DatasetNfsExportSetting and DatasetCifsSharePermissions, should be specified in a modify Operation, and will be returned in the iterator output.
> DatasetLunMappingInfo | DatasetLunMappingInfo optional | Specifies the Hosts and/or Initiators To which LUNs in this Dataset node will be mapped, and the igroup OS Type. This field may be present only if the DatasetExportProtocol is 'fcp' or 'iscsi'.
> DatasetNfsExportSetting | DatasetNfsExportSetting optional | The NFS export settings for storage exported over NFS. This field may be present only if the DatasetExportProtocol is 'nfs' or 'mixed'.

Element definition: License | [top]

> Name of the licensed Data ONTAP Service. Possible Values: "nfs", "cifs", "iscsi", "fcp", "multistore", "a_sis", "snapmirror_sync".

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

> Information about a Resource pool.

> Name | Type | Description
> AggregateNearlyOvercommittedThreshold | xsd:unsignedShort optional | The Value (as an integer percentage) of the fullness threshold used To generate an "Resourcepool nearly overcommitted" event for all the Resource pools. If the Value specified is empty, then the setting is cleared and the Value specified in global Options for aggrNearlyOvercommittedThreshold will be used. Range: [0..65535]
> AggregateOvercommittedThreshold | xsd:unsignedShort optional | The Value (as an integer percentage) of the fullness threshold used To generate an "Resourcepool overcommitted" event for all the Resource pools. If the Value specified is empty, then the setting is cleared and the Value specified in global Options for aggrOvercommittedThreshold will be used. Range: [0..65535]
> ResourceTag | ResourceTag optional | A label that can be associated with a Resource pool.
> ResourcepoolContact | EmailAddressList optional | Contact information for the Resource pool, such as the owner's e-mail Address. This is modifiable.
> ResourcepoolDescription | xsd:string optional | Description of the Resource pool, up To 255 characters long. This is modifiable.
> ResourcepoolFreeVfilers | xsd:unsignedLong optional | The number of vFiler units that can be created in this Resource pool based on the current limit and number of vFiler units present in the storage systems that are Members of the Resource pool. Ignored for ResourcepoolCreate and ResourcepoolModify. Range: [0..2^64-1].
> ResourcepoolFullThreshold | xsd:integer optional | The Value (as an integer percentage) of the fullness threshold used To generate a "Resource pool full" event for this Resource pool. If the Value specified is empty, then the Resource pool setting is cleared and the Value specified in ResourcepoolGetDefaults is used. Range: [0..1000]
> ResourcepoolId | xsd:integer optional | Identifier of the Resource pool. Its a valid DFM object Id. A valid DFM object Id would be in the range of [1..2^31-1]. Ignored for ResourcepoolCreate and ResourcepoolModify.
> ResourcepoolIsProvisionable | xsd:boolean optional | This is returned in ResourcepoolListInfoIterNext if LicenseFilter, ResourceTag or reliability information is passed in the input, this is set To true or false depending on whether the Resource pool meets all the three filters, Default Value is set To TRUE.
> ResourcepoolKbytesAvailable | xsd:integer optional | Amount of Kbytes of storage available in this Resource pool. This Value only present if IncludeFreeSpace was true. Ignored for ResourcepoolCreate and ResourcepoolModify. Range: [0..2^63-1].
> ResourcepoolKbytesTotal | xsd:integer optional | Total amount of Kbytes of storage in this Resource pool. This Value only present if IncludeFreeSpace was true. Ignored for ResourcepoolCreate and ResourcepoolModify. Range: [0..2^63-1].
> ResourcepoolKbytesUsed | xsd:integer optional | Amount of Kbytes of storage used in this Resource pool. This Value only present if IncludeFreeSpace was true. Ignored for ResourcepoolCreate and ResourcepoolModify. Range: [0..2^63-1].
> ResourcepoolMemberCount | xsd:integer optional | The Count of direct Members added To the Resource pool. This includes number of storage systems and Aggregates added To the Resource pool. Ignored for ResourcepoolCreate and ResourcepoolModify. Range: [0..2^31-1]
> ResourcepoolName | xsd:string optional | Name of the Resource pool. This is modifiable. This must be specified in ResourcepoolCreate. Its a valid DFM object Name. A valid DFM object Name would contain at least one non-numeric character.
> ResourcepoolNearlyFullThreshold | xsd:integer optional | The Value (as an integer percentage) of the fullness threshold used To generate a "Resource pool nearly full" event for this Resource pool. If the Value specified is empty, then the Resource pool setting is cleared and the Value specified in ResourcepoolGetDefaults is used. Range: [0..1000]
> ResourcepoolOwner | xsd:string optional | Name of the owner of the Resource pool, up To 255 characters long. This is modifiable.
> ResourcepoolPerfStatus | ObjStatus optional | Current performance Status of the Resource pool. Ignored for ResourcepoolCreate and ResourcepoolModify.
> ResourcepoolSpaceStatus | xsd:string optional | Space Status of the Resource pool. Possible Values are: ok : Sum of used space of all Aggregates in the Resource pool against the sum of Total Size of all Aggregates has not reached or crossed ResourcepoolNearlyFullThreshold and none of the member Aggregates have reached or crossed their full Thresholds. member_nearly_full : Atleast one of the member Aggregates of the Resource pool has reached or crossed its nearly full threshold. nearly_full : Sum of used space of all Aggregates in the Resource pool against the sum of Total Size of all Aggregates has reached or crossed ResourcepoolNearlyFullThreshold. member_full : Atleast one of the member Aggregates of the Resource pool has reached or crossed its full threshold. full : Sum of used space of all Aggregates in the Resource pool against the sum of Total Size of all Aggregates has reached or crossed ResourcepoolFullThreshold. ResourcepoolSpaceStatus is returned only if IncludeFreeSpace is true in ResourcepoolListInfoIterStart .
> ResourcepoolStatus | ObjStatus optional | Current Status of the Resource pool. Ignored for ResourcepoolCreate and ResourcepoolModify.
> ResourcepoolTimezone | xsd:string optional | Time zone in which this pool's storage is located. This is modifiable. An empty Value means To use the system default (usually GMT). Currently valid time zones can be listed by TimezoneListInfoIterStart.

Element definition: ResourcepoolMemberInfo | [top]

> Information about one member of a Resource pool.

> Name | Type | Description
> DatasetsSpaceInfo | ArrayOfDatasetSpaceInfo optional | Space used by each Dataset in the Aggregate. Returned only when MemberType is 'Aggregate' and if IncludeDatasetSpaceInfo is set To true in ResourcepoolMemberListInfoIterStart.
> MemberCommittedSpace | xsd:integer | Committed space of the member.
> MemberId | xsd:integer | Identifier of the member. Its a valid DFM object Id. A valid DFM object Id would be in the range of [1..2^31-1].
> MemberName | xsd:string | Display Name of the member. Its a valid DFM object Name. A valid DFM object Name would contain at least one non-numeric character.
> MemberSize | xsd:integer | Total Size of the member.
> MemberSpaceStatus | ObjectSpaceStatus optional | Space Status of the Resource pool member. 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. This Value is returned only when MemberType is 'Aggregate'.
> MemberStatus | xsd:string | Current Status of the member. Possible Values are 'normal', 'information', 'unknown', 'warning', 'Error', 'critical', 'emergency'.
> MemberType | xsd:string | Type of the member. Possible Values are 'Filer' or 'Aggregate'.
> MemberUsedSpace | xsd:integer | Used space of the member.
> ProvisioningChecksPassed | xsd:boolean optional | Set To true, if all the member passes all the provisioning related checks for given provisioning Policy and provisioning Request. Applicable only when RunProvisioningChecks is set To true at the start of iteration.
> ResourceTag | ResourceTag optional | A label for a Resource pool member.

Element definition: ArrayOfDatasetSpaceInfo | [top]

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

Element definition: DatasetCifsExportSetting | [top]

> If storage inside this Dataset node is exported over CIFS, this specifies some of the common Properties that will be applied To all such provisioned storage.

> Name | Type | Description
> CifsDomain | xsd:string optional | Name of the CIFS domain. If present, then only filers or vFilers belonging To this CIFS domain is considered for provisioning. If not present, then any Filer is picked. Up To 255 characters.
> DatasetCifsSharePermissions | ArrayOfDatasetCifsSharePermission optional | Specifies the permissions granted To users on storage provisioned in this Dataset node. This field may be present only if the DatasetExportProtocol is 'cifs' or 'mixed'.

Element definition: DatasetExportProtocol | [top]

> Specifies the export protocols that Members in this Dataset node will be exported over. Possible Values are 'nfs', 'cifs', 'mixed', 'fcp', 'iscsi' and 'none'. Specifying 'mixed' implies that the storage in the Dataset should be exported over both NFS and CIFS.

> [none]

Element definition: DatasetLunMappingInfo | [top]

> Specifies the Hosts and/or Initiators To which LUNs in this Dataset node will be mapped, and the igroup OS Type.

> Name | Type | Description
> IgroupOsType | xsd:string | Specifies the OS Type for Initiators To map LUNs in the Dataset node To. Possible Values are: 'windows', 'windows_gpt', 'windows_2008', 'hpux', 'aix, 'linux, 'solaris', 'vmware', 'netware', 'hyper_v', 'xen', 'solaris_efi', and 'openvms' Here "windows_gpt" refers To Windows using GPT (GUID Partition Type) partitioning style and "windows_2008" refers To Windows Longhorn systems.
> LunMappingInitiators | ArrayOfLunMappingInitiator | Specifies the Initiators To map LUNs in the Dataset node To, and, optionally, the Host To which they belong.

Element definition: DatasetNfsExportSetting | [top]

> If storage inside this Dataset node is exported over NFS, this specifies some of the common Properties that will be applied To all such provisioned storage.

> Name | Type | Description
> AnonymousAccessUser | xsd:integer optional | If the client accessing the export is not present in the root access list for the export, the effective user for root is the Value specified for this field. Default Value is 65534 which maps To user nobody. It could be an integer Range: [0..65534] or a user Name not more than 255 characters.
> DisableSetuid | xsd:boolean optional | If true, causes the server file system To ignore attempts To enable the setuid or setgid mode bits. Default Value is true.
> IsReadonlyForAllHosts | xsd:boolean optional | Specifies that all Hosts receive read-only permissions on nfs exports in this Dataset node. Equivalent To specifying "ro" on the Filer. Default Value is false. If true, IsReadwriteForAllHosts must be false.
> IsReadwriteForAllHosts | xsd:boolean optional | Specifies that all Hosts receive read-write permissions on nfs exports in this Dataset node. Equivalent To specifying "rw" on the Filer. Default Value is false. If true, IsReadonlyForAllHosts must be false.
> NfsExportRoHosts | ArrayOfNfsExportHost optional | A list of Hosts with read-only permissions on exports in this Dataset node. If a non empty list of NfsExportRoHosts is present along with IsReadonlyForAllHosts as true, then ZAPI will throw an Error.
> NfsExportRootHosts | ArrayOfNfsExportHost optional | A list of Hosts with the root user having read-only or read-write permissions on exports in this Dataset node.
> NfsExportRwHosts | ArrayOfNfsExportHost optional | A list of Hosts with read-write permissions on exports in this Dataset node. If a non empty list of NfsExportRwHosts is present along with IsReadwriteForAllHosts as true, then ZAPI will throw an Error.
> NfsProtocolVersion | xsd:string optional | NFS Protocol Version, valid Values are "v2", "v3" and "v4". Default Value is "v3". If set, the storage systems that have the given Version enabled will be selected To provision storage for the Dataset.
> NfsSecurityFlavors | ArrayOfNfsSecurityFlavor optional | List of strings specifying the security flavors supported on exports in this Dataset node. If this field is not specified, the default Value of 'sys' is assumed.

Element definition: EmailAddressList | [top]

> A list of email addresses. If more than one email Address is specified, the addresses must be seperated by a ','. Spaces (and other white space) are not allowed, either between addresses or in them. Unprintable characters are also invalid. The list may contain up To 255 characters.

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

> One comment field To fill in as part of the Request

> Name | Type | Description
> CommentFieldNameOrId | CommentFieldNameOrId | Name or identifier of the comment field.
> CommentValue | CommentValue | Value of the comment field. An empty string can be used To unset the Value of the comment field for this object.

Element definition: ArrayOfDatasetCifsSharePermission | [top]

> Name | Type | Description
> DatasetCifsSharePermission | DatasetCifsSharePermission[] |

Element definition: ArrayOfLunMappingInitiator | [top]

> Name | Type | Description
> LunMappingInitiator | LunMappingInitiator[] |

Element definition: ArrayOfNfsExportHost | [top]

> Name | Type | Description
> NfsExportHost | NfsExportHost[] |

Element definition: ArrayOfNfsSecurityFlavor | [top]

> Name | Type | Description
> NfsSecurityFlavor | NfsSecurityFlavor[] |

Element definition: CommentFieldNameOrId | [top]

> Name or identifier of the comment field. It must conform To one of the following formats: It must be of the format of CommentFieldName It must be of the format of CommentFieldId

> [none]

Element definition: CommentValue | [top]

> Value of the specified comment field To be set on the object. This can be of Maximum 1024 characters.

> [none]

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

> A single Permission granted To a user on CIFS shares within a Dataset node.

> Name | Type | Description
> CifsUsername | xsd:string | Name of a user in the specified domain. The Username may be the Name of an actual domain user or one of the built-in names - 'administrator' or 'everyone'.
> Permission | CifsPermission | Specifies the permissions granted To a user.

Element definition: LunMappingInitiator | [top]

> Specifies an initiator To map LUNs in the Dataset node To, and, optionally, the Host To which it belongs.

> Name | Type | Description
> Hostname | xsd:string optional | Specifies the Name of the Host which owns the initiator.
> InitiatorId | InitiatorId | Specifies an initiator Id on a Host To which a LUN should be mapped.

Element definition: NfsExportHost | [top]

> Specifies a single Host or all-hosts. A Host can be a Host Name (DNS Name), an IP Address, a subnet or a domain Name. If an 'all-hosts' entry is present, all other Host Name entries must be negated.

> Name | Type | Description
> Hostname | xsd:string optional | Specifies a single Host Name entry. A Host Name may be a DNS Name, an IP Address, a subnet (specified as <subnet Address>/<prefix Length> i.e. CIDR notation or '[network] <subnet-address> [netmask] <Netmask>'), a domain, or a workgroup.
> IsAnException | xsd:boolean optional | Specifies that the rule does not apply To this Host. Should be used when it is required To grant permissions To Hosts in a subnet or a domain or all Hosts excluding some. Default Value is false.

Element definition: NfsSecurityFlavor | [top]

> A security flavor To be applied on nfs exports. Possible Values are 'none', 'sys' (Unix Style), 'krb5' (Kerberos v5) , krb5i' (Kerberos v5 integrity) and 'krb5p' (Kerberos v5 privacy). Default Value is 'sys'.

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

> Permission granted To a CIFS user on a share. Possible Values are 'no_access', 'read', 'change' and 'full_control'

> [none]

Element definition: InitiatorId | [top]

> For FCP Initiators, this is a string composed of 16 hexadecimal digits. For iSCSI Initiators, this is an initiator Name in the dotted-domain notation.

> [none]