Compartilhar via

Failover Groups - Create Or Update

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

Cria ou atualiza um grupo de failover.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2021-11-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
failoverGroupName
 path True

string

O nome do grupo de failover.
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
serverName
 path True

string

O nome do servidor que contém o grupo de failover.
subscriptionId
 path True

string

A ID de assinatura que identifica uma assinatura do Azure.
api-version
 query True

string

A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome Obrigatório Tipo Description
properties.partnerServers True

PartnerInfo[]

Lista de informações do servidor parceiro para o grupo de failover.
properties.readWriteEndpoint True

FailoverGroupReadWriteEndpoint

Ponto de extremidade de leitura/gravação da instância do grupo de failover.
properties.databases

string[]

Lista de bancos de dados no grupo de failover.
properties.readOnlyEndpoint

FailoverGroupReadOnlyEndpoint

Ponto de extremidade somente leitura da instância do grupo de failover.
tags

object

Marcas de recurso.

Respostas

Nome Tipo Description
200 OK

FailoverGroup

O grupo de failover foi atualizado com êxito.
201 Created

FailoverGroup

O grupo de failover foi criado com êxito.
202 Accepted

Aceito
Other Status Codes

Respostas de erro: ***

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases – as IDs de bancos de dados fornecidas não são IDs de recurso de banco de dados construídas corretamente. Para obter o exemplo de formatação adequada, consulte https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidPartner – o campo parceiros especificado em criar ou atualizar o corpo da solicitação do grupo de failover está vazio ou inválido. Forneça um valor válido desse campo. Para obter exemplos de solicitações formatadas corretamente, consulte https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner – um ou mais servidores parceiros fornecidos já fazem parte do grupo de failover. Verifique se o servidor primário e todos os servidores parceiros especificados são exclusivos.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer – um ou mais dos bancos de dados fornecidos não existem no servidor primário do grupo de failover. Verifique se todos os bancos de dados existem no servidor primário.

  • 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – há suporte apenas para um servidor parceiro para o Grupo de Failover. Modifique sua solicitação adequadamente. Para obter exemplos de solicitações válidas, consulte https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint – o campo readWriteEndpoint é necessário para solicitações de criação ou atualização.

  • 400 FailoverGroupCreateOrUpdateRequestInvalid – o corpo da solicitação do grupo de failover criar ou atualizar é vazio ou inválido.

  • 400 FailoverGroupUpdateOrDeleteRequestOnSecondary – Modificações no grupo de failover não são permitidas em um servidor secundário. Execute a solicitação no servidor primário.

  • 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – O valor do período de carência para o ponto de extremidade de leitura/gravação não deve ser negativo.

  • 400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - O valor do período de carência para o grupo de failover deve ser maior ou igual ao período de carência mínimo de minutos '{0}'

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - A propriedade failoverWithDataLossGracePeriodMinutes deve ser fornecida quando a política de failover Automática é selecionada para o ponto de extremidade de leitura/gravação.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - O campo failoverPolicy para o ponto de extremidade de leitura/gravação é necessário para solicitações de criação ou atualização.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – O valor do período de carência não deve ser fornecido quando a política de failover Manual é selecionada para o ponto de extremidade de leitura/gravação. Remova-o da solicitação.

  • 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - O corpo da solicitação do grupo de failover criar ou atualizar não deve modificar a propriedade somente leitura '{0}'.

  • 400 FailoverGroupFailoverRequestOnPrimary – A solicitação de failover deve ser iniciada no servidor secundário do grupo de failover.

  • 400 FailoverGroupPartnerServerFromDifferentSubscription – O servidor primário e os servidores parceiros do grupo de failover são de assinaturas diferentes. Assinatura cruzada para servidores do grupo de failover não é permitida.

  • 400 InvalidAddSecondaryPermission – O usuário não tem permissão suficiente para adicionar o secundário no servidor especificado.

  • 400 InvalidSku – o usuário especificou um sku inválido.

  • 400 ServerNotFound – O servidor solicitado não foi encontrado.

  • 400 FeatureDisabledOnSelectedEdition – o usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados.

  • 400 TokenTooLong - O token fornecido é muito longo.

  • 400 InvalidTargetSubregion – O servidor de destino de um secundário não legível não está em uma região do Azure emparelhada com DR.

  • 400 PartnerServerNotCompatible – O usuário está tentando copiar um banco de dados de um servidor SAWA V1 para um servidor Sterling ou vice-versa.

  • 400 IncorrectReplicationLinkState - A operação espera que o banco de dados esteja em um estado esperado no link de replicação.

  • 400 ResourcePoolNotFound – O pool elástico especificado não existe no servidor lógico especificado.

  • 400 AzureKeyVaultKeyDisabled - A operação não pôde ser concluída no servidor porque a chave de Key Vault do Azure está desabilitada.

  • 400 AzureKeyVaultInvalidExpirationDate - A operação não pôde ser concluída porque a data de validade da chave Key Vault do Azure é inválida.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty – A operação não pôde ser concluída porque o Uri de Key Vault do Azure é nulo ou vazio.

  • 400 AzureKeyVaultNoServerIdentity – A identidade do servidor não está configurada corretamente.

  • 400 AzureKeyVaultInvalidUri – uma resposta inválida do Azure Key Vault. Use um URI de Key Vault do Azure válido.

  • 400 AzureKeyVaultMissingPermissions – o servidor não tem as permissões necessárias no Key Vault do Azure.

  • 400 SecurityAzureKeyVaultInvalidKeyName - A operação não pôde ser concluída devido a um nome de chave de servidor inválido.

  • 400 PlannedFailoverTimedOutForDatabase - O usuário invocou recuperação panejada, atingiu o tempo limite e um banco de dados específico parece ser blame.

  • 400 PlannedFailoverTimedOut - O usuário invocou recuperação panejada e atingiu o tempo limite ao tentar entrar em contato com o serviço de gerenciamento de parceiros.

  • 400 AdalGenericError - A operação não pôde ser concluída porque um erro do Azure Active Directory foi encontrado.

  • 400 AdalServicePrincipalNotFound - A operação não pôde ser concluída porque uma entidade de serviço não encontrada na biblioteca do Azure Active Directory foi encontrada.

  • 400 AzureKeyVaultMalformedVaultUri – o uri de Key Vault fornecido não é válido.

  • 400 CannotUseReservedDatabaseName – Não é possível usar o nome do banco de dados reservado nesta operação.

  • 400 InvalidFailoverGroupRegion – Os servidores especificados em um grupo de failover precisam residir em regiões diferentes para fornecer isolamento.

  • 400 FailoverGroupDoesNotExist – o grupo de failover não existe em um servidor.

  • 400 FailoverGroupNotSecondary – O failover não pode ser iniciado do servidor primário em um grupo de failover.

  • 400 InvalidServerName - Nome do servidor inválido especificado.

  • 400 DatabaseInFailoverGroupNotPrimary – O link geoDR para o banco de dados já existe, mas sua função não é 'Primária' ou não é link de cópia contínua.

  • 400 SecurityAdalPrincipalCertExpiredError – A operação não pôde ser concluída porque o certificado principal do Azure Key Vault expirou.

  • 400 UnableToCreateFailoverGroupDueToTableAuditing – O Grupo de Failover não pode ser criado para o servidor que tem a auditoria de tabela ativada.

  • 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido.

  • 400 UnableToAddDbWithTableAuditingToFailoverGroup – O banco de dados com Auditoria de Tabela habilitada não estará acessível por meio do ponto de extremidade do Grupo de Failover.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel – o uri de Key Vault fornecido não é válido.

  • 400 KeyMaterialNotFoundOnRemoteServer – O servidor remoto não tem acesso ao material de chave usado como protetor de TDE.

  • 400 LimitOfFailoverGroupsPerServerExceeded – a criação de um novo grupo de failover excederá o número permitido de Grupos de Failover por servidor.

  • 400 SameKeyUriNotFoundOnRemoteServer – O servidor secundário não tem o material de chave do mesmo cofre de chaves que o protetor de criptografia do servidor primário com a rotação automática de chave habilitada.

  • 400 AzureKeyVaultRsaKeyNotSupported – o cofre de chaves fornecido usa tamanho de chave RSA sem suporte ou tipo de chave. O tamanho da chave RSA com suporte é 2048 ou 3072 e o Tipo de Chave é RSA ou RSA-HSM.

  • 400 SameKeyMaterialNotFoundOnRemoteServer – O servidor secundário não tem o material de chave do protetor de criptografia do servidor primário.

  • 400 GeoReplicationDatabaseNotSecondary – a operação espera que o banco de dados seja um destino de replicação.

  • 400 GeoReplicaLimitReached - O limite de replicação por réplica foi atingido.

  • 400 FailoverGroupWithVirtualNetworkRulesNotSupported – Atualmente, não há suporte para grupos de failover configurados com uma política de failover automático em servidores configurados com regras de firewall de rede virtual. Configure o grupo de failover com a política de failover manual.

  • 400 UnableToResolveRemoteServer – O nome do servidor parceiro remoto não pôde ser resolvido devido a um nome de servidor inválido ou problemas de conectividade DNS.

  • 400 RemoteDatabaseCopyPermission – O usuário não tem permissão suficiente para criar uma cópia de banco de dados no servidor especificado.

  • 400 SecurityAzureKeyVaultGeoChainError – Não há suporte para a criação do secundário (um processo conhecido como encadeamento) ao habilitar a Transparent Data Encryption usando o BYOK (Azure Key Vault).

  • 400 FailoverGroupCreateOrUpdatePartiallySucceeded - Alguns bancos de dados não puderam ser adicionados ou removidos.

  • 404 OperationIdNotFound – A operação com id não existe.

  • 404 ResourceNotFound – O recurso solicitado não foi encontrado.

  • 404 OperationIdNotFound – A operação com id não existe.

  • 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados.

  • 404 ServerNotInSubscription – O servidor especificado não existe na assinatura especificada.

  • 404 SourceDatabaseNotFound – O banco de dados de origem não existe.

  • 405 UnsupportedReplicationOperation – Uma operação de replicação sem suporte foi iniciada no banco de dados.

  • 409 OperationCancelled – A operação foi cancelada pelo usuário.

  • 409 OperationInterrupted – A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.

  • 409 ConflictingServerOperation – Uma operação está em andamento no momento para o servidor.

  • 409 Assinatura Desabilitada – A assinatura está desabilitada.

  • 409 ConflictingSystemOperationInProgress – Uma operação de manutenção do sistema está em andamento no banco de dados e outras operações precisam aguardar até que ele seja concluído.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo – O usuário tentou fazer failover ou forçar o término de um link geográfico enquanto o secundário está em um estado em que pode não ser fisicamente consistente e, portanto, não pode entrar na função primária.

  • 409 ServerKeyNameAlreadyExists – a chave do servidor já existe no servidor.

  • 409 ServerKeyUriAlreadyExists – o URI da chave do servidor já existe no servidor.

  • 409 ServerKeyDoesNotExists – a chave do servidor não existe.

  • 409 UpdateSloInProgress – o usuário tentou iniciar uma operação incompatível enquanto uma atualização slo estava em andamento.

  • 409 AzureKeyVaultKeyNameNotFound – A operação não pôde ser concluída porque o nome da chave de Key Vault do Azure não existe.

  • 409 AzureKeyVaultKeyInUse – A chave está sendo usada no momento pelo servidor.

  • 409 FailoverGroupAlreadyExists – O grupo de failover já existe em um determinado servidor. Use o nome do grupo de failover diferente.

  • 409 FailoverGroupBusy – O Grupo de Failover está ocupado com outra operação.

  • 409 DatabaseBelongsToOtherFailoverGroup – O banco de dados pertence a outro grupo de failover e não pode ser considerado uma parte deste.

  • 409 DatabaseBeingAddedToFailoverGroup – O banco de dados está sendo adicionado ao Grupo de Failover, o cliente precisa aguardar a conclusão dessa operação para emitir a remoção.

  • 409 DatabaseBeingRemovedFromFailoverGroup – O banco de dados está sendo removido do grupo de failover, o cliente precisa aguardar a conclusão dessa operação para emitir a adição.

  • 409 FailoverGroupDnsRecordInUse – existe um registro DNS duplicado para o ponto de extremidade solicitado.

  • 409 InvalidFailoverGroupName - O nome do grupo de failover inválido foi fornecido.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – Uma operação de propagação de replicação foi executada em um banco de dados que já está em uma relação de replicação.

  • 409 InvalidDatabaseStateForOperation – a operação não é permitida no banco de dados em seu estado de replicação atual.

  • 409 DuplicateGeoDrRelation – Os bancos de dados já estão em uma relação de replicação. Essa é uma solicitação duplicada.

  • 409 RemoteDatabaseExists – O nome do banco de dados de destino já existe no servidor de destino.

  • 409 FailoverGroupUnableToPerformGroupOperationOnDatabases – a lista de bancos de dados a serem adicionados/removidos de/para o Grupo de Failover contém erros que impedem a conclusão da operação.

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 503 AzureKeyVaultConnectionFailed – A operação não pôde ser concluída no servidor porque as tentativas de conexão com o Azure Key Vault falharam

  • 503 AzureKeyVaultGenericConnectionError - A operação não pôde ser concluída porque um erro foi encontrado ao tentar recuperar informações de Key Vault .

  • 503 DatabaseUnavailable – A operação falhou porque o banco de dados não está disponível.

  • 504 RequestTimeout – A solicitação de serviço excedeu o tempo limite permitido.

Exemplos

Create failover group

Solicitação de exemplo

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2021-11-01

{
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ]
  }
}

Resposta de exemplo

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

Definições

Nome Description
FailoverGroup

Um grupo de failover.
FailoverGroupReadOnlyEndpoint

Ponto de extremidade somente leitura da instância do grupo de failover.
FailoverGroupReadWriteEndpoint

Ponto de extremidade de leitura/gravação da instância do grupo de failover.
FailoverGroupReplicationRole

Função de replicação local da instância do grupo de failover.
PartnerInfo

Informações do servidor de parceiros para o grupo de failover.
ReadOnlyEndpointFailoverPolicy

Política de failover do ponto de extremidade somente leitura para o grupo de failover.
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.

FailoverGroup

Um grupo de failover.

Nome Tipo Description
id

string

ID do recurso.
location

string

Local do recurso.
name

string

Nome do recurso.
properties.databases

string[]

Lista de bancos de dados no grupo de failover.
properties.partnerServers

PartnerInfo[]

Lista de informações do servidor parceiro para o grupo de failover.
properties.readOnlyEndpoint

FailoverGroupReadOnlyEndpoint

Ponto de extremidade somente leitura da instância do grupo de failover.
properties.readWriteEndpoint

FailoverGroupReadWriteEndpoint

Ponto de extremidade de leitura/gravação da instância do grupo de failover.
properties.replicationRole

FailoverGroupReplicationRole

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.
tags

object

Marcas de recurso.
type

string

Tipo de recurso.

FailoverGroupReadOnlyEndpoint

Ponto de extremidade somente leitura da instância do grupo de failover.

Nome Tipo Description
failoverPolicy

ReadOnlyEndpointFailoverPolicy

Política de failover do ponto de extremidade somente leitura para o grupo de failover.

FailoverGroupReadWriteEndpoint

Ponto de extremidade de leitura/gravação da instância do grupo de failover.

Nome Tipo Description
failoverPolicy

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.
failoverWithDataLossGracePeriodMinutes

integer

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.

Nome Tipo Description
Primary

string

Secondary

string

PartnerInfo

Informações do servidor de parceiros para o grupo de failover.

Nome Tipo Description
id

string

Identificador de recurso do servidor parceiro.
location

string

Localização geográfica do servidor parceiro.
replicationRole

FailoverGroupReplicationRole

Função de replicação do servidor parceiro.

ReadOnlyEndpointFailoverPolicy

Política de failover do ponto de extremidade somente leitura para o grupo de failover.

Nome Tipo Description
Disabled

string

Enabled

string

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.

Nome Tipo Description
Automatic

string

Manual

string