Failover Groups - Try Planned Before Forced Failover
Failover do servidor primário atual para este servidor. Esta operação tenta planejar 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 do URI
| Name | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
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 um UUID. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a utilizar para esta operação. |
Respostas
| Name | Tipo | Descrição |
|---|---|---|
| 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
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
| Name | Descrição |
|---|---|
| user_impersonation | personificar a sua conta de utilizador |
Exemplos
Try planned before forced failover of a failover group
Pedido de amostra
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 da amostra
{
"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
| Name | Descrição |
|---|---|
|
created |
O tipo de identidade que criou o recurso. |
|
Error |
O erro de gerenciamento de recursos informações adicionais. |
|
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 Automatic então failoverWithDataLossGracePeriodMinutes será necessário. |
|
system |
Metadados referentes à criação e última modificação do recurso. |
createdByType
O tipo de identidade que criou o recurso.
| Valor | Descrição |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
O erro de gerenciamento de recursos informações adicionais.
| Name | Tipo | Descrição |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Name | Tipo | Descrição |
|---|---|---|
| additionalInfo |
O erro informações adicionais. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O alvo do erro. |
ErrorResponse
Resposta de erro
| Name | Tipo | Descrição |
|---|---|---|
| error |
O objeto de erro. |
FailoverGroup
Um grupo de failover.
| Name | Tipo | Descrição |
|---|---|---|
| id |
string (arm-id) |
ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| location |
string |
Localização 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. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento" |
FailoverGroupDatabasesSecondaryType
Tipo secundário de bancos de dados no servidor parceiro.
| Valor | Descrição |
|---|---|
| Geo |
Geografia |
| Standby |
Standby |
FailoverGroupReadOnlyEndpoint
Ponto de extremidade somente leitura da instância do grupo de failover.
| Name | Tipo | Descrição |
|---|---|---|
| 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.
| Name | Tipo | Descrição |
|---|---|---|
| failoverPolicy |
Política de failover do ponto de extremidade de leitura-gravação para o grupo de failover. Se failoverPolicy for Automatic então failoverWithDataLossGracePeriodMinutes será necessário. |
|
| failoverWithDataLossGracePeriodMinutes |
integer (int32) |
O 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 Automatic então failoverWithDataLossGracePeriodMinutes será necessário. |
FailoverGroupReplicationRole
Função de replicação local da instância do grupo de failover.
| Valor | Descrição |
|---|---|
| Primary |
Primário |
| Secondary |
Secundária |
PartnerInfo
Informações do servidor parceiro para o grupo de failover.
| Name | Tipo | Descrição |
|---|---|---|
| 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 | Descrição |
|---|---|
| Disabled |
Disabled |
| Enabled |
Ativado |
ReadWriteEndpointFailoverPolicy
Política de failover do ponto de extremidade de leitura-gravação para o grupo de failover. Se failoverPolicy for Automatic então failoverWithDataLossGracePeriodMinutes será necessário.
| Valor | Descrição |
|---|---|
| Manual |
Manual |
| Automatic |
Automático |
systemData
Metadados referentes à criação e última modificação do recurso.
| Name | Tipo | Descrição |
|---|---|---|
| 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. |