|
APIs in Category: Resourcepool |
API version 4.0 |
ResourcepoolAddMember |
A Resource pool typically describes physical resources such as spare Disks, Aggregates or storage systems which are used for provisioning. |
| 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: 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.
- 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].
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 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:- The Filer or Aggregate specified should belong To the Resource pool(s) associated with primary node of the Dataset.
- Filer
- Aggregate
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: ResourcepoolSpaceStatus is returned only if IncludeFreeSpace is true in ResourcepoolListInfoIterStart .
- 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.
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' and 'netware'. 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'.
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.
- 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.
[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: 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:
- 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.
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 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.
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]