Failover Groups - Create Or Update

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-02-01-preview

Parâmetros do URI

Name In Required Type Description
failoverGroupName
path True
  • string

O nome do grupo de falhanços.

resourceGroupName
path True
  • string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir do Azure Resource Manager API ou do portal.

serverName
path True
  • string

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

subscriptionId
path True
  • string

O ID de subscrição que identifica uma subscrição do Azure.

api-version
query True
  • string

A versão API a utilizar para o pedido.

Corpo do Pedido

Name Required Type Description
properties.partnerServers True

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

properties.readWriteEndpoint True

Ler-escrever ponto final da instância do grupo de failover.

properties.databases
  • string[]

Lista de bases de dados no grupo de failover.

properties.readOnlyEndpoint

Ponto final apenas de leitura da instância do grupo de failover.

tags
  • object

Etiquetas de recursos.

Respostas

Name Type Description
200 OK

Atualizou com sucesso o grupo de failover.

201 Created

Criou com sucesso o grupo de falhanços.

202 Accepted

Aceite

Other Status Codes

Respostas de erro: ***

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases - As bases de dados fornecidas IDs não são identificações de recursos de base de dados devidamente construídas. Para o exemplo de formatação adequada ver https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidPartner - O campo de parceiros dado no conjunto de pedidos de grupo de criação ou atualização está vazio ou inválido. Por favor, forneça o seu valor válido. Por exemplo, pedidos devidamente formatados ver https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner - Um ou mais dos servidores parceiros fornecidos já fazem parte do grupo de failover. Certifique-se de que o servidor primário e todos os servidores de parceiros são únicos.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer - Uma ou mais das bases de dados fornecidas não existem no servidor primário do grupo de failover. Por favor, certifique-se de que todas as bases de dados existem no servidor principal.

  • 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - Apenas um servidor parceiro do Grupo Failover é suportado. Por favor, modifique o seu pedido em conformidade. Para exemplos de pedidos válidos ver https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - O campo readWriteEndpoint é necessário para criar ou atualizar pedidos.

  • 400 FailoverGroupCreateOrUpdateRequestInvalid - O corpo de pedido de grupo de failover de criar ou atualizar está vazio ou inválido.

  • 400 FailoverGroupUpdateOrDeleteRequestOnSecondary - Não são permitidas modificações no grupo de failover num servidor secundário. Execute o pedido no servidor primário.

  • 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - O valor do período de graça para o ponto final de escrita de leitura deve não ser negativo.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - A falência da propriedade ComDataLossGracePeriodMinutes deve ser fornecida quando a política de failover Automatic é selecionada para o ponto final de leitura-escrita.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadFoiditeFailoverPolicy - O campo failoverPolicy para o ponto final de leitura-escrita é necessário para criar ou atualizar pedidos.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadReadpointEndpointFieldsForManualPolicy - O valor do período de graça não deve ser fornecido quando o manual de política de failover é selecionado para o ponto final de leitura-escrita. Por favor, remova-o do pedido.

  • 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - O organismo de pedido de grupo de failover de criar ou atualizar não deve modificar a propriedade apenas de leitura '{0}'.

  • 400 FailoverGroupFailoverRequestOnPrimary - O pedido de falha deve ser iniciado no servidor secundário do grupo failover.

  • 400 FailoverGroupPartnerServerFromDifferentSubscription - O servidor primário e os servidores parceiros do grupo failover são de diferentes subscrições. Não é permitida a subscrição cruzada para servidores do grupo failover.

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

  • 400 InvalidSku - O utilizador especificou uma sku inválida.

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

  • 400 FeatureDisabledOnSelectedEdition - O utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados.

  • 400 TokenTooLong - O token fornecido é demasiado longo.

  • 400 InvalidTargetSubregion - O servidor alvo de um secundário não legível não se encontra numa região de Azure emparelhada com DR.

  • 400 PartnerServerNotCompatible - O utilizador está a tentar copiar uma base de dados de um servidor SAWA V1 para um servidor Sterling ou vice-versa.

  • 400 IncorrectReplicationLinkState - A operação espera que a base de dados esteja num estado esperado na ligação de replicação.

  • 400 RecursosPoolNotFound - Piscina elástica especificada não existe no servidor lógico especificado.

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

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

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

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

  • 400 AzureKeyVaultInvalidUri - Uma resposta inválida da Azure Key Vault. Por favor, utilize um Azure Key Vault URI válido.

  • 400 AzureKeyVaultMissingPermissions - Falta permissões necessárias no Azure Key Vault.

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

  • 400 PlanificamentoAmentoTimedOutForDatabase - O utilizador invocou o failover planeado, o tempo limite e uma base de dados específica parece ser a culpa.

  • 400 PlannedFailoverTimedOut - O utilizador invocou o failover planeado, e foi cronometrado enquanto tentava contactar o serviço de gestão de parceiros.

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

  • 400 AdalServicePrincipalNotFound - A operação não pôde ser concluída porque um Azure Ative Directory de serviço de biblioteca principal não encontrou erro.

  • 400 AzureKeyVaultMalformedVaultUri - O Key Vault uri fornecido não é válido.

  • 400 Não É Possível Utilizar DatabaseName - Não pode utilizar o nome de base de dados reservado nesta operação.

  • 400 InvalidFailoverGroupRegion - Os servidores especificados num Grupo failover precisam de residir em diferentes regiões para proporcionar isolamento.

  • 400 FailoverGroupDoesNotExist - Grupo Failover não existe num servidor.

  • 400 FailoverGroupNotSecondary - Failover não pode ser iniciado a partir do servidor primário num Grupo failover.

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

  • 400 DatabaseInFailoverGroupNotPrimary - Ligação GeoDR para a base de dados já existe, mas a sua função não é 'Primária' ou não é uma ligação de cópia contínua.

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

  • 400 UnableToCreateFailoverGroupDueToTableAuditing - Grupo Failover não pode ser criado para servidor que tenha a auditoria de tabela ligada.

  • 400 InvalidIdentifier - O identificador contém NUNão ou um carácter inválido de unicódigo.

  • 400 UnableToAddDbWithTableAuditingToFailoverGroup - Base de dados com auditoria de tabela ativada não será acessível através do ponto final do Grupo Failover.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - O Key Vault uri fornecido não é válido.

  • 400 KeyMaterialNotFoundOnRemoteServer - O servidor remoto não tem acesso a material chave utilizado como protetor TDE.

  • 400 LimitOfFailoverGroupsPerServerExceeded - A criação de um novo Grupo de Failover excederá o número permitido de Grupos de Failover por servidor.

  • 400 AzureKeyVaultMismatchError - Região de Key Vault inesperada encontrada na resposta http.

  • 400 AzureKeyVaultRsaKeyNotSupported - O cofre de chaves fornecido utiliza tamanho ou tipo de chave RSA não suportado. O tamanho da chave RSA suportado é 2048 ou 3072 e o Tipo chave é RSA ou RSA-HSM.

  • 400 GeoReplicationDatabaseNotSecondary - A operação espera que a base de dados seja um alvo de replicação.

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

  • 400 FailoverGroupWithVirtualNetworkRulesNotSupported - Grupos de failover configurados com uma política automática de falha não são atualmente suportados em servidores configurados com regras de firewall de rede virtual. Por favor, configuure o grupo de failover com a política de failover manual.

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

  • 400 RemoteDatabaseCopyPermission - O utilizador não tem permissão suficiente para criar uma cópia de base de dados no servidor especificado.

  • 400 SecurityAzureKeyVaultGeoChainError - A criação secundária de secundário (um processo conhecido como chaining) não é suportada ao permitir Encriptação de Dados Transparente utilizando a Azure Key Vault (BYOK).

  • 400 FailoverGroupCreateOrUpdatePartialmenteSuded - Algumas bases de dados não puderam ser adicionadas ou removidas.

  • 404 OperaçãoIdNotFound - A operação com ID não existe.

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

  • 404 OperaçãoIdNotFound - A operação com ID não existe.

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos especificado e na subscrição.

  • 404 ServerNotInSubscription - O servidor especificado não existe na subscrição especificada.

  • 404 SourceDatabaseNotFound - A base de dados de origem não existe.

  • 405 Não apoiada Cooperação DeReplicação - Foi iniciada uma operação de replicação não apoiada na base de dados.

  • 409 OperaçãoCanceled - A operação foi cancelada pelo utilizador.

  • 409 Operação Interrompida - A operação do recurso não pôde ser concluída porque foi interrompida por outra operação sobre o mesmo recurso.

  • 409 ConflituosaOperação deServer - Está em curso uma operação para o servidor.

  • 409 SubscriçãoDisável - A subscrição está desativada.

  • 409 ConflictingSystemOperationInProgress - Está em curso uma operação de manutenção do sistema na base de dados e as operações adicionais têm de aguardar até que esteja concluída.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo - O utilizador tentou falhar ou pôr à força um geoligação enquanto o secundário se encontra num estado em que pode não ser fisicamente consistente e, portanto, não pode entrar no papel principal.

  • 409 ServerKeyNameAlreadyExists - A chave do servidor já existe no servidor.

  • 409 ServerKeyUriAlreadyExists - A chave de servidor URI já existe no servidor.

  • 409 ServerKeyDoesNotExists - A chave do servidor não existe.

  • 409 UpdateSloInProgress - O utilizador tentou iniciar uma operação incompatível enquanto estava em curso uma atualização SLO.

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

  • 409 AzureKeyVaultKeyInUse - A chave está atualmente a ser utilizada pelo servidor.

  • 409 FailoverGroupAlreadyExists - Grupo Failover já existe num determinado servidor. Por favor, utilize diferentes nomes do Grupo Failover.

  • 409 FailoverGroupBusy - Grupo Failover está ocupado com outra operação.

  • 409 DatabaseBelongsToOtherFailoverGroup - Base de dados pertence a outro Grupo de Failover e não pode ser considerado parte deste.

  • 409 DatabaseBeingAddedToFailoverGroup - A base de dados está atualmente a ser adicionada ao Grupo Failover, o cliente precisa de esperar que esta operação termine de ser removida.

  • 409 DatabaseBeingRemovedFromFailoverGroup - A base de dados está atualmente a ser removida do grupo failover, o cliente precisa de esperar que esta operação termine de emitir adição.

  • 409 FailoverGroupDnsRecordInUse - Existe um registo DNS duplicado para o ponto final solicitado.

  • 409 InvalidFailoverGroupName - Nome do Grupo Desnudo Falha foi fornecido.

  • 409 InvalidetionForDatabaseNotInReplicationRelationship - Foi realizada uma operação de sementeira de replicação numa base de dados que já se encontra numa relação de replicação.

  • 409 InvalidDatabaseStateForOperation - A operação não é permitida na base de dados no seu estado atual de replicação.

  • 409 DuplicateGeoDrRelation - As bases de dados já se encontram numa relação de replicação. Este é um pedido duplicado.

  • 409 RemoteDatabaseExists - O nome da base de dados de destino já existe no servidor de destino.

  • 409 FailoverGroupUnableToPerformGroupOperationOnDatabases - A lista de bases de dados a adicionar/remover para/do Grupo Failover contém erros que impedem o funcionamento para ser concluído.

  • 429 SubscriçõesTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 429 SubscriçõesTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 500 OperationTimedOut - A operação foi cronometrada e retroceda automaticamente. Repita a operação.

  • 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

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

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

  • 503 DatabaseUn disponível - A operação falhou porque a base de dados não está disponível.

  • 504 RequestTimeout - Pedido de serviço excedeu o tempo limite permitido.

Exemplos

Create failover group

Sample Request

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-02-01-preview

{
  "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"
    ]
  }
}

Sample Response

{
  "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"
    ]
  }
}
{
  "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"
    ]
  }
}

Definições

FailoverGroup

Um grupo de falhanços.

FailoverGroupReadOnlyEndpoint

Ponto final apenas de leitura da instância do grupo de failover.

FailoverGroupReadWriteEndpoint

Ler-escrever ponto final da instância do grupo de failover.

FailoverGroupReplicationRole

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

PartnerInfo

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

ReadOnlyEndpointFailoverPolicy

Política de failover do ponto final apenas de leitura para o grupo de failover.

ReadWriteEndpointFailoverPolicy

Política de failover do ponto final de leitura-escrita para o grupo de failover. Se falhar A política é automática, então é necessário falhar com oDataLossGracePeriodMinutes.

FailoverGroup

Um grupo de falhanços.

Name Type Description
id
  • string

Identificação de recursos.

location
  • string

Localização do recurso.

name
  • string

Nome de recurso.

properties.databases
  • string[]

Lista de bases de dados no grupo de failover.

properties.partnerServers

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

properties.readOnlyEndpoint

Ponto final apenas de leitura da instância do grupo de failover.

properties.readWriteEndpoint

Ler-escrever ponto final da instância do grupo de failover.

properties.replicationRole

Papel 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

Etiquetas de recursos.

type
  • string

Tipo de recurso.

FailoverGroupReadOnlyEndpoint

Ponto final apenas de leitura da instância do grupo de failover.

Name Type Description
failoverPolicy

Política de failover do ponto final apenas de leitura para o grupo de failover.

FailoverGroupReadWriteEndpoint

Ler-escrever ponto final da instância do grupo de failover.

Name Type Description
failoverPolicy

Política de failover do ponto final de leitura-escrita para o grupo de failover. Se falhar A política é automática, então é necessário falhar com oDataLossGracePeriodMinutes.

failoverWithDataLossGracePeriodMinutes
  • integer

O período de graça antes do failover com a perda de dados é tentado para o ponto final de leitura-escrita. Se falhar A política é automática, então é necessário falhar com oDataLossGracePeriodMinutes.

FailoverGroupReplicationRole

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

Name Type Description
Primary
  • string
Secondary
  • string

PartnerInfo

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

Name Type Description
id
  • string

Identificador de recursos do servidor parceiro.

location
  • string

Localização geo do servidor do parceiro.

replicationRole

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

ReadOnlyEndpointFailoverPolicy

Política de failover do ponto final apenas de leitura para o grupo de failover.

Name Type Description
Disabled
  • string
Enabled
  • string

ReadWriteEndpointFailoverPolicy

Política de failover do ponto final de leitura-escrita para o grupo de failover. Se falhar A política é automática, então é necessário falhar com oDataLossGracePeriodMinutes.

Name Type Description
Automatic
  • string
Manual
  • string