CreateFolder

Creates a new sub-folder with the specified name.

Because of the dual-server nature of SRM, the sites must be connected when creating folders. Any % (percent) character used in this name parameter must be escaped, unless it is used to start an escape sequence. Clients may also escape any other characters in this name parameter. This method requires VcDr.ProtectionProfile.com.vmware.vcDr.Create privilege on the containing folder to create a protection group folder and VcDr.RecoveryProfile.com.vmware.vcDr.Create to create a recovery plan folder.

Synopsis

@task Folder createFolder(String folderName)

createFolder returns a task instance to monitor the asynchronous operation of this method. Folder object is returned as task result. createFolder contains the following parameters:

Field	Description
name	The name to be given the new folder. An entity name must be a non-empty string of less than 80 characters. The slash (/), backslash (\) and percent (%) will be escaped using the URL syntax. For example, %2F.

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

• vim.fault.DuplicateName - if another object in the same folder has the target name.
• vim.fault.InvalidName - if the name is not a valid entity name.
• drextapi.fault.ConnectionDownFault - if the sites are not connected.

Faults

• vim.fault.InvalidArgument
• RuntimeFault

See Faults in Site Recovery Manager API for more details.