Input Name	Type
DpRestoreToNewPath	DpRestoreToNewPath
Output Name	Type
DpRestoreToNewPathResult	DpRestoreToNewPathResult

Error Name	Description
EACCESSDENIED
EBACKUPLOCATIONDOESNOTEXIST
EDATABASEERROR
EINTERNALERROR
EINVALIDHOST
EINVALIDINPUT
EOBJECTNOTFOUND
EOPERATIONNOTSUPPORTED

Start a restore Operation on part of a Dataset. This Operation copies files and/or Directories From a specific backup Version back To the primary location. The Operation is performed in the background by a job. Error conditions: EOBJECTNOTFOUND - The Dataset Name or ID or one of the member Name or ID was not found. EACCESSDENIED - The Dataset exists, but the user invoking the API has no DFM.BackupManager.Restore Permission on the Dataset or on any of the Members. EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDINPUT - The number of Paths To restore was either 0 or more than 1000 or neither BackupId nor BackupVersion was specified. EDATABASEERROR - A database Error occured. ENDRESTORENOTPOSSIBLE - A partial Qtree restore is requested for a Dataset which requires a non disruptive restore.

Input Name	Type
DpRestoreToPrimary	DpRestoreToPrimary
Output Name	Type
DpRestoreToPrimaryResult	DpRestoreToPrimaryResult

Error Name	Description
EACCESSDENIED
EBACKUPLOCATIONDOESNOTEXIST
EDATABASEERROR
EINTERNALERROR
EINVALIDINPUT
ENDRESTORENOTPOSSIBLE
EOBJECTNOTFOUND
EOPERATIONNOTSUPPORTED

Start a restore Operation on part of a Dataset. This Operation copies whole Members or its sub-paths of the Dataset From a specific backup Version To a new location. The Operation is performed in the background by a job. Error conditions: EOBJECTNOTFOUND - The Dataset Name or ID or one of the member Name or ID was not found. EACCESSDENIED - The Dataset exists, but the user invoking the API has no DFM.BackupManager.Restore Permission on the Dataset. EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDINPUT - The number of Paths To restore was either 0 or more than 1000 or neither BackupId nor BackupVersion was specified. EINVALIDHOST - One of the specified destination Hosts was not a valid restore destination. EDATABASEERROR - A database Error occured.

Name	Type	Description
BackupId	xsd:integer optional	Identifier of the backup Instance To restore From. If this parameter is specified, then BackupVersion is ignored. Range: [1..2^31-1]
BackupVersion	DpTimestamp optional	Timestamp of the backup which should be restored From. If the BackupId is not specified, this parameter is required. A backup location that matches this Version will be picked To do the restore From.
CheckOverwrite	xsd:boolean optional	If true, checks if the member To be restored overwrites existing data on the destination. This flag cannot be used if the destination Host is an OSSV or an ESX server. If it is used, an Error is returned. It can be set To true only if the Members To be restored are files. If the restore Path has any Members other than files, an Error is returned. If false, goes ahead with the restore job without checking for overwrites at the destination. By default, it is false.
CheckSpaceStatus	xsd:boolean optional	If true, checks if there is enough space on the destination To restore the member. This flag cannot be used if the destination Host is an OSSV or an ESX server. If it is used, an Error is returned. It can be set To true only if the Members To be restored are files. If the restore Path has any Members other than files, an Error is returned. If the flag is not specified or set To false, goes ahead with the restore job without checking the space Status at the destination. By default, it is false.
DatasetNameOrId	ObjNameOrId	Name or identifier of the Dataset To restore part of.
Members	ArrayOfDpRecoverMemberInfo	List of Members and their Path To recover within the Dataset. Each member includes the new location To restore the data. The Maximum number of Members is 1000.
MigrateRelationship	xsd:boolean optional	Flag indicating whether To MigrateStart the relationships. By default, the Value is false.

Name	Type	Description
JobId	xsd:integer optional	Id of the job that handles the restore Operation. It is returned only if "CheckOverwrite" and "CheckSpaceStatus" are false. If either of them is set To true, the API only checks overwrites and/or space Status and returns. The restore Operation is not performed . Range: [1..2^31-1]
OverwriteResults	ArrayOfOverwriteResult optional	Results of a CheckOverwrite. Each Result will have information about the file that overwrites data on the destination. Returned if CheckOverwrite is true and if the file being restored might overwrite existing data. This element is not returned if there are no overwrites.
SpaceStatusResults	ArrayOfSpaceStatusResult optional	Results of CheckSpaceStatus. Each Result will have information about the destination Volume. Returned if CheckSpaceStatus is true and if the destination Volume does not have enough space for enough space for the restore. Returned if CheckSpaceStatus is true and if the destination Volume does not have enough space for the restore. If the destination Volume has enough space, this element is not returned.

Start a restore Operation on part of a Dataset. This Operation copies files and/or Directories From a specific backup Version back To the primary location. The Operation is performed in the background by a job. Error conditions: EOBJECTNOTFOUND - The Dataset Name or ID or one of the member Name or ID was not found. EACCESSDENIED - The Dataset exists, but the user invoking the API has no DFM.BackupManager.Restore Permission on the Dataset or on any of the Members. EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDINPUT - The number of Paths To restore was either 0 or more than 1000 or neither BackupId nor BackupVersion was specified. EDATABASEERROR - A database Error occured. ENDRESTORENOTPOSSIBLE - A partial Qtree restore is requested for a Dataset which requires a non disruptive restore.

Name	Type	Description
BackupId	xsd:integer optional	Identifier of the backup Instance To restore From. If this parameter is specified, then BackupVersion is ignored. Range: [1..2^31-1]
BackupVersion	DpTimestamp optional	Timestamp of the backup which should be restored From. If the BackupId is not specified, this parameter is required. A backup location that matches this Version will be picked To do the restore From.
CheckOverwrite	xsd:boolean optional	If true, checks if the member To be restored overwrites existing data on the destination. This flag cannot be used if the destination Host is an OSSV or an ESX server. If it is used, an Error is returned. It can be set To true only if the Members To be restored are files. If the restore Path has any Members other than files, an Error is returned. If false, goes ahead with the restore job without checking for overwrites at the destination. By default, it is false.
CheckSpaceStatus	xsd:boolean optional	If true, checks if there is enough space on the destination To restore the member. This flag cannot be used if the destination Host is an OSSV or an ESX server. If it is used, an Error is returned. It can be set To true only if the Members To be restored are files. If the restore Path has any Members other than files, an Error is returned. If the flag is not specified or set To false, goes ahead with the restore job without checking the space Status at the destination. By default, it is false.
DatasetNameOrId	ObjNameOrId	Name or ID of the Dataset To restore part of.
Paths	ArrayOfDpPathInfo	List of Paths To restore within the Dataset. Each Path can be a single file or a Directory. The Maximum number of Paths is 1000.

Name	Type	Description
JobId	xsd:integer optional	Id of the job that handles the restore Operation. It is returned only if "CheckOverwrite" and "CheckSpaceStatus" are false. If either of them is set To true, the API only checks overwrites and/or space Status and returns. The restore Operation is not performed . Range: [1..2^31-1]
OverwriteResults	ArrayOfOverwriteResult optional	Results of a CheckOverwrite. Each Result will have information about the file that overwrites data on the destination. Returned if CheckOverwrite is true and if the file being restored might overwrite existing data. This element is not returned if there are no overwrites.
SpaceStatusResults	ArrayOfSpaceStatusResult optional	Results of CheckSpaceStatus. Each Result will have information about the destination Volume. Returned if CheckSpaceStatus is true and if the destination Volume does not have enough space for enough space for the restore. Returned if CheckSpaceStatus is true and if the destination Volume does not have enough space for the restore. If the destination Volume has enough space, this element is not returned.

Name	Type	Description
DpPathInfo	DpPathInfo[]

Name	Type	Description
DpRecoverMemberInfo	DpRecoverMemberInfo[]

Name	Type	Description
OverwriteResult	OverwriteResult[]

Name	Type	Description
SpaceStatusResult	SpaceStatusResult[]

Seconds since 1/1/1970 in UTC. Range: [0..2^31-1]. This runs out in 2036, so update the API some time before then.

[none]

Name or internal ID of a DFM object. This typedef is an alias for the builtin ZAPI Type string. An ObjNameOrId must contain between 1 and 64 characters, and must conform To one of the following formats: It must have the format of an ObjName, or It must be the decimal numeric string form of a positive integer whose Value is in the range [1..2^31 - 1]. Elements of Type ObjNameOrId are used only as inputs To ZAPIs. The Value must Match either the Name or internal ID of an existing DFM object. The ZAPI must specify the object's DFM object Type (e.g. Dataset, Host, DP Policy, etc.). Some ZAPIs allow the object To be one of several different types. If the format of an ObjNameOrId input element does not conform, or the Value does not Match the Name or ID of an existing object, then generally the ZAPI documents that it fails with Error code EOBJECTNOTFOUND. A ZAPI may return more specific Error codes. In such cases, the ZAPI specification must document its behavior. If a ZAPI can accept a null Value (e.g. reference To no object at all) for such an element, then the element is declared optional, and the absence of the input element represents a null Value.

[none]

Information about a Path inside a Dataset.

Name	Type	Description
MemberNameOrId	ObjNameOrId	Name or Id of the Dataset component that is at the root of the file tree. This may be Qtree, ossv Directory or Volume Id that is Source of the physical data protection relationship.
Path	xsd:string	Name of the Path. The Maximum Path Length is 32767 characters. This Path is relative To "MemberNameOrId" Path in the storage system or OSSV Host. Path cannot be empty.
PrimarySnapshotName	xsd:string optional	Name of the Snapshot copy on the primary where the data being restored originated. This is ignored if PrimarySnapshotUniqueId is specified.
PrimarySnapshotUniqueId	xsd:string optional	Unique Id of the Snapshot copy on the primary where the data being restored originated. Currently, this is the Snapshot copy's creation time. This is used To differentiate between multiple copies of the root object (specified by MemberNameOrId input) in the same backup. If not specified and different versions of the root object exist in two Snapshot copies in the backup, then the restore might be ambiguous.
RestoreConfiguration	xsd:boolean optional	Valid only when an OSSV Directory being restored is a Virtual Machine. If false the configuration of the Virtual Machine is not changed, only Disks are restored. If true, the configuration and data are restored. Default Value is true.

Information about a member inside a Dataset.

Name	Type	Description
DestinationHost	ObjNameOrId	Host To restore this Dataset member To. The destination Host must be compatible with the member Type of the member being restored. For example, if the member is a Volume, then this destination Host must be a storage system.
DestinationPath	xsd:string optional	Path To restore this Dataset member To. The Path will be interpreted relative To DestinationHost. If the destination Host is a storage system, the Path must not already exist. If the destination Host is an OSSV, the Path will be overwritten. In case of a Virtual Machine restore To the original location: The Path must either be an empty string or not be specified. The restore will happen through the destination Host. The format of this Value depends on the Host Type of DestinationHost. If DestinationHost is a storage system, then it should be of the form "/vol1/[qtree1][/dir1..]". If a full Volume restore is being specified, then the destination Path must be a Volume "/vol". If a full Qtree restore is specified, and if the destination is a storage system, destination Path can be either "/vol" or "/vol/qtree" and if it is "/vol", the server automatically appends the Qtree Name To the destination Path To turn it into "/vol/qtree" format. If DestinationHost is an OSSV Host, then it should be a pathname appropriate for the OSSV Host. A Windows Host will accept Paths such as "C:\My Documents" and a UNIX Host will accepts Paths such as "/home/user". If the specified DatasetNameOrId is of an application data set, all the above rules apply. In addition, the files will be restored under a uniquely named Directory under the destination Path. The Directory Name is created by adding together three separate pieces of information (listed below) separated by a "_" character: Name of the primary Snapshot where data originated. All characters except [A-Z], [a-z], [0-9], '.', '-', '_', ')' and '(' are stripped From the Snapshot Name and the Name is trimmed To the first 42 characters before it is used. The 42 character limit ensures that the Total Length of the uniquely named Directory does not exceed 64 characters. The DFM identifier of the primary Qtree where the data originated. The DFM identifier of the Snapshot. This is currently the Timestamp when the Snapshot was created. The Maximum destination Length is 32767 characters. In some cases, shorter destination lengths will fail due To limitations of underlying storage systems. Default Value is an empty string.
DestinationPathSkipExtraDirectory	xsd:boolean optional	If this input is specified and is true, no extra Directory will be added To the destination Path. See DestinationPath for more information on how an extra Directory is added To the destination Path for an application Dataset. If the Dataset is not an applicatoin Dataset, this input has no Effect. Default is false.
MemberNameOrId	ObjNameOrId	Name or identifier of the Dataset component that is at the root of the file tree. This may be Qtree, ossv Directory or Volume Id that is Source of the physical data protection relationship.
Path	xsd:string	Name of the Path. The Maximum Path Length is 32767 characters. This Path is relative To "MemberNameOrId" Path in the storage system or OSSV Host. Path cannot be empty. "/" is considered as full member restore when the member is a Volume, Qtree or OSSV Directory.
PrimarySnapshotName	xsd:string optional	Name of the Snapshot copy on the primary where the data being restored originated. This is ignored if PrimarySnapshotUniqueId is specified.
PrimarySnapshotUniqueId	xsd:string optional	Unique Id of the Snapshot copy on the primary where the data being restored originated. Currently, this is the Snapshot copy's creation time. This is used To differentiate between multiple copies of the root object (specified by MemberNameOrId input) in the same backup. If not specified and different versions of the root object exist in two Snapshot copies in the backup, then the restore might be ambiguous.
RestoreConfiguration	xsd:boolean optional	Valid only when an OSSV Directory being restored is a Virtual Machine. If false the configuration of the Virtual Machine is not changed, only Disks are restored. If true, the configuration and data are restored. Default Value is true.

Information about the member and the destination.

Name	Type	Description
DestHost	xsd:string	Destination Host where file will be restored..
FilePath	xsd:string	destination Path where the file was being restored. The Path includes the Name of the file being restored.
OverwriteStatus	xsd:string	For ONTAP Version below 7.3.0, we cannot check for overwrite. In that case, this element will return a predefined string indicating overwrite Status could not be checked. For other cases, the overwrite Status will be returned. Possible Values : "overwrite", "overwrite_check_unsupported"

Information about the destination Volume which does not have enough space for the restore

Name	Type	Description
AvailSpace	xsd:unsignedLong	Free space available in the Volume in KB. Range: [0..2^64-1]
DestHost	xsd:string	Name of the destination Host where the restore would take place.
DestVol	xsd:string	Name of the destination Volume where the restore would take place.
ReqSpace	xsd:unsignedLong	Space required in the Volume for restore in KB. Range: [0..2^64-1]