Failover Groups - Failover

Referencia

Servicio:: SQL Database

Versión de la API:: 2023-08-01

Conmuta por error desde el servidor principal actual a este servidor.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}/failover?api-version=2023-08-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
failoverGroupName	path	True	string	Nombre del grupo de conmutación por error.
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.
serverName	path	True	string	Nombre del servidor que contiene el grupo de conmutación por error.
subscriptionId	path	True	string	Identificador de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	Versión de la API que se va a usar para la solicitud.

Respuestas

Nombre	Tipo	Description
200 OK	FailoverGroup	Conmutación por error correcta.
202 Accepted		Aceptado Encabezados Location: string
Other Status Codes	ErrorResponse	Respuestas de error: *** 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases: los identificadores de bases de datos proporcionados no se construyen correctamente. Para obtener el ejemplo de formato adecuado, consulte https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestInvalidPartner: el campo asociados especificado en el cuerpo de la solicitud del grupo de conmutación por error de creación o actualización está vacío o no es válido. Proporcione un valor válido de este campo. Para obtener ejemplos de solicitudes con formato correcto, consulte https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner: uno o varios de los servidores asociados proporcionados ya forman parte del grupo de conmutación por error. Asegúrese de que el servidor principal y todos los servidores asociados especificados sean únicos. 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer: una o varias de las bases de datos proporcionadas no existen en el servidor principal del grupo de conmutación por error. Asegúrese de que todas las bases de datos existen en el servidor principal. 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount: solo se admite un servidor asociado para el grupo de conmutación por error. Modifique la solicitud según corresponda. Para obtener ejemplos de solicitudes válidas, consulte https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint: el campo readWriteEndpoint es necesario para las solicitudes de creación o actualización. 400 FailoverGroupCreateOrUpdateRequestInvalid: el cuerpo de la solicitud del grupo de conmutación por error de creación o actualización está vacío o no es válido. 400 FailoverGroupUpdateOrDeleteRequestOnSecondary: no se permiten modificaciones en el grupo de conmutación por error en un servidor secundario. Ejecute la solicitud en el servidor principal. 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues: el valor de período de gracia para el punto de conexión de lectura y escritura debe ser no negativo. 400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues: el valor de período de gracia para el grupo de conmutación por error debe ser mayor o igual que el período de gracia mínimo de "{0}" minutos 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields: la conmutación por error de la propiedadWithDataLossGracePeriodMinutes debe proporcionarse cuando la directiva de conmutación por error Automática está seleccionada para el punto de conexión de lectura y escritura. 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy: el campo failoverPolicy para el punto de conexión de lectura y escritura es necesario para las solicitudes de creación o actualización. 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy: el valor del período de gracia no debe proporcionarse cuando se selecciona manual de directiva de conmutación por error para el punto de conexión de lectura y escritura. Quítelo de la solicitud. 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified: el cuerpo de la solicitud del grupo de conmutación por error de creación o actualización no debe modificar la propiedad de solo lectura "{0}". 400 FailoverGroupFailoverRequestOnPrimary: la solicitud de conmutación por error debe iniciarse en el servidor secundario del grupo de conmutación por error. 400 FailoverGroupPartnerServerFromDifferentSubscription: el servidor principal y los servidores asociados del grupo de conmutación por error proceden de distintas suscripciones. No se permite la suscripción cruzada para servidores del grupo de conmutación por error. 400 FailoverGroupCreateOrUpdateRequestInvalidReadOnlyEndpointTargetServer: la propiedad targetServer del punto de conexión de solo lectura debe ser un servidor válido presente entre los asociadosServidores configurados para el grupo de conmutación por error. 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCountForStandby: solo se admite un servidor asociado para el grupo de conmutación por error para secondaryType en espera. Modifique la solicitud según corresponda. 400 InvalidServerName: nombre de servidor no válido especificado. 400 InvalidIdentifier: el identificador contiene NULL o un carácter unicode no válido. 400 TokenTooLong: el token proporcionado es demasiado largo. 400 InvalidAddSecondaryPermission: el usuario no tiene permiso suficiente para agregar secundario en el servidor especificado. 400 InvalidSku: el usuario especificó una SKU no válida. 400 ServerNotFound: no se encontró el servidor solicitado. 400 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos. 400 TokenTooLong: el token proporcionado es demasiado largo. 400 InvalidTargetSubregion: el servidor de destino de una base de datos secundaria no legible no está en una región de Azure emparejada con recuperación ante desastres. 400 PartnerServerNotCompatible: el usuario está intentando copiar una base de datos de un servidor SAWA V1 a un servidor Sterling o viceversa. 400 IncorrectReplicationLinkState: la operación espera que la base de datos esté en un estado esperado en el vínculo de replicación. 400 ResourcePoolNotFound: el grupo elástico especificado no existe en el servidor lógico especificado. 400 AzureKeyVaultKeyDisabled: no se pudo completar la operación en el servidor porque la clave de Azure Key Vault está deshabilitada. 400 AzureKeyVaultInvalidExpirationDate: no se pudo completar la operación porque la fecha de expiración de la clave de Azure Key Vault no es válida. 400 SecurityAzureKeyVaultUrlNullOrEmpty: no se pudo completar la operación porque el URI de Azure Key Vault es nulo o está vacío. 400 AzureKeyVaultNoServerIdentity: la identidad del servidor no está configurada correctamente. 400 AzureKeyVaultInvalidUri: una respuesta no válida de Azure Key Vault. Use un URI de Azure Key Vault válido. 400 AzureKeyVaultMissingPermissions: faltan permisos necesarios en el servidor de Azure Key Vault. 400 SecurityAzureKeyVaultInvalidKeyName: no se pudo completar la operación debido a un nombre de clave de servidor no válido. 400 PlannedFailoverTimedOutForDatabase: el usuario invocó la conmutación por error planeada, se agota el tiempo de espera y parece que una base de datos específica es culpa. 400 PlannedFailoverTimedOut: el usuario invocó la conmutación por error planeada y agota el tiempo de espera al intentar ponerse en contacto con el servicio de administración de partners. 400 AdalGenericError: no se pudo completar la operación porque se encontró un error de Azure Active Directory. 400 AdalServicePrincipalNotFound: no se pudo completar la operación porque no se encontró un error en una entidad de servicio de biblioteca de Azure Active Directory. 400 AzureKeyVaultMalformedVaultUri: el URI proporcionado de Key Vault no es válido. 400 CannotUseReservedDatabaseName: no se puede usar el nombre reservado de la base de datos en esta operación. 400 InvalidFailoverGroupRegion: los servidores especificados en un grupo de conmutación por error deben residir en regiones diferentes para proporcionar aislamiento. 400 FailoverGroupDoesNotExist: el grupo de conmutación por error no existe en un servidor. 400 FailoverGroupNotSecondary: no se puede iniciar la conmutación por error desde el servidor principal en un grupo de conmutación por error. 400 InvalidServerName: nombre de servidor no válido especificado. 400 DatabaseInFailoverGroupNotPrimary: el vínculo GeoDR para la base de datos ya existe, pero su rol no es "Principal" o no es un vínculo de copia continua. 400 SecurityAdalPrincipalCertExpiredError: no se pudo completar la operación porque el certificado de entidad de seguridad de Azure Key Vault ha expirado. 400 UnableToCreateFailoverGroupDueToTableAuditing: no se puede crear el grupo de conmutación por error para el servidor que tenga activada la auditoría de tablas. 400 InvalidIdentifier: el identificador contiene NULL o un carácter unicode no válido. 400 UnableToAddDbWithTableAuditingToFailoverGroup: la base de datos con auditoría de tabla habilitada no será accesible a través del punto de conexión del grupo de conmutación por error. 400 SecurityInvalidAzureKeyVaultRecoveryLevel: el URI proporcionado de Key Vault no es válido. 400 KeyMaterialNotFoundOnRemoteServer: el servidor remoto no tiene acceso al material de clave usado como protector TDE. 400 LimitOfFailoverGroupsPerServerExceeded: la creación de un nuevo grupo de conmutación por error superará el número permitido de grupos de conmutación por error por servidor. 400 SameKeyUriNotFoundOnRemoteServer: el servidor secundario no tiene el material de clave del mismo almacén de claves que el protector de cifrado del servidor principal con la rotación automática de claves habilitada. 400 AzureKeyVaultRsaKeyNotSupported: el almacén de claves proporcionado usa el tamaño de clave RSA o el tipo de clave RSA no admitidos. El tamaño de clave RSA admitido es 2048 o 3072 y el tipo de clave es RSA o RSA-HSM. 400 SameKeyMaterialNotFoundOnRemoteServer: el servidor secundario no tiene el material clave del protector de cifrado del servidor principal. 400 GeoReplicationDatabaseNotSecondary: la operación espera que la base de datos sea un destino de replicación. 400 GeoReplicaLimitReached: se alcanzó el límite de replicación por réplica. 400 FailoverGroupWithVirtualNetworkRulesNotSupported: los grupos de conmutación por error configurados con una directiva de conmutación automática por error no se admiten actualmente en servidores configurados con reglas de firewall de red virtual. Configure el grupo de conmutación por error con la directiva de conmutación por error manual. 400 UnableToResolveRemoteServer: no se pudo resolver el nombre del servidor asociado remoto debido a problemas de conectividad dns o nombre de servidor no válidos. 400 RemoteDatabaseCopyPermission: el usuario no tiene permiso suficiente para crear una copia de base de datos en el servidor especificado. 400 SecurityAzureKeyVaultGeoChainError: no se admite la creación de una base de datos secundaria (un proceso conocido como encadenamiento) al habilitar el cifrado de datos transparente mediante Azure Key Vault (BYOK). 404 OperationIdNotFound: la operación con id. no existe. 404 ResourceNotFound: no se encontró el recurso solicitado. 404 OperationIdNotFound: la operación con id. no existe. 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados. 404 ServerNotInSubscription: el servidor especificado no existe en la suscripción especificada. 404 SourceDatabaseNotFound: la base de datos de origen no existe. 405 NosupportedReplicationOperation: se inició una operación de replicación no admitida en la base de datos. 409 CannotCancelOperation: la operación de administración está en un estado que no se puede cancelar. 409 OperationCancelled: el usuario canceló la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió otra operación en el mismo recurso. 409 ConflictingServerOperation: una operación está actualmente en curso para el servidor. 409 SubscriptionDisabled: la suscripción está deshabilitada. 409 ConflictingSystemOperationInProgress: una operación de mantenimiento del sistema está en curso en la base de datos y las operaciones adicionales deben esperar hasta que se complete. 409 GeoReplicationCannotBecomePrimaryDuringUndo: el usuario intentó conmutar por error o forzar la finalización de un vínculo geográfico mientras la base de datos secundaria está en un estado en el que es posible que no sea físicamente coherente y, por tanto, no pueda entrar en el rol principal. 409 ServerKeyNameAlreadyExists: la clave de servidor ya existe en el servidor. 409 ServerKeyUriAlreadyExists: el URI de la clave de servidor ya existe en el servidor. 409 ServerKeyDoesNotExists: la clave del servidor no existe. 409 UpdateSloInProgress: el usuario intentó iniciar una operación incompatible mientras estaba en curso una actualización de SLO. 409 AzureKeyVaultKeyNameNotFound: no se pudo completar la operación porque el nombre de la clave de Azure Key Vault no existe. 409 AzureKeyVaultKeyInUse: el servidor usa actualmente la clave. 409 FailoverGroupAlreadyExists: el grupo de conmutación por error ya existe en un servidor determinado. Use otro nombre de grupo de conmutación por error. 409 FailoverGroupBusy: el grupo de conmutación por error está ocupado con otra operación. 409 DatabaseBelongsToOtherFailoverGroup: la base de datos pertenece a otro grupo de conmutación por error y no puede considerarse parte de esta. 409 DatabaseBeingAddedToFailoverGroup: la base de datos se está agregando actualmente al grupo de conmutación por error, el cliente debe esperar a que esta operación termine de emitir la eliminación. 409 DatabaseBeingRemovedFromFailoverGroup: la base de datos se está quitando actualmente del grupo de conmutación por error, el cliente debe esperar a que esta operación termine de emitirse. 409 FailoverGroupDnsRecordInUse: existe un registro DNS duplicado para el punto de conexión solicitado. 409 InvalidFailoverGroupName: se proporcionó un nombre de grupo de conmutación por error no válido. 409 InvalidOperationForDatabaseNotInReplicationRelationship: se realizó una operación de replicación en una base de datos que no está en una relación de replicación. 409 InvalidDatabaseStateForOperation: la operación no se permite en la base de datos en su estado de replicación actual. 409 DuplicateGeoDrRelation: las bases de datos ya están en una relación de replicación. Se trata de una solicitud duplicada. 409 RemoteDatabaseExists: el nombre de la base de datos de destino ya existe en el servidor de destino. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles. 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles. 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación. 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles. 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles. 503 AzureKeyVaultConnectionFailed: no se pudo completar la operación en el servidor porque se ha producido un error al intentar conectarse a Azure Key Vault 503 AzureKeyVaultGenericConnectionError: no se pudo completar la operación porque se encontró un error al intentar recuperar información de Key Vault. 503 DatabaseUnavailable: error en la operación porque la base de datos no está disponible. 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Nombre

Tipo

Description

200 OK

FailoverGroup

Conmutación por error correcta.

202 Accepted

Aceptado

Encabezados

Location: string

Other Status Codes

ErrorResponse

Respuestas de error: ***

400 FailoverGroupCreateOrUpdateRequestInvalidDatabases: los identificadores de bases de datos proporcionados no se construyen correctamente. Para obtener el ejemplo de formato adecuado, consulte https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate
400 FailoverGroupCreateOrUpdateRequestInvalidPartner: el campo asociados especificado en el cuerpo de la solicitud del grupo de conmutación por error de creación o actualización está vacío o no es válido. Proporcione un valor válido de este campo. Para obtener ejemplos de solicitudes con formato correcto, consulte https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate
400 FailoverGroupCreateOrUpdateRequestDuplicatePartner: uno o varios de los servidores asociados proporcionados ya forman parte del grupo de conmutación por error. Asegúrese de que el servidor principal y todos los servidores asociados especificados sean únicos.
400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer: una o varias de las bases de datos proporcionadas no existen en el servidor principal del grupo de conmutación por error. Asegúrese de que todas las bases de datos existen en el servidor principal.
400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount: solo se admite un servidor asociado para el grupo de conmutación por error. Modifique la solicitud según corresponda. Para obtener ejemplos de solicitudes válidas, consulte https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint: el campo readWriteEndpoint es necesario para las solicitudes de creación o actualización.
400 FailoverGroupCreateOrUpdateRequestInvalid: el cuerpo de la solicitud del grupo de conmutación por error de creación o actualización está vacío o no es válido.
400 FailoverGroupUpdateOrDeleteRequestOnSecondary: no se permiten modificaciones en el grupo de conmutación por error en un servidor secundario. Ejecute la solicitud en el servidor principal.
400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues: el valor de período de gracia para el punto de conexión de lectura y escritura debe ser no negativo.
400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues: el valor de período de gracia para el grupo de conmutación por error debe ser mayor o igual que el período de gracia mínimo de "{0}" minutos
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields: la conmutación por error de la propiedadWithDataLossGracePeriodMinutes debe proporcionarse cuando la directiva de conmutación por error Automática está seleccionada para el punto de conexión de lectura y escritura.
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy: el campo failoverPolicy para el punto de conexión de lectura y escritura es necesario para las solicitudes de creación o actualización.
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy: el valor del período de gracia no debe proporcionarse cuando se selecciona manual de directiva de conmutación por error para el punto de conexión de lectura y escritura. Quítelo de la solicitud.
400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified: el cuerpo de la solicitud del grupo de conmutación por error de creación o actualización no debe modificar la propiedad de solo lectura "{0}".
400 FailoverGroupFailoverRequestOnPrimary: la solicitud de conmutación por error debe iniciarse en el servidor secundario del grupo de conmutación por error.
400 FailoverGroupPartnerServerFromDifferentSubscription: el servidor principal y los servidores asociados del grupo de conmutación por error proceden de distintas suscripciones. No se permite la suscripción cruzada para servidores del grupo de conmutación por error.
400 FailoverGroupCreateOrUpdateRequestInvalidReadOnlyEndpointTargetServer: la propiedad targetServer del punto de conexión de solo lectura debe ser un servidor válido presente entre los asociadosServidores configurados para el grupo de conmutación por error.
400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCountForStandby: solo se admite un servidor asociado para el grupo de conmutación por error para secondaryType en espera. Modifique la solicitud según corresponda.
400 InvalidServerName: nombre de servidor no válido especificado.
400 InvalidIdentifier: el identificador contiene NULL o un carácter unicode no válido.
400 TokenTooLong: el token proporcionado es demasiado largo.
400 InvalidAddSecondaryPermission: el usuario no tiene permiso suficiente para agregar secundario en el servidor especificado.
400 InvalidSku: el usuario especificó una SKU no válida.
400 ServerNotFound: no se encontró el servidor solicitado.
400 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos.
400 TokenTooLong: el token proporcionado es demasiado largo.
400 InvalidTargetSubregion: el servidor de destino de una base de datos secundaria no legible no está en una región de Azure emparejada con recuperación ante desastres.
400 PartnerServerNotCompatible: el usuario está intentando copiar una base de datos de un servidor SAWA V1 a un servidor Sterling o viceversa.
400 IncorrectReplicationLinkState: la operación espera que la base de datos esté en un estado esperado en el vínculo de replicación.
400 ResourcePoolNotFound: el grupo elástico especificado no existe en el servidor lógico especificado.
400 AzureKeyVaultKeyDisabled: no se pudo completar la operación en el servidor porque la clave de Azure Key Vault está deshabilitada.
400 AzureKeyVaultInvalidExpirationDate: no se pudo completar la operación porque la fecha de expiración de la clave de Azure Key Vault no es válida.
400 SecurityAzureKeyVaultUrlNullOrEmpty: no se pudo completar la operación porque el URI de Azure Key Vault es nulo o está vacío.
400 AzureKeyVaultNoServerIdentity: la identidad del servidor no está configurada correctamente.
400 AzureKeyVaultInvalidUri: una respuesta no válida de Azure Key Vault. Use un URI de Azure Key Vault válido.
400 AzureKeyVaultMissingPermissions: faltan permisos necesarios en el servidor de Azure Key Vault.
400 SecurityAzureKeyVaultInvalidKeyName: no se pudo completar la operación debido a un nombre de clave de servidor no válido.
400 PlannedFailoverTimedOutForDatabase: el usuario invocó la conmutación por error planeada, se agota el tiempo de espera y parece que una base de datos específica es culpa.
400 PlannedFailoverTimedOut: el usuario invocó la conmutación por error planeada y agota el tiempo de espera al intentar ponerse en contacto con el servicio de administración de partners.
400 AdalGenericError: no se pudo completar la operación porque se encontró un error de Azure Active Directory.
400 AdalServicePrincipalNotFound: no se pudo completar la operación porque no se encontró un error en una entidad de servicio de biblioteca de Azure Active Directory.
400 AzureKeyVaultMalformedVaultUri: el URI proporcionado de Key Vault no es válido.
400 CannotUseReservedDatabaseName: no se puede usar el nombre reservado de la base de datos en esta operación.
400 InvalidFailoverGroupRegion: los servidores especificados en un grupo de conmutación por error deben residir en regiones diferentes para proporcionar aislamiento.
400 FailoverGroupDoesNotExist: el grupo de conmutación por error no existe en un servidor.
400 FailoverGroupNotSecondary: no se puede iniciar la conmutación por error desde el servidor principal en un grupo de conmutación por error.
400 InvalidServerName: nombre de servidor no válido especificado.
400 DatabaseInFailoverGroupNotPrimary: el vínculo GeoDR para la base de datos ya existe, pero su rol no es "Principal" o no es un vínculo de copia continua.
400 SecurityAdalPrincipalCertExpiredError: no se pudo completar la operación porque el certificado de entidad de seguridad de Azure Key Vault ha expirado.
400 UnableToCreateFailoverGroupDueToTableAuditing: no se puede crear el grupo de conmutación por error para el servidor que tenga activada la auditoría de tablas.
400 InvalidIdentifier: el identificador contiene NULL o un carácter unicode no válido.
400 UnableToAddDbWithTableAuditingToFailoverGroup: la base de datos con auditoría de tabla habilitada no será accesible a través del punto de conexión del grupo de conmutación por error.
400 SecurityInvalidAzureKeyVaultRecoveryLevel: el URI proporcionado de Key Vault no es válido.
400 KeyMaterialNotFoundOnRemoteServer: el servidor remoto no tiene acceso al material de clave usado como protector TDE.
400 LimitOfFailoverGroupsPerServerExceeded: la creación de un nuevo grupo de conmutación por error superará el número permitido de grupos de conmutación por error por servidor.
400 SameKeyUriNotFoundOnRemoteServer: el servidor secundario no tiene el material de clave del mismo almacén de claves que el protector de cifrado del servidor principal con la rotación automática de claves habilitada.
400 AzureKeyVaultRsaKeyNotSupported: el almacén de claves proporcionado usa el tamaño de clave RSA o el tipo de clave RSA no admitidos. El tamaño de clave RSA admitido es 2048 o 3072 y el tipo de clave es RSA o RSA-HSM.
400 SameKeyMaterialNotFoundOnRemoteServer: el servidor secundario no tiene el material clave del protector de cifrado del servidor principal.
400 GeoReplicationDatabaseNotSecondary: la operación espera que la base de datos sea un destino de replicación.
400 GeoReplicaLimitReached: se alcanzó el límite de replicación por réplica.
400 FailoverGroupWithVirtualNetworkRulesNotSupported: los grupos de conmutación por error configurados con una directiva de conmutación automática por error no se admiten actualmente en servidores configurados con reglas de firewall de red virtual. Configure el grupo de conmutación por error con la directiva de conmutación por error manual.
400 UnableToResolveRemoteServer: no se pudo resolver el nombre del servidor asociado remoto debido a problemas de conectividad dns o nombre de servidor no válidos.
400 RemoteDatabaseCopyPermission: el usuario no tiene permiso suficiente para crear una copia de base de datos en el servidor especificado.
400 SecurityAzureKeyVaultGeoChainError: no se admite la creación de una base de datos secundaria (un proceso conocido como encadenamiento) al habilitar el cifrado de datos transparente mediante Azure Key Vault (BYOK).
404 OperationIdNotFound: la operación con id. no existe.
404 ResourceNotFound: no se encontró el recurso solicitado.
404 OperationIdNotFound: la operación con id. no existe.
404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.
404 ServerNotInSubscription: el servidor especificado no existe en la suscripción especificada.
404 SourceDatabaseNotFound: la base de datos de origen no existe.
405 NosupportedReplicationOperation: se inició una operación de replicación no admitida en la base de datos.
409 CannotCancelOperation: la operación de administración está en un estado que no se puede cancelar.
409 OperationCancelled: el usuario canceló la operación.
409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió otra operación en el mismo recurso.
409 ConflictingServerOperation: una operación está actualmente en curso para el servidor.
409 SubscriptionDisabled: la suscripción está deshabilitada.
409 ConflictingSystemOperationInProgress: una operación de mantenimiento del sistema está en curso en la base de datos y las operaciones adicionales deben esperar hasta que se complete.
409 GeoReplicationCannotBecomePrimaryDuringUndo: el usuario intentó conmutar por error o forzar la finalización de un vínculo geográfico mientras la base de datos secundaria está en un estado en el que es posible que no sea físicamente coherente y, por tanto, no pueda entrar en el rol principal.
409 ServerKeyNameAlreadyExists: la clave de servidor ya existe en el servidor.
409 ServerKeyUriAlreadyExists: el URI de la clave de servidor ya existe en el servidor.
409 ServerKeyDoesNotExists: la clave del servidor no existe.
409 UpdateSloInProgress: el usuario intentó iniciar una operación incompatible mientras estaba en curso una actualización de SLO.
409 AzureKeyVaultKeyNameNotFound: no se pudo completar la operación porque el nombre de la clave de Azure Key Vault no existe.
409 AzureKeyVaultKeyInUse: el servidor usa actualmente la clave.
409 FailoverGroupAlreadyExists: el grupo de conmutación por error ya existe en un servidor determinado. Use otro nombre de grupo de conmutación por error.
409 FailoverGroupBusy: el grupo de conmutación por error está ocupado con otra operación.
409 DatabaseBelongsToOtherFailoverGroup: la base de datos pertenece a otro grupo de conmutación por error y no puede considerarse parte de esta.
409 DatabaseBeingAddedToFailoverGroup: la base de datos se está agregando actualmente al grupo de conmutación por error, el cliente debe esperar a que esta operación termine de emitir la eliminación.
409 DatabaseBeingRemovedFromFailoverGroup: la base de datos se está quitando actualmente del grupo de conmutación por error, el cliente debe esperar a que esta operación termine de emitirse.
409 FailoverGroupDnsRecordInUse: existe un registro DNS duplicado para el punto de conexión solicitado.
409 InvalidFailoverGroupName: se proporcionó un nombre de grupo de conmutación por error no válido.
409 InvalidOperationForDatabaseNotInReplicationRelationship: se realizó una operación de replicación en una base de datos que no está en una relación de replicación.
409 InvalidDatabaseStateForOperation: la operación no se permite en la base de datos en su estado de replicación actual.
409 DuplicateGeoDrRelation: las bases de datos ya están en una relación de replicación. Se trata de una solicitud duplicada.
409 RemoteDatabaseExists: el nombre de la base de datos de destino ya existe en el servidor de destino.
429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.
429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.
429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.
429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.
500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación.
503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.
503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.
503 AzureKeyVaultConnectionFailed: no se pudo completar la operación en el servidor porque se ha producido un error al intentar conectarse a Azure Key Vault
503 AzureKeyVaultGenericConnectionError: no se pudo completar la operación porque se encontró un error al intentar recuperar información de Key Vault.
503 DatabaseUnavailable: error en la operación porque la base de datos no está disponible.
504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

Planned failover of a failover group

Solicitud de ejemplo

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/failoverGroups/failover-group-test-3/failover?api-version=2023-08-01

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan West",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 120
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled",
      "targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server",
        "location": "Japan East",
        "replicationRole": "Secondary"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-2"
    ]
  }
}

status code:: 202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japanwest/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111

Definiciones

Nombre	Description
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
FailoverGroup	Un grupo de conmutación por error.
FailoverGroupDatabasesSecondaryType	Tipo secundario de bases de datos en el servidor asociado.
FailoverGroupReadOnlyEndpoint	Punto de conexión de solo lectura de la instancia del grupo de conmutación por error.
FailoverGroupReadWriteEndpoint	Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error.
FailoverGroupReplicationRole	Rol de replicación local de la instancia del grupo de conmutación por error.
PartnerInfo	Información del servidor asociado para el grupo de conmutación por error.
ReadOnlyEndpointFailoverPolicy	Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error.
ReadWriteEndpointFailoverPolicy	Directiva de conmutación por error del punto de conexión de lectura y escritura para el grupo de conmutación por error. Si failoverPolicy es Automático, se requiere conmutación por errorWithDataLossGracePeriodMinutes.

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

FailoverGroup

Object

Un grupo de conmutación por error.

Nombre	Tipo	Description
id	string	Identificador de recurso.
location	string	Ubicación del recurso.
name	string	Nombre del recurso.
properties.databases	string[] (arm-id)	Lista de bases de datos del grupo de conmutación por error.
properties.partnerServers	PartnerInfo[]	Lista de información del servidor asociado para el grupo de conmutación por error.
properties.readOnlyEndpoint	FailoverGroupReadOnlyEndpoint	Punto de conexión de solo lectura de la instancia del grupo de conmutación por error.
properties.readWriteEndpoint	FailoverGroupReadWriteEndpoint	Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error.
properties.replicationRole	FailoverGroupReplicationRole	Rol de replicación local de la instancia del grupo de conmutación por error.
properties.replicationState	string	Estado de replicación de la instancia del grupo de conmutación por error.
properties.secondaryType	FailoverGroupDatabasesSecondaryType	Tipo secundario de bases de datos en el servidor asociado.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.

FailoverGroupDatabasesSecondaryType

Enumeración

Tipo secundario de bases de datos en el servidor asociado.

Valor	Description
Geo
Standby

FailoverGroupReadOnlyEndpoint

Object

Punto de conexión de solo lectura de la instancia del grupo de conmutación por error.

Nombre	Tipo	Description
failoverPolicy	ReadOnlyEndpointFailoverPolicy	Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error.
targetServer	string (arm-id)	Servidor asociado de destino al que apunta el punto de conexión de solo lectura.

FailoverGroupReadWriteEndpoint

Object

Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error.

Nombre	Tipo	Description
failoverPolicy	ReadWriteEndpointFailoverPolicy	Directiva de conmutación por error del punto de conexión de lectura y escritura para el grupo de conmutación por error. Si failoverPolicy es Automático, se requiere conmutación por errorWithDataLossGracePeriodMinutes.
failoverWithDataLossGracePeriodMinutes	integer (int32)	Período de gracia antes de la conmutación por error con pérdida de datos se intenta para el punto de conexión de lectura y escritura. Si failoverPolicy es Automático, se requiere conmutación por errorWithDataLossGracePeriodMinutes.

FailoverGroupReplicationRole

Enumeración

Rol de replicación local de la instancia del grupo de conmutación por error.

Valor	Description
Primary
Secondary

PartnerInfo

Object

Información del servidor asociado para el grupo de conmutación por error.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recursos del servidor asociado.
location	string	Ubicación geográfica del servidor asociado.
replicationRole	FailoverGroupReplicationRole	Rol de replicación del servidor asociado.

ReadOnlyEndpointFailoverPolicy

Enumeración

Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error.

Valor	Description
Disabled
Enabled

ReadWriteEndpointFailoverPolicy

Enumeración

Directiva de conmutación por error del punto de conexión de lectura y escritura para el grupo de conmutación por error. Si failoverPolicy es Automático, se requiere conmutación por errorWithDataLossGracePeriodMinutes.

Valor	Description
Automatic
Manual

Compartir a través de

Failover Groups - Failover

Parámetros de identificador URI

Respuestas

Ejemplos

Planned failover of a failover group

Solicitud de ejemplo

Respuesta de muestra

Definiciones

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FailoverGroup

FailoverGroupDatabasesSecondaryType

FailoverGroupReadOnlyEndpoint

FailoverGroupReadWriteEndpoint

FailoverGroupReplicationRole

PartnerInfo

ReadOnlyEndpointFailoverPolicy

ReadWriteEndpointFailoverPolicy

Recursos adicionales