MoveFolder

Moves this folder into another folder.

The objects that can be moved into a folder depends on the parent folder's type (as defined by the parent folder's childType() property). For a folder constructed for recovery plans, only recovery plans and recovery folders can be moved into the folder. For a folder constructed to hold ProtectionGroups, only ProtectionGroups and protection folders can be moved into the folder.

For protection group folders this method requires VcDr.ProtectionProfile.com.vmware.vcDr.Edit on the moved folder, on the current parent folder, and on the destination folder.

For recovery plan folders this method requires VcDr.RecoveryProfile.com.vmware.vcDr.Edit on the moved folder, on the current parent folder, and on the destination folder.

Synopsis

@task void moveFolder(Folder destination);

moveFolder returns a task instance to monitor the asynchronous operation of this method. moveFolder has the following parameters:

Field	Description
destination	Folder that should become the new parent of this folder.

If a task fails, its error field may contain one of the following:

• drextapi.fault.DuplicateName - a folder with the same name already exists within the destination folder.
• drextapi.fault.IllegalMove if a cycle would be created by this move. For example, moving this folder into one of its children folders would create a cycle.
• drextapi.fault.ImmutableFolder - if move is initiated on the root folder.
• vim.fault.NotSupported - if the folder is being moved into a folder whose childType() property is not set to the appropriate value. For example, a folder cannot be moved into a folder whose ChildType property value does not contain Dr::Folder.

Faults

• InvalidType
• ManagedObjectNotFound
• RuntimeFault

See Faults in Site Recovery Manager API for more details.