Failover Groups - Try Planned Before Forced Failover
Faz failover do servidor primário atual para este servidor. Essa operação tenta ser planejada antes do failover forçado, mas ainda pode resultar em perda de dados.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}/tryPlannedBeforeForcedFailover?api-version=2025-01-01
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
failover
|
path | True |
string |
O nome do grupo de failover. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
server
|
path | True |
string |
O nome do servidor. |
|
subscription
|
path | True |
string (uuid) |
A ID da assinatura de destino. O valor deve ser uma UUID. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
Operação do Azure concluída com sucesso. |
|
| 202 Accepted |
Operação de recurso aceita. Cabeçalhos
|
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
| Nome | Description |
|---|---|
| user_impersonation | representar sua conta de usuário |
Exemplos
Try planned before forced failover of a failover group
Solicitação de exemplo
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver/failoverGroups/failovergrouptest3/tryPlannedBeforeForcedFailover?api-version=2025-01-01
Resposta de exemplo
{
"name": "failovergrouptest3",
"type": "Microsoft.Sql/servers/failoverGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver/failoverGroups/failovergrouptest3",
"location": "Japan West",
"properties": {
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver/databases/testdb1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver/databases/testdb2"
],
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver",
"location": "Japan East",
"replicationRole": "Secondary"
}
],
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver"
},
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 120
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP"
}
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japanwest/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111
Definições
| Nome | Description |
|---|---|
|
created |
O tipo de identidade que criou o recurso. |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
Failover |
Um grupo de failover. |
|
Failover |
Tipo secundário de bancos de dados no servidor parceiro. |
|
Failover |
Ponto de extremidade somente leitura da instância do grupo de failover. |
|
Failover |
Ponto de extremidade de leitura/gravação da instância do grupo de failover. |
|
Failover |
Função de replicação local da instância do grupo de failover. |
|
Partner |
Informações do servidor parceiro para o grupo de failover. |
|
Read |
Política de failover do ponto de extremidade somente leitura para o grupo de failover. |
|
Read |
Política de failover do ponto de extremidade de leitura/gravação para o grupo de failover. Se failoverPolicy for Automático, o failoverWithDataLossGracePeriodMinutes será necessário. |
|
system |
Metadados relativos à criação e última modificação do recurso. |
createdByType
O tipo de identidade que criou o recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
| Nome | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Nome | Tipo | Description |
|---|---|---|
| additionalInfo |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
FailoverGroup
Um grupo de failover.
| Nome | Tipo | Description |
|---|---|---|
| id |
string (arm-id) |
ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| location |
string |
Local do recurso. |
| name |
string |
O nome do recurso |
| properties.databases |
string[] (arm-id) |
Lista de bancos de dados no grupo de failover. |
| properties.partnerServers |
Lista de informações do servidor parceiro para o grupo de failover. |
|
| properties.readOnlyEndpoint |
Ponto de extremidade somente leitura da instância do grupo de failover. |
|
| properties.readWriteEndpoint |
Ponto de extremidade de leitura/gravação da instância do grupo de failover. |
|
| properties.replicationRole |
Função de replicação local da instância do grupo de failover. |
|
| properties.replicationState |
string |
Estado de replicação da instância do grupo de failover. |
| properties.secondaryType |
Tipo secundário de bancos de dados no servidor parceiro. |
|
| systemData |
Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy. |
|
| tags |
object |
Tags de recursos. |
| type |
string |
O tipo do recurso. Por exemplo, "Microsoft. Compute/virtualMachines" ou "Microsoft. ContasArmazenamento/Armazenamento" |
FailoverGroupDatabasesSecondaryType
Tipo secundário de bancos de dados no servidor parceiro.
| Valor | Description |
|---|---|
| Geo |
Geo |
| Standby |
Em espera |
FailoverGroupReadOnlyEndpoint
Ponto de extremidade somente leitura da instância do grupo de failover.
| Nome | Tipo | Description |
|---|---|---|
| failoverPolicy |
Política de failover do ponto de extremidade somente leitura para o grupo de failover. |
|
| targetServer |
string (arm-id) |
O servidor de parceiro de destino para o qual o ponto de extremidade somente leitura aponta. |
FailoverGroupReadWriteEndpoint
Ponto de extremidade de leitura/gravação da instância do grupo de failover.
| Nome | Tipo | Description |
|---|---|---|
| failoverPolicy |
Política de failover do ponto de extremidade de leitura/gravação para o grupo de failover. Se failoverPolicy for Automático, o failoverWithDataLossGracePeriodMinutes será necessário. |
|
| failoverWithDataLossGracePeriodMinutes |
integer (int32) |
Período de carência antes do failover com perda de dados é tentado para o ponto de extremidade de leitura/gravação. Se failoverPolicy for Automático, o failoverWithDataLossGracePeriodMinutes será necessário. |
FailoverGroupReplicationRole
Função de replicação local da instância do grupo de failover.
| Valor | Description |
|---|---|
| Primary |
Primária |
| Secondary |
Secundário |
PartnerInfo
Informações do servidor parceiro para o grupo de failover.
| Nome | Tipo | Description |
|---|---|---|
| id |
string (arm-id) |
Identificador de recurso do servidor parceiro. |
| location |
string |
Localização geográfica do servidor parceiro. |
| replicationRole |
Função de replicação do servidor parceiro. |
ReadOnlyEndpointFailoverPolicy
Política de failover do ponto de extremidade somente leitura para o grupo de failover.
| Valor | Description |
|---|---|
| Disabled |
Desactivado |
| Enabled |
Habilitado |
ReadWriteEndpointFailoverPolicy
Política de failover do ponto de extremidade de leitura/gravação para o grupo de failover. Se failoverPolicy for Automático, o failoverWithDataLossGracePeriodMinutes será necessário.
| Valor | Description |
|---|---|
| Manual |
Manual |
| Automatic |
Automático |
systemData
Metadados relativos à criação e última modificação do recurso.
| Nome | Tipo | Description |
|---|---|---|
| createdAt |
string (date-time) |
O carimbo de data/hora da criação de recursos (UTC). |
| createdBy |
string |
A identidade que criou o recurso. |
| createdByType |
O tipo de identidade que criou o recurso. |
|
| lastModifiedAt |
string (date-time) |
O carimbo de data/hora da última modificação do recurso (UTC) |
| lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
| lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |