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.