Instance Failover Groups - Failover
Conmuta por error desde la instancia administrada principal actual a esta instancia administrada.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}/failover?api-version=2023-08-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
failover
|
path | True |
string |
Nombre del grupo de conmutación por error. |
location
|
path | True |
string |
Nombre de la región donde se encuentra el recurso. |
resource
|
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. |
subscription
|
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 |
Conmutación por error correcta. |
|
202 Accepted |
Aceptado Encabezados Location: string |
|
Other Status Codes |
Respuestas de error: ***
|
Ejemplos
Planned failover of a failover group
Solicitud de ejemplo
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan West/instanceFailoverGroups/failover-group-test-3/failover?api-version=2023-08-01
Respuesta de muestra
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanWest/instanceFailoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/locations/instanceFailoverGroups",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerRegions": [
{
"location": "Japan East",
"replicationRole": "Secondary"
}
],
"managedInstancePairs": [
{
"primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance",
"partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance"
}
],
"secondaryType": "Geo"
}
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/JapanWest/instanceFailoverGroupOperationResults/failover-group-test-3?api-version=2022-05-01-preview
Definiciones
Nombre | Description |
---|---|
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Instance |
Un grupo de conmutación por error de instancia. |
Instance |
Punto de conexión de solo lectura de la instancia del grupo de conmutación por error. |
Instance |
Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error. |
Instance |
Rol de replicación local de la instancia del grupo de conmutación por error. |
Managed |
Pares de instancias administradas en el grupo de conmutación por error. |
Partner |
Información de la región del asociado para el grupo de conmutación por error. |
Read |
Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error. |
Read |
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. |
Secondary |
Tipo de la instancia secundaria geográfica. Establezca "En espera" si la instancia solo se usa como opción de recuperación ante desastres. |
ErrorAdditionalInfo
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
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
Mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
InstanceFailoverGroup
Un grupo de conmutación por error de instancia.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso. |
name |
string |
Nombre del recurso. |
properties.managedInstancePairs |
Lista de pares de instancias administradas en el grupo de conmutación por error. |
|
properties.partnerRegions |
Información de la región del asociado para el grupo de conmutación por error. |
|
properties.readOnlyEndpoint |
Punto de conexión de solo lectura de la instancia del grupo de conmutación por error. |
|
properties.readWriteEndpoint |
Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error. |
|
properties.replicationRole |
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 |
Tipo de la instancia secundaria geográfica. Establezca "En espera" si la instancia solo se usa como opción de recuperación ante desastres. |
|
type |
string |
Tipo de recurso. |
InstanceFailoverGroupReadOnlyEndpoint
Punto de conexión de solo lectura de la instancia del grupo de conmutación por error.
Nombre | Tipo | Description |
---|---|---|
failoverPolicy |
Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error. |
InstanceFailoverGroupReadWriteEndpoint
Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error.
Nombre | Tipo | Description |
---|---|---|
failoverPolicy |
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. |
InstanceFailoverGroupReplicationRole
Rol de replicación local de la instancia del grupo de conmutación por error.
Valor | Description |
---|---|
Primary | |
Secondary |
ManagedInstancePairInfo
Pares de instancias administradas en el grupo de conmutación por error.
Nombre | Tipo | Description |
---|---|---|
partnerManagedInstanceId |
string |
Identificador de instancia administrada del asociado en par. |
primaryManagedInstanceId |
string |
Identificador de instancia administrada principal en par. |
PartnerRegionInfo
Información de la región del asociado para el grupo de conmutación por error.
Nombre | Tipo | Description |
---|---|---|
location |
string |
Ubicación geográfica de las instancias administradas del asociado. |
replicationRole |
Rol de replicación de las instancias administradas del asociado. |
ReadOnlyEndpointFailoverPolicy
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
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 |
SecondaryInstanceType
Tipo de la instancia secundaria geográfica. Establezca "En espera" si la instancia solo se usa como opción de recuperación ante desastres.
Valor | Description |
---|---|
Geo | |
Standby |