Faults in Site Recovery Manager API

This section lists the various faults thrown by the Site Recovery Manager APIs.

Table 1. Faults thrown by Site Recovery Manager functions
Fault Description
AlreadyExists The name, key, or identifier of the element already exists in the collection.
AlreadyLoggedInFault The session is already logged in, and Login was called again.
CertificateCtlSignatureNotValid Thrown when a certificate trust list used to create this chain did not have a valid signature.
ConnectionDownFault Thrown if the VMOMI connection to the remote server is down.
ConnectionLimitReached Thrown when the configured connection limit has been reached.
DependencyConflict UpdateVmSettings operation was attempted that might cause a dependency cycle.
DirectionError The direction of the recovery plan cannot be determined.
DomainDatastoreNotFound  No existing datastore could be matched to a fault domain.
DomainNotFound No storage container could be matched to a fault domain. A storage container links the domain to its datastore.
DomainPeerNotFound  Domains does not have their peer domains reported by the paired SRM. One of the reasons may be no VASA provider is registered at the paired site.
DomainReplicationGroupNotFound Replication group is part of a protection group but could not be found in the configuration.
DomainScNotFound No storage container could be matched to a fault domain. The storage container links the domain to its datastore.
DuplicateName Call is unable to determine which object to use due to name conflict.
GroupProtectionOverlapped Thrown when more than one protection group contain VMs replicated by the same vVol replication groups. If recovery is started in this situation, all colocated VMs might be broken. To resolve this make sure that all VMs located on a certain replication group are protected by the same protection group.
GroupStateMissmatch Sate of the protection group does not match the state of a replication group protected by it. This is possible when the replication group state is changed by an external tool. The error can be corrected by restoring the replication group to the expected state using the storage array instruments and tools.
GroupTargetsNotFound Target replication groups cannot be found. This occurs when the group is not in the correct state. Check storage policy assignment.
InsufficientLicensesFault Thrown by a method that cannot acquire licenses for the object to create.
InternalError An internal error occurred that cannot be described by a more specific fault or if the hbr provider cannot be found(null reference).
InvalidArgument Base class for invalid argument exceptions. Thrown if the username format invalid, or user or user group does not exist, or if the user is a global vCenter administrator, or if the name of the protection group is empty or if the list of virtual machines is empty or null.
InvalidLogin Cannot complete login due to an incorrect user name or password.
InvalidPrimaryFolder Thrown for an attempt to create a primary site folder that cannot contain VMs.
InvalidPrimaryNetwork Invalid primary network specified for mapping, such as uplink DVPortgroup
InvalidSecondaryFolder Thrown for an attempt to create a secondary site folder that cannot contain VMs.
InvalidSecondaryNetwork Invalid secondary network specified for mapping (such as uplink DVPortgroup)
InvalidState Base class for invalid state exceptions
InvalidTokenLifetime SSO token is either expired or not yet valid. This exception is generally thrown if there is a time skew between the local clock and the SSO server. This exception is not supported from methods with version prior to 8. However it is translated to Vim::Fault::InvalidLogin::Exception.
IpMappingFault A base class for all IpMapping related faults. Thrown if problems are found while validating IP subnet mapping rules.
MultipleFault Multiple faults occur.
NetworkNotFound Thrown if the test network mapping does not exist in the recovery plan.
NoPermission Operation denied because of a privilege not held on a managed object.
NotAuthenticated Operation denied because the session has not successfully logged in.
PromptNotFound Thrown when a RecoveryPrompt cannot be found.
ProtectionGroupNotEmpty Thrown after attempt to remove a protection group that contains protected VMs.
ProtectionGroupNotFound Thrown when an operation on protection group cannot find the protection group.
ProviderFault Thrown if either ReplicationProvider rejected the operation. This can occur when the settings are incorrect.
RecoveryPlanLocked An attempt was made to change a RecoveryPlan that is locked.
RecoveryPlanNotFound Thrown when the requested recovery plan was not found
RecoveryResultNotFound Thrown when a RecoveryResult cannot be found.
RemoteSiteNotAuthenticated Thrown if the remote site or the session is not authenticated.
RemoteSiteNotEnabled An attempt was made to use a remote site that is not enabled.
ReplicationProviderFault Thrown when an unspecified error was returned from the replication provider.
StorageProviderFault Corresponds to dr.vvolProvider.fault.StorageProviderFault.
StringArgumentTooLong Thrown when a string argument exceeds {maxSize} characters
SystemError Thrown in case of internal SRM error.
UnknownPrimaryFolder Secondary site tried operation on a folder that is nonexistent on primary site (protected site)
UnknownPrimaryNetwork Thrown when the secondary site tries to perform an operation involving a network that does not exist on the primary site.
UnknownSecondaryNetwork Secondary site tried operation on a network that is nonexistent on secondary site (recovery site)
UnknownPrimaryResourcePool Secondary site tried operation on resource pool that is nonexistent on primary site.
UnknownSecondaryFolder Primary site tried operation on a folder that is nonexistent on secondary site.
UnknownSecondaryNetwork Primary site tried operation on a network that is nonexistent on secondary site.
UnknownSecondaryResourcePool Primary site tried operation on resource pool that is nonexistent on secondary site.
VersionConflict Attempt to reconfigure with a changeVersion that does not match the current value.
vim.fault.ConcurrentAccess Thrown if another operation has modified the object and the change version no longer matches.
VmAlreadyProtected Thrown when a user tries to protect a VM which is already protected by SRM.
VmAlreadyProtectedEx Thrown when a user tries to protect a VM which is already protected by SRM. Contains extra info about the PG currently holding the VM protection.
VmFileNotReplicated A virtual machine file is not replicated.
VmNotFoundInRecoveryPlan Attempt to retrieve settings for virtual machine that does not exist in RecoveryPlan.
VmNotReplicated No virtual machine files are replicated. Check and fix the storage policy assignment.
VmPiggybackError A virtual machine is detected on a replication group that is already protected by one of the protection groups. Either protect the VM or reconfigure it out of the replication group.
VmReconfigureRequired The virtual machine configuration has changed and reconfiguration is required. Reconfigure is started automatically without user intervention.
VmReplicationGroupError Attempting to protect a virtual machine that belongs to one replication group into a protection group that is configured to use a different set of replication groups.
VmSplitReplicated In order to guarantee the consistency, SRM protects only virtual machines replicated by a single replication group. This situation occurs when the configuration file and the virtual disk files do not share the same storage policy assignments.
VmTemplateFault vVol provider does not support protection of template VMs. This fault is throw when attempt to protect template VM with vVol provider is made.
VvolDomainFault Base class for all fault domain related VvolProvider faults.
VvolProviderFault Base class for all VvolProvider faults.
VvolVmFault Base class for all virtual machine related VvolProvider faults.