Instance Failover Groups - List By Location

Lista os grupos de failover num local.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups?api-version=2021-02-01-preview

Parâmetros do URI

Name In Required Type Description
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 do Azure Resource Manager API 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.

Respostas

Name Type Description
200 OK

Recuperou com sucesso os grupos de falhanços.

Other Status Codes

Respostas de erro: ***

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner - O campo de parceiros dado em criar ou atualizar o corpo de pedido de grupo de failover de instâncias está vazio ou inválido.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner - Um ou mais dos servidores parceiros fornecidos já fazem parte do grupo de failover de instância. 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âncias 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 falha de caso de criação ou atualização de instâncias 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 falha de propriedade com DataLossGracePeriodMinutes 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 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - 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 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModidified - O órgão de pedido de grupo de imculação de instância de criação ou atualização não deve modificar a propriedade apenas de leitura '{0}'.

  • 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 Azure Key Vault certificado principal 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 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 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 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 É 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 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 carácter inválido de unicódigo.

  • 400 TokenTooLong - O token 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 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 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 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 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 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 FeatureDisabledOnSelectedEdition - O utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados.

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

  • 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 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 ConflituosaOperação deServer - Está em curso uma operação para o servidor.

  • 409 SubscriçãoDisável - 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 de 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 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 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.

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

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

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

Exemplos

List failover group

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups?api-version=2021-02-01-preview

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test",
      "name": "failover-group-test",
      "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-1",
      "name": "failover-group-test-1",
      "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-1",
            "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance-1"
          }
        ]
      }
    }
  ]
}

Definições

InstanceFailoverGroup

Um grupo de falhanços de exemplo.

InstanceFailoverGroupListResult

Uma lista de grupos de falhanços de exemplo.

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 de failover.

ManagedInstancePairInfo

Pares de casos geridos 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 de exemplo.

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 de failover.

properties.replicationState
  • string

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

type
  • string

Tipo de recurso.

InstanceFailoverGroupListResult

Uma lista de grupos de falhanços de exemplo.

Name Type Description
nextLink
  • string

Ligue para recuperar a próxima página de resultados.

value

Conjunto de resultados.

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 de failover.

Name Type Description
Primary
  • string
Secondary
  • string

ManagedInstancePairInfo

Pares de casos geridos 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