Input Name	Range	Type	Description
dry-run		boolean validate optional	Indicates whether a dry run needs to be done of all the tasks to be performed as part of migrate-cancel operation. Default value is false.
object-name-or-id		obj-name-or-id	Full name or identifier of the vFiler unit or dataset whose migration operation has to be cancelled. The migration status of the vFiler unit or the vFiler unit attached to the specified dataset should be either "migrating" or "migrate_failed".
Output Name	Range	Type	Description
dry-run-results		dry-run-result[] optional	Results of a dry run. Each result describes one action the system would take and the predicted effects of that action. Only returned if dry-run is true.
job-id		integer optional	Identifier of the job started to cancel the migration operation. only returned if dry-run is false.

Errno	Description
EDATABASEERROR
EACCESSDENIED
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND
EINVALIDMIGRATIONSTATUS

Change the state of a migration operation initiated for a vFiler unit or dataset. Only the following state changes are allowed through this API: Change from "migrated" to "not_started": This is used to retain stale storage on the source hosting storage system and migrating a vFiler unit again. Change from "migrated_with_errors" to "migrated": This is used to change the state after going through the errors that occured after cutover and correcting them as necessary. Change from "rolledback_with_errors" to "rolledback": This is used to change the state after going through the errors that occured after cutover and correcting them as necessary. Error conditions: EDATABASEERROR - A database error occurred while processing the request. EACCESSDENIED - User does not have required capabilities to initiate the migrate operation. If object-name-or-id refers to a dataset, user should have DFM.Dataset.Write on the datset. If object-name-or-id refers to a vFiler unit, user should have DFM.Resource.Control on the dataset. EOBJECTAMBIGUOUS - When the specified object name is ambiguous. EOBJECTNOTFOUND - When the specified vFiler unit or dataset is not found. EINVALIDMIGRATIONSTATUS - When the migration status change is not allowed. EINVALIDINPUT - Invalid input specified.

Input Name	Range	Type	Description
new-migration-status		migration-status	The new migration status for the vFiler unit or dataset.
object-name-or-id		obj-name-or-id	Full name or identifier of the vFiler unit or dataset whose migration status has to be changed.

Errno	Description
EDATABASEERROR
EACCESSDENIED
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND
EINVALIDINPUT
EINVALIDMIGRATIONSTATUS

Delete the stale storage associated with a migration operation from the source storage system. This will destroy all the volumes of the source vFiler unit after successful migration of the vFiler unit. Error conditions: EDATABASEERROR - A database error occurred while processing the request. EACCESSDENIED - User does not have required capabilities to initiate the migrate operation. If object-name-or-id refers to a dataset, user should have DFM.Dataset.Write on the datset. If object-name-or-id refers to a vFiler unit, user should have DFM.Resource.Control on the dataset. EOBJECTAMBIGUOUS - When the specified object name is ambiguous. EOBJECTNOTFOUND - When the specified vFiler unit or dataset is not found. EINVALIDMIGRATIONSTATUS - When the migration status of the specified vFiler unit is such that migrate-cleanup operation cannot be initiated.

Input Name	Range	Type	Description
dry-run		boolean optional	A dry-run flag that indicates to show a dry-run result of the volumes that will be destroyed as part of this cleanup operation from the source storage system. Default is false.
object-name-or-id		obj-name-or-id	Full name or identifier of the vFiler unit or the dataset whose stale storage has to be cleaned up. The migration status of the vFiler unit or the vFiler unit attached to the dataset should be "migrated".
Output Name	Range	Type	Description
dry-run-results		dry-run-result[] optional	Results of a dry run. Each result describes one action the system would take and the predicted effects of that action. Only returned if dry-run is true.
job-id		integer optional	Identifier of the job started to cleanup storage after the migration operation. Returned only when dry-run is false.

Errno	Description
EDATABASEERROR
EACCESSDENIED
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND
EINVALIDMIGRATIONSTATUS

Complete the migration operation by doing a cutover from the source vFiler unit to destination vFiler unit. As part of cutover operation the following will be done: A script if specified, will be run in pre mode. The actual cutover will be carried out so that the source vFiler unit is destroyed and data will be served from the destination vFiler unit. The script if specified, will be run in post mode after successful cutover. For all volumes of the vFiler unit, the protection relationships will be migrated to the new destination. All the backup versions will be modified so that they point appropriately to the newly created destination volumes. The migration status is changed to 'migrated' after a successful completion of migration. If migrate-complete fails to cutover to destination storage, then the migration status is changed to 'migrate-failed'. If the cutover to the destination storage succeeds during completion, but some of the subsequent steps like migrating the protection relationships, or copying the history data fails, then the status is changed to 'migrated-with-errors'. Error conditions: EDATABASEERROR - A database error occurred while processing the request. EACCESSDENIED - User does not have required capabilities to initiate the migrate operation. If object-name-or-id refers to a dataset, user should have DFM.Dataset.Write on the datset. If object-name-or-id refers to a vFiler unit, user should have DFM.Resource.Control on the dataset. EOBJECTAMBIGUOUS - When the specified object name is ambiguous. EOBJECTNOTFOUND - When the specified vFiler unit or dataset is not found. EINVALIDMIGRATIONSTATUS - When the specified vFiler unit is not in "migrating" status. EONLINENOTPOSSIBLE - When online migration cannot be performed, but offline migration is still possible.

Input Name	Range	Type	Description
dry-run		boolean optional	A dry-run flag that indicates to show a dry-run result of the migrate-complete operation. Default is false.
max-cutover-time		integer optional	The value provided will be in seconds and this value defines, the time by which non-disruptive migration should complete. Default value is 120 seconds. Range [120..1800].
migrate-offline		boolean optional	This flag is considered only when migration is started as online migration. When true, offline migration is performed. If false or not specified online migration is performed. This flag is ignored if the migration is not online. Default value is false.
object-name-or-id		obj-name-or-id	Full name or identifier of the vFiler unit or the dataset for which the migration operation has to be completed. For a migrate-complete operation, the source vFiler unit should be given as input. The migration status of the vFiler unit or the vFiler unit attached to the dataset should be "migrating".
persistent-migrated-routes		boolean optional	If this option is set, then the migrated routes from the source will be made persistent on the destination storage system. This input is ignored, if the route-migration-mode is 'none'. Default value is true.
route-migration-mode		route-migration-mode optional	Type of routes that needs to be migrated as part of cutover.
run-dedupe-scan		boolean optional	Indicates whether a full deduplication scan has to be run on the deduplication enabled volumes of the migrating vFiler unit on destination storage system after migration. This input is valid only for volumes in the vFiler unit which have deduplication turned on and ignored for other volumes. Default is true.
script-path		string optional	Path to a script that will be run in pre and post mode just before and after cutover operation.
Output Name	Range	Type	Description
dry-run-results		dry-run-result[] optional	Results of a dry run. Each result describes one action the system would take and the predicted effects of that action. Only returned if dry-run is true.
job-id		integer optional	Identifier of the job started to carry out the complete operation. Returned only when dry-run flag is false.

Errno	Description
EDATABASEERROR
EACCESSDENIED
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND
EINVALIDMIGRATIONSTATUS
EONLINENOTPOSSIBLE

Fix the migration status of a dataset. This API should be called if migration job was aborted abnormally, due to server shutdown or machine reboot etc. It fixes the database entries and migration status of the dataset. It can be called only if the last migration job run on the dataset terminated abnormally. Error conditions: EDATABASEERROR - A database error occurred while processing the request. EACCESSDENIED - User does not have required capabilities to initiate the migrate operation. If object-name-or-id refers to a dataset, user should have DFM.Dataset.Write on the datset. If object-name-or-id refers to a vFiler unit, user should have DFM.Resource.Control on the dataset. EOBJECTAMBIGUOUS - When the specified object name is ambiguous. EOBJECTNOTFOUND - When the specified vFiler unit or dataset is not found. EINVALIDINPUT - Invalid input specified.

Input Name	Range	Type	Description
dataset-name-or-id		obj-name-or-id optional	Full name or identifier of the dataset for which migration job was terminated abnormally. This field is deprecated now and object-name-or-id field should be used. This field will be ignored if object-name-or-id is specified.
object-name-or-id		obj-name-or-id optional	Name of Id of the dataset/vfiler for which migration job was terminated abnormally.
Output Name	Range	Type	Description
job-id		integer	Identifier of the job started to fix the previous crashed/stopped vFiler unit migration.

Errno	Description
EDATABASEERROR
EACCESSDENIED
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND
EINVALIDMIGRATIONSTATUS

Rollback the previous migrated vFiler unit from the destination vFiler unit to it's original source vFiler unit. As part of rollback operation the following will be done: A script if specified, will be run in pre mode. Rollback will be carried out so that the destination vFiler unit is destroyed and data will be served from the source vFiler unit. The script if specified, will be run in post mode after successful cutover. For all volumes of the vFiler unit, the protection relationships will be migrated to the new destination. All the backup versions will be modified so that they point appropriately to the newly created source volumes. The migration status is changed to 'rolled_back' after a successful rollback. If migrate-rollback fails to cutover to source storage, then the migration status will be changed to 'migrated'. If the cutover to the source storage succeeds during rollback, but some of the subsequent steps like migrating the protection relationships, or copying the history data fails, then the status is changed to 'rolled_back_with_errors'. Error conditions: EDATABASEERROR - A database error occurred while processing the request. EACCESSDENIED - User does not have required capabilities to initiate the migrate operation. If object-name-or-id refers to a dataset, user should have DFM.Dataset.Write on the datset. If object-name-or-id refers to a vFiler unit, user should have DFM.Resource.Control on the dataset. EOBJECTAMBIGUOUS - When the specified object name is ambiguous. EOBJECTNOTFOUND - When the specified vFiler unit or dataset is not found. EONLINENOTPOSSIBLE - When online migration cannot be performed, but offline migration is still possible.

Input Name	Range	Type	Description
dry-run		boolean validate optional	Indicates whether a dry run needs to be done of all the tasks to be performed as part of migrate-rollback operation. Default value is false.
max-cutover-time		integer optional	The value provided will be in seconds and this value defines, the time by which non-disruptive migration should complete. Default value is 120 seconds. Range [120..1800].
migrate-offline		boolean optional	This flag is considered only when cutover was done as online migration. When true, offline migration is performed. If false or not specified online migration is performed. The flag is ignored if the migration is not online. Default value is false.
object-name-or-id		obj-name-or-id	Full name or identifier of the vFiler unit or dataset whose migration operation has to be rolled back. The migration status of the vFiler unit or the vFiler unit attached to the specified dataset should be in "migrated".
persistent-migrated-routes		boolean optional	If this option is set, then the migrated routes from the source will be made persistent on the destination storage system. This input is ignored, if the route-migration-mode is 'none'. Default value is true.
route-migration-mode		route-migration-mode optional	Type of routes that needs to be migrated as part of cutover.
run-dedupe-scan		boolean optional	Indicates whether a full deduplication scan has to be run on the deduplication enabled volumes of the migrating vFiler unit on source storage system after migration. This input is valid only for volumes in the vFiler unit which have deduplication turned on and ignored for other volumes. Default is true.
script-path		string optional	Path to a script that will be run in pre and post mode just before and after rollback operation.
Output Name	Range	Type	Description
dry-run-results		dry-run-result[] optional	Results of a dry run. Each result describes one action the system would take and the predicted effects of that action. Only returned if dry-run is true.
job-id		integer optional	Identifier of the job started to rollback the migration operation. Returned only when dry-run is false. Range [1..2^31-1].

Errno	Description
EDATABASEERROR
EACCESSDENIED
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND
EINVALIDMIGRATIONSTATUS
EONLINENOTPOSSIBLE

Start the migration operation for a dataset or a vFiler unit. This initiates a baseline transfer for all the volumes in the source vFiler unit and changes the migration status to 'migrating'. When a dataset is given as input then the following conditions should hold good: A vFiler unit should be attached to the primary node of the dataset. All the volumes of the vFiler unit with the exception of the root storage should belong to this dataset. For offline migration, the migrating vFiler unit may contain qtree as it's root storage. For online migration, the migrating vFiler unit should contain a volume as it's root storage. If any of these conditions are not met, then EMIGRATENOTSUPPORTED is returned. If perform-cutover is set to true, then migrate-complete will be done after migrate-start. Error conditions: EDATABASEERROR - A database error occurred while processing the request. EACCESSDENIED - User does not have required capabilities to initiate the migrate operation. If object-name-or-id refers to a dataset, user should have DFM.Dataset.Write on the datset. If object-name-or-id refers to a vFiler unit, user should have DFM.Resource.Control on the dataset. If resource-name-or-id refers to a resource pool, user should have DFM.ResourcePool.Provision on it. If resource-name-or-id refers to a storage system, user should have DFM.Resource.Control on it. If provisioning-policy-name-or-id is specified, user should have DFM.Policy.Read on it. EOBJECTAMBIGUOUS - When the specified object name is ambiguous. EOBJECTNOTFOUND - When the specified vFiler unit, dataset, destination storage system or provisioning policy is not found. EINVALIDMEMBERTYPE - When the specified filer is in c-mode. EINVALIDINPUT - When invalid inputs are provided for IP Address, Netmask. EINVALIDMIGRATIONSTATUS - When the specified vFiler unit is already in "migrating" status or in a state where migration cannot be started. EMIGRATENOTSUPPORTED - When the dataset or source vFiler unit cannot be migrated due to various reasons like invalid vFiler status, ONTAP version. EMIGRATEDESTINATIONSELECTIONFAILED - When a suitable storage system is not found as a destination for migration.

Input Name	Range	Type	Description
bandwidth-throttle		integer optional	Specify the bandwidth throttle(in kbps) to be used for baseline transfer and subsequent SnapMirror updates. This element is valid only for online-migration. Default is 0 which means unlimited bandwidth for the transfers. Range: [1..2^31-1]
description		string optional	A short optional description of the migration activity. Default is an empty description. Range: [0..4096] characters.
dry-run		boolean validate optional	Indicates whether a dry run needs to be done of all the tasks to be performed as part of migrate-start operation. Default value is false.
ip-bindings		ip-binding-info[] optional	IP Address to interface binding information for the destination vFiler unit. If this element is not present, then the interface configured as the "defaultVFilerInterface" for the selected destination storage system is used to bind IP Addresses of the source vFiler unit at the destination.
object-name-or-id		obj-name-or-id	Full name or identifier of the vFiler unit or the dataset which has to be migrated. If the input element is a dataset, then a vFiler unit should be attached to the dataset and all the volumes of the vFiler unit should be members of the primary node of the dataset with the exception of the root storage. The vFiler unit will be migrated to a new storage system.
online-migration		boolean optional	Indicates, that cutover has to be performed non-disruptively. This input is considered only when a vFiler unit is migrated and ignored when object-name-or-id refers to a dataset. For datasets, the migration will be done in an online or offline mode depending on 'online-migration' attribute set on the dataset Default value is false.
perform-cutover		boolean optional	If this option is set to true, then migrate-complete will be done after migrate-start. If cutover fails because of some reason, then migrate status will be set to 'Migrating' and user can issue the migrate-complete zapi to perform the cutover. Default value is false.
persistent-migrated-routes		boolean optional	If this option is set, then the migrated routes from the source will be made persistent on the destination storage system. This input is ignored, if the route-migration-mode is 'none'. This option is valid if perform-cutover is set to true. Default value is true.
provisioning-policy-name-or-id		obj-name-or-id optional	Name or identifier of the provisioning policy to be used to provision destination volumes during migration. This input is valid only when object-name-or-id refers to a dataset. Default behavior is to use the current provisioning policy associated with the dataset or if not associated, to use the same volume configuration as that of the source vFiler unit.
resource-name-or-id		obj-name-or-id optional	Name or identifier of the destination storage system or resource pool to which the vFiler unit is to be migrated. If object-name-or-id refers to a dataset, this storage system should be a member of a resource pool on which the user has required capabilities. If object-name-or-id refers to a vFiler unit, this can refer to any destination storage system on which the user has required capabilities. The storage system should be running ONTAP version same or above the source storage system.
route-migration-mode		route-migration-mode optional	Type of routes that needs to be migrated as part of cutover. This option is valid if perform-cutover is set to true.
script-path		string optional	Path to a script that will be run in pre and post mode just before and after cutover operation. This is applicable only when perform-cutover is set to true.
volume-aggregate-map		volume-aggregate-pair[] optional	A list of (volume, aggregate) pairs. The volume is the vFiler volume being migrated. The aggregate is the aggregate on the destination storage system where this volume should be migrated to. This input is valid only when the object-name-or-id is a vFiler name or id. If both volume-aggregate-map and resource-name-or-id inputs are specified, an error will be reported.
Output Name	Range	Type	Description
dry-run-results		dry-run-result[] optional	Results of a dry run. Each result describes one action the system would take and the predicted effects of that action. Only returned if dry-run is true.
job-id		integer optional	The identifier of the job started to carry out the migrate-start operation. This field is returned only when dry-run is false.

Errno	Description
EDATABASEERROR
EACCESSDENIED
EOBJECTNOTFOUND
EOBJECTAMBIGUOUS
EINVALIDMEMBERTYPE
EINVALIDINPUT
EINVALIDMIGRATIONSTATUS
EMIGRATENOTSUPPORTED
EMIGRATEDESTINATIONSELECTIONFAILED

Update all the SnapMirror relationships of a vFiler unit for which migration operation has been initiated. Error conditions: EDATABASEERROR - A database error occurred while processing the request. EACCESSDENIED - User does not have required capabilities to initiate the migrate operation. If object-name-or-id refers to a dataset, user should have DFM.Dataset.Write on the datset. If object-name-or-id refers to a vFiler unit, user should have DFM.Resource.Control on the dataset. EOBJECTAMBIGUOUS - When the specified object name is ambiguous. EOBJECTNOTFOUND - When the specified vFiler unit or dataset is not found. EINVALIDMIGRATIONSTATUS - When the migration status of the vFiler unit is such that migrate-update cannot be called.

Input Name	Range	Type	Description
object-name-or-id		obj-name-or-id	Full name or identifier of the dataset or vFiler unit whose migration status is "migrating" and whose SnapMirror relationships are to be updated.
Output Name	Range	Type	Description
job-id		integer	Identifier of the job started to update the SnapMirror relationships for a vFiler unit migration.

Errno	Description
EDATABASEERROR
EACCESSDENIED
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND
EINVALIDMIGRATIONSTATUS

Migrate one or more volumes from one aggregate to another aggregate on the same or different storage system. Currently this API works only for secondary volumes i.e destinations of a Volume SnapMirror or Qtree SnapMirror relationships or if the volumes are SnapVault secondaries. In addition to the above, the following rules must be satisfied to be able to migrate volumes using this API :- The volume(s) should not have child clones (FlexClones). The volume(s) should not have NFS exports, CIFS shares or contain LUNs mapped to storage clients. The volumes(s) should be part of a dataset (i.e either imported into datasets, or provisioned by Protection Manager.) so that incoming and outgoing data protection relationships to and from the volumes are managed by Protection Manager. If the destination aggregate is not specified, then the system will automatically select an aggregate, based on the type of the volume, space requirements, provisioning and protection policy configuration associated with the dataset.

Input Name	Range	Type	Description
dry-run		boolean validate optional	Indicates whether a dry run needs to be done of all the tasks to be executed as part of migrating volumes. Default value is false.
migration-request-info		migration-request-info	Details of migration request for volumes.
Output Name	Range	Type	Description
migration-dry-run-results		migration-dry-run-result[] optional	Dry run results for migrating each individual volume. Only returned if dry-run is true.
migration-jobs		migration-job-info[] optional	Job identifiers of migration jobs for each volume. Only returned if dry-run is false.

Errno	Description
EDATABASEERROR
EACCESSDENIED
EOBJECTNOTFOUND
EOBJECTAMBIGUOUS
EINVALIDINPUT
EMIGRATENOTSUPPORTED
EMIGRATEDESTINATIONSELECTIONFAILED
EDATASETBUSY

A description of one action and the predicted effects of taking that action.

Name	Range	Type	Description
dry-run-action		string	An action the system would take.
dry-run-effect		string	The predicted effect of the action.
dry-run-reason		string optional	Present only if severity is error or warning. Specifies possible reasons for the error, warning. If there are no reasons to specify, this element will not be present.
dry-run-reason-details		result-detail[] optional	These details apply to the associated dry-run-reason within the same dry-run-result. These offer additional information such as the reasons individual reasources may not have been selected for the dry-run-action in this same dry-run-result.
dry-run-severity		obj-status	severity of the dry-run result. Possible values are "information", "error" or "warning".
dry-run-suggestion		string	Present only if severity is error or warning. Specifies any suggestions to rectify the warnings, errors. If there are no suggestions to specify, this element will not be present.

vFiler IP Address to interface binding information.

Name	Range	Type	Description
interface		obj-name-or-id	Name or identifier of the interface to bind the vFiler IP Address to. This can be either a physical interface, VIF or a VLAN. Example: "e0a", "myvif", "service_vlan"
ip-address		ip-address	IP address of the vFiler which is bound to the interface. If this IP Address is not already added to the vFiler, then the IP Address is first added to the vFiler before binding the IP Address with the given interface.
mtu-size		integer optional	MTU size of the new VLAN interface. This element should be present only if a new VLAN interface is being created during vFiler setup. Also the version of Data ONTAP on the storage system on which the vFiler is being setup, should be 7.3.3 or later. Range: [296..9196]
netmask		string optional	Netmask for the IP address in dotted decimal notation. For IPv4 address, either netmask or prefix-length can be supplied. For IPv6 address, netmask is ignored.
partner-interface		obj-name-or-id optional	Name or identifier of the interface on the partner node. This element is valid when the storage system on which this vFiler unit is present is in a Active/Active configuration. If a new VLAN is getting created on the local node, then a new corresponding VLAN will also be created on the partner node on this interface.
prefix-length		integer optional	Prefix length for the IP address. This is required if IPv6 address is supplied. For IPv4 address, either netmask or prefix-length can be supplied. Range: [1..127]
vlan-identifier		integer optional	Identifier for creating a new VLAN interface. If this element is present, the interface element should refer to a physical VLAN tagged interface. Range: [1..4094]

Dry run results of migration of each individual volume

Name	Range	Type	Description
dry-run-results		dry-run-result[]	Results of a dry run. Each result describes one action the system would take and the predicted effects of that action.
volume-id		obj-id	Identifier of the volume to migrate
volume-name		obj-name	Full name of the volume to migrate

Job information of volume migration job.

Name	Range	Type	Description
job-id		integer	Identifier of job started for the volume migration.
volume-id		obj-id	Identifier of the volume to migrate
volume-name		obj-name	Full name of the volume to migrate

Details of a volume migration request.

Name	Range	Type	Description
cleanup-stale-storage		cleanup-stale-storage optional	Indicates when should the volumes in the source aggregate should be destroyed after successful migration. Default value is "cleanup_after_migration".
destination-aggregate-name-or-id		obj-name-or-id optional	Name or identifier of the destination aggregate to which all the volumes has to be migrated to. If the destination aggregate is not provided, the system will select a suitable aggregate from the resource pools associated with the dataset node to which the volumes belong to.
retention-type		dp-backup-retention-type optional	Retention type to which the backup version created should be archived for the backups created as part of running an on-demand update after successful migration. This element is ignored if run-on-demand-update is false. Default value is "daily".
run-dedupe-scan		boolean optional	Indicates whether a full deduplication scan has to be run on the new volume after migration. This option is applicable only for volumes that are enabled for deduplication and is useful to regenerate the fingerprint database used in deduplication and will be ignored for other volumes. Default value is false.
run-on-demand-update		boolean optional	Indicates whether an on-demand update has to be triggered after successful migration on the dataset to which the volumes that were migrated belong to. Default value is false.
volumes		obj-name-or-id[]	Name or ids of one or more volumes to be migrated. Currently, all the volumes should belong to the same aggregate. The volumes, if they belong to a dataset should all belong to the same node of the dataset.

Migration status for an ongoing vFiler unit migration. Possible values: "in_progress", "migrating", "migrated", "migrated_with_errors", "migrate_failed", "rolled_back", "rolled_back_with_errors".

[none]

Name or internal ID of a DFM object. This typedef is an alias for the builtin ZAPI type string. An obj-name-or-id must contain between 1 and 64 characters, and must conform to one of the following formats: It must have the format of an obj-name, or It must be the decimal numeric string form of a positive integer whose value is in the range [1..2^31 - 1]. Elements of type obj-name-or-id 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 obj-name-or-id 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]

Type of migrating routes. Possible values are: 'static', 'persistent', 'none'. static: Static routes present in the IPSpace of the migrating vFiler unit will be migrated. persistent: Persistent routes present in /etc/rc file related to the migrating vFiler unit will be migrated. none: None of the routes will be migrated. Choosing this option may lead to non-disruptive migration, if the routes in the migrating vFiler unit are not present on the destination storage system. This option should be chosen only when all the routes are already present on the destination storage system. By default 'static' routes will be migrated.

[none]

A volume and aggregate pair.

Name	Range	Type	Description
aggregate		obj-name-or-id	Name or id of the aggregate.
volume		obj-name-or-id	Name or id of the volume.

Indicates when the volumes in the source aggregate should be destroyed after successful migration. Possible values are: cleanup_after_update cleanup_after_migration no_cleanup

[none]

Retention type to which the backup should be archived. Possible values are: 'hourly', 'daily', 'weekly', 'monthly' and 'unlimited'.

[none]

A description of one action and the predicted effects of taking that action.

Name	Range	Type	Description
dry-run-action		string	An action the system would take.
dry-run-effect		string	The predicted effect of the action.
dry-run-reason		string optional	Present only if severity is error or warning. Specifies possible reasons for the error, warning. If there are no reasons to specify, this element will not be present.
dry-run-reason-details		result-detail[] optional	These details apply to the associated dry-run-reason within the same dry-run-result. These offer additional information such as the reasons individual reasources may not have been selected for the dry-run-action in this same dry-run-result.
dry-run-severity		obj-status	severity of the dry-run result. Possible values are "information", "error" or "warning".
dry-run-suggestion		string	Present only if severity is error or warning. Specifies any suggestions to rectify the warnings, errors. If there are no suggestions to specify, this element will not be present.

IP address in string format. The length of this string cannot be more than 40 characters.

[none]

Identification number (ID) for a DFM object. This typedef is an alias for the builtin ZAPI type integer. Object IDs are unsigned integers in the range [1..2^31 - 1]. In some contexts, an object ID is also allowed to be 0, which is interpreted as a null value, e.g., a reference to no object at all. The ID for a DFM object is always assigned by the system; the user is never allowed to assign an ID to an object. Therefore, an input element of type obj-id 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 obj-id input element does not match the ID of any existing DFM object of the specified type or types, then typically the ZAPI fails with error code EOBJECTNOTFOUND. A ZAPI may deviate from this general rule, for example, it may return a more specific error code. In either case, the ZAPI specification must document its behavior.

[none]

Name of a DFM object. This typedef is an alias for the built in ZAPI type string. An object name must conform to the following format: It must contain between 1 and 64 characters. It may start with any character and may contain any combination of characters, except that it may not consist solely of decimal digits ('0' through '9'). In some contexts, a name may be the empty string (""), which is interpreted as a null value, e.g., a reference to no object at all. The behavior of a ZAPI when it encounters an error involving an obj-name 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 obj-full-name 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 obj-name 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 obj-name 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]

Name or internal ID of a DFM object. This typedef is an alias for the builtin ZAPI type string. An obj-name-or-id must contain between 1 and 64 characters, and must conform to one of the following formats: It must have the format of an obj-name, or It must be the decimal numeric string form of a positive integer whose value is in the range [1..2^31 - 1]. Elements of type obj-name-or-id 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 obj-name-or-id 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]

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]

Details on a specific action that adds information intended to explain more about a higher level result. For example, the detail may be used to explain a dry-run result by explaining why resources were not selected.

Name	Range	Type	Description
action		string	An action or check the system had taken.
effect		string	The result of the action or check.
reason		string optional	Specifies possible reasons for the this result. If there are no reasons to specify, this element will not be present.
severity		obj-status	severity of the result result. Possible values are "information", "error" "warning". It is normal for "information" to be used to explain why a resource was not selected.
suggestion		string	Specifies any suggestions to rectify the information, warnings, errors. If there are no suggestions to specify, this element will not be present.

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]