Replication Recovery Plans - Unplanned Failover

Referencia

Servicio:: Recovery Services - Site Recovery

Versión de la API:: 2025-02-01

Ejecute la conmutación por error no planeada del plan de recuperación.
Operación para iniciar la conmutación por error no planeada de un plan de recuperación.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}/unplannedFailover?api-version=2025-02-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
recoveryPlanName	path	True	string	Nombre del plan de recuperación.
resourceGroupName	path	True	string	Nombre del grupo de recursos donde está presente el almacén de Recovery Services.
resourceName	path	True	string	Nombre del almacén de Recovery Services.
subscriptionId	path	True	string	Identificador de suscripción.
api-version	query	True	string	Versión de api de cliente.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties	True	RecoveryPlanUnplannedFailoverInputProperties	Propiedades de entrada de conmutación por error no planeadas del plan de recuperación.

Respuestas

Nombre	Tipo	Description
200 OK	RecoveryPlan	De acuerdo
202 Accepted		Aceptado

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario.

Ejemplos

Execute unplanned failover of the recovery plan.

Solicitud de ejemplo

HTTP

POST https://management.azure.com/subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationRecoveryPlans/RPtest1/unplannedFailover?api-version=2025-02-01

{
  "properties": {
    "failoverDirection": "PrimaryToRecovery",
    "sourceSiteOperations": "Required",
    "providerSpecificDetails": [
      {
        "instanceType": "HyperVReplicaAzure"
      }
    ]
  }
}

Respuesta de muestra

status code:: 200

Azure-AsyncOperation: https://management.azure.com/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationOperationStatus/a93f3cd5-9035-4b1e-a2c9-b16df6d5d34b?api-version=2025-02-01

{
  "id": "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationRecoveryPlans/RPtest1",
  "name": "RPtest1",
  "type": "Microsoft.RecoveryServices/vaults/replicationRecoveryPlans",
  "properties": {
    "friendlyName": "RPtest1",
    "primaryFabricId": "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationFabrics/cloud1",
    "primaryFabricFriendlyName": "cloud1",
    "recoveryFabricId": "Microsoft Azure",
    "recoveryFabricFriendlyName": "Microsoft Azure",
    "failoverDeploymentModel": "ResourceManager",
    "replicationProviders": [
      "HyperVReplicaAzure"
    ],
    "allowedOperations": [
      "PlannedFailover",
      "UnplannedFailover",
      "TestFailover",
      "Commit"
    ],
    "lastPlannedFailoverTime": "2017-04-27T08:58:35.9062813Z",
    "lastTestFailoverTime": "2017-04-27T07:00:27.8354747Z",
    "currentScenario": {
      "scenarioName": "UnplannedFailover",
      "jobId": "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationJobs/60b84068-9adb-4867-a49d-88be40bff14b",
      "startTime": "2017-04-27T10:03:03.2206946Z"
    },
    "currentScenarioStatus": "Succeeded",
    "currentScenarioStatusDescription": "Completed",
    "groups": [
      {
        "groupType": "Shutdown",
        "replicationProtectedItems": [],
        "startGroupActions": [],
        "endGroupActions": []
      },
      {
        "groupType": "Failover",
        "replicationProtectedItems": [],
        "startGroupActions": [],
        "endGroupActions": []
      },
      {
        "groupType": "Boot",
        "replicationProtectedItems": [
          {
            "id": "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationFabrics/cloud1/replicationProtectionContainers/cloud_6d224fc6-f326-5d35-96de-fbf51efb3179/replicationProtectedItems/f8491e4f-817a-40dd-a90c-af773978c75b",
            "virtualMachineId": "f8491e4f-817a-40dd-a90c-af773978c75b"
          }
        ],
        "startGroupActions": [],
        "endGroupActions": []
      },
      {
        "groupType": "Boot",
        "replicationProtectedItems": [
          {
            "id": "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationFabrics/cloud1/replicationProtectionContainers/cloud_6d224fc6-f326-5d35-96de-fbf51efb3179/replicationProtectedItems/c0c14913-3d7a-48ea-9531-cc99e0e686e6",
            "virtualMachineId": "c0c14913-3d7a-48ea-9531-cc99e0e686e6"
          }
        ],
        "startGroupActions": [],
        "endGroupActions": []
      }
    ]
  }
}

status code:: 202

Azure-AsyncOperation: https://management.azure.com/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationOperationStatus/a93f3cd5-9035-4b1e-a2c9-b16df6d5d34b?api-version=2025-02-01
Retry-After: 30

Definiciones

Nombre	Description
A2ARpRecoveryPointType	Tipo de punto de recuperación.
AlternateLocationRecoveryOption	Opción ALR.
CurrentScenarioDetails	Detalles del escenario actual de la entidad protegida.
DataSyncStatus	La opción de sincronización de datos.
ExtendedLocation	Ubicación extendida del recurso.
ExtendedLocationType	Tipo de ubicación extendida.
HyperVReplicaAzureRpRecoveryPointType	Tipo de punto de recuperación.
InMageRcmFailbackRecoveryPointType	Tipo de punto de recuperación.
InMageV2RpRecoveryPointType	Tipo de punto de recuperación.
MultiVmSyncPointOption	Valor que indica si las máquinas virtuales habilitadas para la sincronización de varias máquinas virtuales deben usar puntos de sincronización de varias máquinas virtuales para la conmutación por error.
PossibleOperationsDirections	Lista de direcciones de conmutación por error.
RecoveryPlan	Detalles del plan de recuperación.
RecoveryPlanA2ADetails	Detalles específicos del plan de recuperación A2A.
RecoveryPlanA2AFailoverInput	Entrada de conmutación por error del plan de recuperación A2A.
RecoveryPlanAction	Detalles de la acción del plan de recuperación.
RecoveryPlanActionLocation	Ubicación del tejido.
RecoveryPlanAutomationRunbookActionDetails	Detalles de la acción del runbook de Automation del plan de recuperación.
RecoveryPlanGroup	Detalles del grupo del plan de recuperación.
RecoveryPlanGroupType	Tipo de grupo.
RecoveryPlanHyperVReplicaAzureFailbackInput	Entrada de conmutación por recuperación del plan de recuperación HVR de Azure.
RecoveryPlanHyperVReplicaAzureFailoverInput	Entrada de conmutación por error de Azure del plan de recuperación HVR.
RecoveryPlanInMageAzureV2FailoverInput	Entrada de conmutación por error del plan de recuperación InMageAzureV2.
RecoveryPlanInMageFailoverInput	Entrada de conmutación por error del plan de recuperación InMage.
RecoveryPlanInMageRcmFailbackFailoverInput	Entrada de conmutación por error del plan de recuperación InMageRcmFailback.
RecoveryPlanInMageRcmFailoverInput	Entrada de conmutación por error del plan de recuperación InMageRcm.
RecoveryPlanManualActionDetails	Detalles de la acción manual del plan de recuperación.
RecoveryPlanPointType	Tipo de punto de recuperación.
RecoveryPlanProperties	Propiedades del plan de recuperación.
RecoveryPlanProtectedItem	Elemento protegido del plan de recuperación.
RecoveryPlanScriptActionDetails	Detalles de la acción del script del plan de recuperación.
RecoveryPlanUnplannedFailoverInput	Entrada de conmutación por error no planeada del plan de recuperación.
RecoveryPlanUnplannedFailoverInputProperties	Propiedades de entrada de conmutación por error no planeadas del plan de recuperación.
ReplicationProtectedItemOperation	Lista de tipos de conmutación por error.
RpInMageRecoveryPointType	Tipo de punto de recuperación.
SourceSiteOperations	Valor que indica si se requieren operaciones de sitio de origen.

A2ARpRecoveryPointType

Enumeración

Tipo de punto de recuperación.

Valor	Description
Latest
LatestApplicationConsistent
LatestCrashConsistent
LatestProcessed

AlternateLocationRecoveryOption

Enumeración

Opción ALR.

Valor	Description
CreateVmIfNotFound
NoAction

CurrentScenarioDetails

Object

Detalles del escenario actual de la entidad protegida.

Nombre	Tipo	Description
jobId	string	Id. de ARM del trabajo que se está ejecutando.
scenarioName	string	Nombre del escenario.
startTime	string (date-time)	Hora de inicio del flujo de trabajo.

DataSyncStatus

Enumeración

La opción de sincronización de datos.

Valor	Description
ForDownTime
ForSynchronization

ExtendedLocation

Object

Ubicación extendida del recurso.

Nombre	Tipo	Description
name	string	Nombre de la ubicación extendida.
type	ExtendedLocationType	Tipo de ubicación extendida.

ExtendedLocationType

Enumeración

Tipo de ubicación extendida.

Valor	Description
EdgeZone

HyperVReplicaAzureRpRecoveryPointType

Enumeración

Tipo de punto de recuperación.

Valor	Description
Latest
LatestApplicationConsistent
LatestProcessed

InMageRcmFailbackRecoveryPointType

Enumeración

Tipo de punto de recuperación.

Valor	Description
ApplicationConsistent
CrashConsistent

InMageV2RpRecoveryPointType

Enumeración

Tipo de punto de recuperación.

Valor	Description
Latest
LatestApplicationConsistent
LatestCrashConsistent
LatestProcessed

MultiVmSyncPointOption

Enumeración

Valor que indica si las máquinas virtuales habilitadas para la sincronización de varias máquinas virtuales deben usar puntos de sincronización de varias máquinas virtuales para la conmutación por error.

Valor	Description
UseMultiVmSyncRecoveryPoint
UsePerVmRecoveryPoint

PossibleOperationsDirections

Enumeración

Lista de direcciones de conmutación por error.

Valor	Description
PrimaryToRecovery
RecoveryToPrimary

RecoveryPlan

Object

Detalles del plan de recuperación.

Nombre	Tipo	Description
id	string	Identificador de recurso
location	string	Ubicación del recurso
name	string	Nombre de recurso
properties	RecoveryPlanProperties	Detalles personalizados.
type	string	Tipo de recurso

RecoveryPlanA2ADetails

Object

Detalles específicos del plan de recuperación A2A.

Nombre	Tipo	Description
instanceType	string: A2A	Obtiene el tipo de instancia.
primaryExtendedLocation	ExtendedLocation	Ubicación extendida principal.
primaryZone	string	Zona primaria.
recoveryExtendedLocation	ExtendedLocation	Ubicación extendida de recuperación.
recoveryZone	string	Zona de recuperación.

RecoveryPlanA2AFailoverInput

Object

Entrada de conmutación por error del plan de recuperación A2A.

Nombre	Tipo	Description
cloudServiceCreationOption	string	Valor que indica si se va a usar el servicio en la nube de recuperación para TFO o no.
instanceType	string: A2A	Tipo de clase.
multiVmSyncPointOption	MultiVmSyncPointOption	Valor que indica si las máquinas virtuales habilitadas para la sincronización de varias máquinas virtuales deben usar puntos de sincronización de varias máquinas virtuales para la conmutación por error.
recoveryPointType	A2ARpRecoveryPointType	Tipo de punto de recuperación.

RecoveryPlanAction

Object

Detalles de la acción del plan de recuperación.

Nombre	Tipo	Description
actionName	string	Nombre de la acción.
customDetails	RecoveryPlanActionDetails: RecoveryPlanAutomationRunbookActionDetails RecoveryPlanManualActionDetails RecoveryPlanScriptActionDetails	Detalles personalizados.
failoverDirections	PossibleOperationsDirections[]	Lista de direcciones de conmutación por error.
failoverTypes	ReplicationProtectedItemOperation[]	Lista de tipos de conmutación por error.

RecoveryPlanActionLocation

Enumeración

Ubicación del tejido.

Valor	Description
Primary
Recovery

RecoveryPlanAutomationRunbookActionDetails

Object

Detalles de la acción del runbook de Automation del plan de recuperación.

Nombre	Tipo	Description
fabricLocation	RecoveryPlanActionLocation	Ubicación del tejido.
instanceType	string: AutomationRunbookActionDetails	Obtiene el tipo de detalles de la acción (vea Enumeración RecoveryPlanActionDetailsTypes para conocer los valores posibles).
runbookId	string	Identificador de ARM del runbook.
timeout	string	Tiempo de espera del runbook.

RecoveryPlanGroup

Object

Detalles del grupo del plan de recuperación.

Nombre	Tipo	Description
endGroupActions	RecoveryPlanAction[]	Acciones del grupo final.
groupType	RecoveryPlanGroupType	Tipo de grupo.
replicationProtectedItems	RecoveryPlanProtectedItem[]	Lista de elementos protegidos.
startGroupActions	RecoveryPlanAction[]	Acciones de grupo de inicio.

RecoveryPlanGroupType

Enumeración

Tipo de grupo.

Valor	Description
Boot
Failover
Shutdown

RecoveryPlanHyperVReplicaAzureFailbackInput

Object

Entrada de conmutación por recuperación del plan de recuperación HVR de Azure.

Nombre	Tipo	Description
dataSyncOption	DataSyncStatus	La opción de sincronización de datos.
instanceType	string: HyperVReplicaAzureFailback	Tipo de clase.
recoveryVmCreationOption	AlternateLocationRecoveryOption	Opción ALR.

RecoveryPlanHyperVReplicaAzureFailoverInput

Object

Entrada de conmutación por error de Azure del plan de recuperación HVR.

Nombre	Tipo	Description
instanceType	string: HyperVReplicaAzure	Tipo de clase.
primaryKekCertificatePfx	string	El certificado PFX principal de KEK.
recoveryPointType	HyperVReplicaAzureRpRecoveryPointType	Tipo de punto de recuperación.
secondaryKekCertificatePfx	string	Certificado PFX de KEK secundario.

RecoveryPlanInMageAzureV2FailoverInput

Object

Entrada de conmutación por error del plan de recuperación InMageAzureV2.

Nombre	Tipo	Description
instanceType	string: InMageAzureV2	Tipo de clase.
recoveryPointType	InMageV2RpRecoveryPointType	Tipo de punto de recuperación.
useMultiVmSyncPoint	string	Valor que indica si las máquinas virtuales habilitadas para la sincronización de varias máquinas virtuales deben usar puntos de sincronización de varias máquinas virtuales para la conmutación por error.

RecoveryPlanInMageFailoverInput

Object

Entrada de conmutación por error del plan de recuperación InMage.

Nombre	Tipo	Description
instanceType	string: InMage	Tipo de clase.
recoveryPointType	RpInMageRecoveryPointType	Tipo de punto de recuperación.

RecoveryPlanInMageRcmFailbackFailoverInput

Object

Entrada de conmutación por error del plan de recuperación InMageRcmFailback.

Nombre	Tipo	Description
instanceType	string: InMageRcmFailback	Tipo de clase.
recoveryPointType	InMageRcmFailbackRecoveryPointType	Tipo de punto de recuperación.
useMultiVmSyncPoint	string	Valor que indica si las máquinas virtuales habilitadas para la sincronización de varias máquinas virtuales deben usar puntos de sincronización de varias máquinas virtuales para la conmutación por error.

RecoveryPlanInMageRcmFailoverInput

Object

Entrada de conmutación por error del plan de recuperación InMageRcm.

Nombre	Tipo	Description
instanceType	string: InMageRcm	Tipo de clase.
recoveryPointType	RecoveryPlanPointType	Tipo de punto de recuperación.
useMultiVmSyncPoint	string	Valor que indica si las máquinas virtuales habilitadas para la sincronización de varias máquinas virtuales deben usar puntos de sincronización de varias máquinas virtuales para la conmutación por error.

RecoveryPlanManualActionDetails

Object

Detalles de la acción manual del plan de recuperación.

Nombre	Tipo	Description
description	string	Descripción de la acción manual.
instanceType	string: ManualActionDetails	Obtiene el tipo de detalles de la acción (vea Enumeración RecoveryPlanActionDetailsTypes para conocer los valores posibles).

RecoveryPlanPointType

Enumeración

Tipo de punto de recuperación.

Valor	Description
Latest
LatestApplicationConsistent
LatestCrashConsistent
LatestProcessed

RecoveryPlanProperties

Object

Propiedades del plan de recuperación.

Nombre	Tipo	Description
allowedOperations	string[]	Lista de operaciones permitidas.
currentScenario	CurrentScenarioDetails	Detalles del escenario actual.
currentScenarioStatus	string	Estado del plan de recuperación.
currentScenarioStatusDescription	string	Descripción del estado del plan de recuperación.
failoverDeploymentModel	string	Modelo de implementación de conmutación por error.
friendlyName	string	Nombre descriptivo.
groups	RecoveryPlanGroup[]	Los grupos del plan de recuperación.
lastPlannedFailoverTime	string (date-time)	Hora de inicio de la última conmutación por error planeada.
lastTestFailoverTime	string (date-time)	Hora de inicio de la última conmutación por error de prueba.
lastUnplannedFailoverTime	string (date-time)	Hora de inicio de la última conmutación por error no planeada.
primaryFabricFriendlyName	string	Nombre descriptivo del tejido principal.
primaryFabricId	string	Identificador de tejido principal.
providerSpecificDetails	RecoveryPlanProviderSpecificDetails[]: RecoveryPlanA2ADetails[]	El identificador de proveedor y los detalles específicos del proveedor.
recoveryFabricFriendlyName	string	Nombre descriptivo del tejido de recuperación.
recoveryFabricId	string	Identificador del tejido de recuperación.
replicationProviders	string[]	Lista de proveedores de replicación.

RecoveryPlanProtectedItem

Object

Elemento protegido del plan de recuperación.

Nombre	Tipo	Description
id	string	Identificador de ARM del elemento protegido del plan de recuperación.
virtualMachineId	string	Identificador de máquina virtual.

RecoveryPlanScriptActionDetails

Object

Detalles de la acción del script del plan de recuperación.

Nombre	Tipo	Description
fabricLocation	RecoveryPlanActionLocation	Ubicación del tejido.
instanceType	string: ScriptActionDetails	Obtiene el tipo de detalles de la acción (vea Enumeración RecoveryPlanActionDetailsTypes para conocer los valores posibles).
path	string	Ruta de acceso del script.
timeout	string	Tiempo de espera del script.

RecoveryPlanUnplannedFailoverInput

Object

Entrada de conmutación por error no planeada del plan de recuperación.

Nombre	Tipo	Description
properties	RecoveryPlanUnplannedFailoverInputProperties	Propiedades de entrada de conmutación por error no planeadas del plan de recuperación.

RecoveryPlanUnplannedFailoverInputProperties

Object

Propiedades de entrada de conmutación por error no planeadas del plan de recuperación.

Nombre	Tipo	Description
failoverDirection	PossibleOperationsDirections	Dirección de conmutación por error.
providerSpecificDetails	RecoveryPlanProviderSpecificFailoverInput[]: RecoveryPlanA2AFailoverInput[] RecoveryPlanHyperVReplicaAzureFailbackInput[] RecoveryPlanHyperVReplicaAzureFailoverInput[] RecoveryPlanInMageAzureV2FailoverInput[] RecoveryPlanInMageFailoverInput[] RecoveryPlanInMageRcmFailbackFailoverInput[] RecoveryPlanInMageRcmFailoverInput[]	Propiedades específicas del proveedor.
sourceSiteOperations	SourceSiteOperations	Valor que indica si se requieren operaciones de sitio de origen.

ReplicationProtectedItemOperation

Enumeración

Lista de tipos de conmutación por error.

Valor	Description
CancelFailover
ChangePit
Commit
CompleteMigration
DisableProtection
Failback
FinalizeFailback
PlannedFailover
RepairReplication
ReverseReplicate
SwitchProtection
TestFailover
TestFailoverCleanup
UnplannedFailover

RpInMageRecoveryPointType

Enumeración

Tipo de punto de recuperación.

Valor	Description
Custom
LatestTag
LatestTime

SourceSiteOperations

Enumeración

Valor que indica si se requieren operaciones de sitio de origen.

Valor	Description
NotRequired
Required

Compartir a través de

Replication Recovery Plans - Unplanned Failover

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

Execute unplanned failover of the recovery plan.

Solicitud de ejemplo

Respuesta de muestra

Definiciones

A2ARpRecoveryPointType

AlternateLocationRecoveryOption

CurrentScenarioDetails

DataSyncStatus

ExtendedLocation

ExtendedLocationType

HyperVReplicaAzureRpRecoveryPointType

InMageRcmFailbackRecoveryPointType

InMageV2RpRecoveryPointType

MultiVmSyncPointOption

PossibleOperationsDirections

RecoveryPlan

RecoveryPlanA2ADetails

RecoveryPlanA2AFailoverInput

RecoveryPlanAction

RecoveryPlanActionLocation

RecoveryPlanAutomationRunbookActionDetails

RecoveryPlanGroup

RecoveryPlanGroupType

RecoveryPlanHyperVReplicaAzureFailbackInput

RecoveryPlanHyperVReplicaAzureFailoverInput

RecoveryPlanInMageAzureV2FailoverInput

RecoveryPlanInMageFailoverInput

RecoveryPlanInMageRcmFailbackFailoverInput

RecoveryPlanInMageRcmFailoverInput

RecoveryPlanManualActionDetails

RecoveryPlanPointType

RecoveryPlanProperties

RecoveryPlanProtectedItem

RecoveryPlanScriptActionDetails

RecoveryPlanUnplannedFailoverInput

RecoveryPlanUnplannedFailoverInputProperties

ReplicationProtectedItemOperation

RpInMageRecoveryPointType

SourceSiteOperations