Instance Failover Groups - Create Or Update

Cria ou atualiza um grupo de failover.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{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.

locationName
path True
  • string

O nome da região onde se encontra o recurso.

resourceGroupName
path True
  • string

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

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.managedInstancePairs True

Lista de pares de instâncias geridos no grupo de failover.

properties.partnerRegions True

Informação da região parceira para o grupo de failover.

properties.readWriteEndpoint True

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

properties.readOnlyEndpoint

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

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 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner - O campo de parceiros dado em criar ou atualizar o grupo de pedidos de failover está vazio ou inválido.

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion - O parceiro gerido região de instância no caso de failover grupo request body é vazio ou inválido.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - Apenas uma região parceira é apoiada.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount - Apenas um par de instâncias gerido é suportado.

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid - O corpo de pedido de grupo de falha de caso de criação ou atualização está vazio ou inválido.

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

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - 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 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadReaditeFailoverPolicy - O campo failoverPolicy para o ponto final de escrita de leitura é necessário para criar ou atualizar pedidos.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadReaditeEndpointFieldsForManualPolicy - 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.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - O órgão de pedido de grupo de falha de imagem de criar ou atualizar instância não deve modificar a propriedade apenas de {0} leitura'.

  • 400 InstanceFailoverGroupFailoverRequestOnPrimary - O pedido de falha deve ser iniciado no grupo de failover do servidor secundário de instância.

  • 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - O servidor principal e o servidor parceiro do grupo failover são de diferentes subscrições. Não é permitida a subscrição cruzada para servidores do grupo failover.

  • 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 GeoDrInstanceSizeMismatch - Instância gerida primária e caso gerido por parceiros não têm o mesmo tamanho de armazenamento.

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

  • 400 GeoDrSecondaryInstanceNotEmpty - Instância gerida secundária tem bases de dados de utilizadores. Para criar um grupo de casos falhado, o caso secundário gerido precisa de ser vazio.

  • 400 InstanceFailoverGroupIncorrectNetworkConfiguration - A configuração de rede está incorreta. O tráfego de replicação do servidor primário não pode chegar ao servidor secundário.

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

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - O uri key vault fornecido não é válido.

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

  • 400 AzureKeyVaultMismatchError - Região inesperada do Cofre de Chaves 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 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 Não ÉServiadoDatabaseName - Não pode utilizar o nome de base de dados reservado nesta operação.

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

  • 400 InstanceFailoverGroupDoesNotExist - Grupo failover não existe num servidor.

  • 400 InstanceFailoverGroupNotSecondary - Failover não pode ser iniciado a partir do servidor primário num grupo de failover de exemplo.

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

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

  • 400 TokenTooLong - O símbolo fornecido é demasiado longo.

  • 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 da chave Azure Key Vault é inválida.

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

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

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

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

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

  • 400 AzureKeyVaultInvalidUri - Uma resposta inválida do Cofre da Chave Azure. Por favor, utilize um Cofre de Chave Azure válido URI.

  • 400 AzureKeyVaultMissingPermissions - Falta o servidor com permissões necessárias no Cofre da Chave Azure.

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

  • 400 PlanificamentoSTimedOutForDatabase - 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 do Diretório Azure Ative.

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

  • 400 AdalServicePrincipalNotFound - A operação não pôde ser concluída porque um Diretor de Serviço de Biblioteca Azure Ative Não encontrou erro.

  • 400 AzureKeyVaultMalformedVaultUri - O uri key vault fornecido não é válido.

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

  • 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 SourceDatabaseNotFound - A base de dados de origem não existe.

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

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

  • 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 no mesmo recurso.

  • 409 ManagedInstanceHasHybridLink - O utilizador tentou iniciar uma operação que não é suportada quando a instância gerida tem uma ligação híbrida configurada.

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

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

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

  • 409 InstanceFailoverGroupAlreadyExists - Grupo Failover já existe num determinado servidor.

  • 409 InstanceFailoverGroupBusy - Instance failover group is busy with another operation.

  • 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 InstanceFailoverGroupDnsRecordInUse - Existe um registo de DNS duplicado para o ponto final solicitado.

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

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

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

  • 409 InvalidFailoverGroupName - Nome do Grupo de Failover de Instância Inválida foi fornecido.

  • 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 da chave Azure Key Vault não existe.

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

  • 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 InvalidetionForDatabaseNotInReplicationRationship - 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.

  • 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 Cofre da Chave Azure falharam

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

  • 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/locations/Japan East/instanceFailoverGroups/failover-group-test-3?api-version=2021-02-01-preview
{
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "partnerRegions": [
      {
        "location": "Japan West"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/failoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/failoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}

Definições

InstanceFailoverGroup

Um grupo de falhanços.

InstanceFailoverGroupReadOnlyEndpoint

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

InstanceFailoverGroupReadWriteEndpoint

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

InstanceFailoverGroupReplicationRole

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

ManagedInstancePairInfo

Pares de instâncias geridas no grupo de failover.

PartnerRegionInfo

Informação da região parceira 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.

InstanceFailoverGroup

Um grupo de falhanços.

Name Type Description
id
  • string

Identificação de recursos.

name
  • string

Nome de recurso.

properties.managedInstancePairs

Lista de pares de instâncias geridos no grupo de failover.

properties.partnerRegions

Informação da região parceira 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 failover.

properties.replicationState
  • string

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

type
  • string

Tipo de recurso.

InstanceFailoverGroupReadOnlyEndpoint

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.

InstanceFailoverGroupReadWriteEndpoint

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.

InstanceFailoverGroupReplicationRole

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

Name Type Description
Primary
  • string
Secondary
  • string

ManagedInstancePairInfo

Pares de instâncias geridas no grupo de failover.

Name Type Description
partnerManagedInstanceId
  • string

ID de Partner Managed Instance em par.

primaryManagedInstanceId
  • string

ID da Primeira Instância Gerida em par.

PartnerRegionInfo

Informação da região parceira para o grupo de failover.

Name Type Description
location
  • string

Geo localização do parceiro geriu instâncias.

replicationRole

Papel de replicação do parceiro gerido casos.

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