Distributed Availability Groups - List By Instance

Obtém uma lista de grupos de disponibilidade distribuídos na instância.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/distributedAvailabilityGroups?api-version=2021-11-01

Parâmetros de URI

Name In Required Type Description
managedInstanceName
path True
  • string

O nome da instância gerenciada.

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.

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.

Respostas

Name Type Description
200 OK

Recuperou com êxito a lista de grupos de disponibilidade distribuídos.

Other Status Codes

Respostas de erro: ***

  • 400 NameAlreadyExists - O nome fornecido já existe.

  • 400 InvalidCollation – ordenação inválida.

  • 400 Provisionamento Desabilitado – Exibe a mensagem de erro do autorizador de operação de recursos como está, sem alterações

  • 400 RegionDoesNotAllowProvisioning - O local selecionado não está aceitando novos servidores de Banco de Dados do Windows SQL do Azure. Isso pode mudar posteriormente.

  • 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 HkCannotSwitchToInactive - O banco de dados não pode continuar com a atualização do tipo de preço, pois tem objetos com otimização de memória. Solte esses objetos e tente novamente.

  • 400 TokenTooLong – O token fornecido é muito longo.

  • 400 CloudLifterUnsupportedFeature - A funcionalidade não está disponível no Instância Gerenciada no momento.

  • A operação 400 ManagedInstanceSloUpdateFailed – SLO '{0}' não pode ter êxito, pois o uso de memória de '{1}' excede a cota.

  • 400 OperationCanNotStartDueToMiLink – A operação '{0}' não pode ser concluída, pois existe um banco de dados em um processo de criação por meio de Instância Gerenciada link. Aguarde a conclusão da criação do link ou exclua o link e repita a operação novamente.

  • 400 ManagedInstanceLocalStorageUpdateSloDisabled - Atualize o SLO para instâncias gerenciadas com armazenamento local ainda não tem suporte.

  • 400 InvalidSubnetResourceId - A ID de recurso de sub-rede fornecida para a criação ou atualização da instância gerenciada é inválida.

  • 400 VnetInWrongRegion – A rede virtual está na região errada.

  • 400 AlterDbDeactivatedNotSupported - Falha na operação de banco de dados para o servidor '{0}', banco de dados '{1}' devido a um atraso inesperado. Tente novamente.

  • 400 VnetAddressRangeError – O intervalo de endereços de rede virtual é inválido.

  • 400 RegionDoesNotSupportVersion - Um usuário tentou criar um servidor de uma versão especificada em um local onde essa versão do servidor não tem suporte.

  • 400 VnetConfigIsNotAllowed – A configuração de rede virtual não é permitida.

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

  • 400 ManagedInstanceClassicVnetNotSupported - Instância Gerenciada não pode ser ingressado em uma rede virtual clássica.

  • 400 VnetConfigHasNsg – O usuário tentou injetar a sub-rede do Servidor Gerenciado com Grupos de Segurança de Rede.

  • 400 VnetConfigHasNoUdr – O usuário tentou injetar a sub-rede do Servidor Gerenciado sem a Tabela de Rota Definida pelo Usuário padrão.

  • 400 VnetConfigHasInvalidUdr - O usuário tentou injetar a sub-rede do Servidor Gerenciado com uma tabela de rota definida pelo usuário inválida.

  • 400 VnetConfigHasInvalidDns – o usuário tentou injetar a sub-rede do Servidor Gerenciado com DNS personalizado inválido.

  • 400 VnetConfigHasServiceEndpoints – o usuário tentou injetar a sub-rede do Servidor Gerenciado com pontos de extremidade de serviço.

  • 400 VnetSubnetIsInUse – o usuário tentou injetar a sub-rede do Servidor Gerenciado que não está vazia.

  • 400 VnetSubnetIsLocked – o usuário tentou injetar a sub-rede do Servidor Gerenciado que está no escopo bloqueado.

  • 400 VnetSubnetIsGateway – O usuário tentou injetar a sub-rede do Servidor Gerenciado que é a sub-rede do Gateway.

  • 400 VnetSubnetIsUnknown – o usuário tentou injetar a sub-rede do Servidor Gerenciado que não existe.

  • 400 VnetSubnetConflictWithIntendedPolicy - O usuário tentou injetar a sub-rede do Servidor Gerenciado que tem um conflito com a IntendedPolicy.

  • 400 ManagedInstanceInvalidEditionForSku - A edição {0} especificada não é consistente com a SKU {1}especificada.

  • 400 ManagedInstanceInvalidLicenseType - O tipo {0} de licença especificado não é válido.

  • 400 ManagedInstanceUpdateSloInProgress - "A operação não pôde ser concluída porque uma alteração de camada de serviço está em andamento para a instância gerenciada '{0}.' Aguarde a conclusão da operação em andamento e tente novamente."

  • 400 VnetResourceNotFound - Recurso não encontrado: '{0}'.

  • 400 InstanceCollationUpdateNotSupported - O usuário não pode alterar a ordenação da instância no Instância Gerenciada.

  • 400 CreateManagedInstanceWithNonDefaultCollationNotSupported - O usuário pode criar um Instância Gerenciada somente com ordenação 'SQL_Latin1_General_CP1_CI_AS'.

  • 400 ManagedInstanceOperationInProgress - A operação não pôde ser concluída porque {0} a operação está em andamento. Aguarde a conclusão da operação em andamento e tente novamente.

  • 400 ManagedInstanceExceedMaxAzureStorage - A operação não pôde ser concluída porque o tamanho total do armazenamento alocado para Uso Geral instância excederia {0}. Reduza o número de arquivos de banco de dados e a operação de repetição.

  • 400 ManagedInstanceHasGeoReplica - A operação não pôde ser concluída porque a instância configurou a instância secundária replicada geograficamente.

  • 400 InvalidDnsZone - A operação falhou porque você está tentando implantar a instância gerenciada como uma replicação geográfica secundária para a sub-rede {0} na qual já existe uma instância gerenciada. A implantação da instância gerenciada como um secundário de replicação geográfica só tem suporte em casos em que a instância gerenciada é a primeira instância implantada em uma sub-rede. Considere implantar a instância gerenciada como um secundário de replicação geográfica em uma sub-rede diferente na qual não há instâncias gerenciadas existentes ou se a implantação em uma sub-rede com a instância gerenciada existente desabilitar a opção de replicação geográfica.

  • 400 ManagedInstanceInvalidStorageSizeLessThenCurrentSizeUsed - Tamanho de armazenamento inválido: o limite de tamanho de armazenamento ({0} GB) é menor que o armazenamento atual usado ({1} GB). Especifique um limite de tamanho de armazenamento maior.

  • 400 InvalidTimezone – Fuso horário inválido.

  • 400 InstanceTimezoneUpdateNotSupported - Atualização de fuso horário da instância sem suporte.

  • 400 CreateManagedInstanceWithNonDefaultTimezoneNotSupported - Criar Instância Gerenciada com fuso horário não padrão sem suporte.

  • 400 ManagedInstanceIpAddressRangeLimit - Não é possível executar a criação/dimensionamento da instância gerenciada, pois não há endereços IP disponíveis suficientes na sub-rede para executar a operação.

  • 400 VnetDelegationNotAllowed - O usuário tentou injetar o Servidor Gerenciado na sub-rede delegada.

  • 400 SubnetHasResourcesOfDifferentType – o usuário tentou criar MI na sub-rede que tem recursos de tipo diferente.

  • 400 UpdateManagedServerWithMaintenanceWindowNotAllowed - A atualização de Instância Gerenciada com configurações de janela de manutenção não é permitida.

  • 400 VnetPrepareNIPFailed - O usuário tentou preparar a sub-rede que tem um conflito com NetworkIntentPolicy.

  • 400 ManagedInstanceDeprecatedHardwareFamily - Não é possível alterar a geração de hardware para a geração preterida {0} .

  • 400 ManagedInstanceBackupStorageTypeNotSupported – O parâmetro de tipo de armazenamento de backup não é permitido na operação de atualização da instância.

  • 400 EmptyPDCInvalidDnsZone - Essa instância gerenciada não pode ser implantada porque sua zona DNS não corresponde ao prefixo DNS de seu cluster virtual pretendido para sub-rede {0}. Embora esse cluster virtual esteja vazio, seu prefixo DNS não pode ser alterado. Clusters virtuais vazios serão removidos automaticamente após várias horas. Considere esperar que esse cluster virtual expire ou exclua manualmente esse cluster virtual e, em seguida, crie a instância gerenciada.

  • 400 MissingIdentityId - Nenhuma identidade atribuída pelo usuário é fornecida quando o tipo de identidade é definido como UserAssigned

  • 400 InvalidPrimaryIdentityId - O usuário fornece um valor para PrimaryUserIdentityId, mas o mesmo não está listado no parâmetro IdentityId

  • 400 ManagedInstanceZoneRedudantFeatureNotSupported - O recurso ZoneRedundant não tem suporte para a camada de serviço selecionada. Para obter mais detalhes, visite aka.ms/sqlmi-service-tier-characteristics.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeEnabled - A habilitação do recurso zoneRedundant não é possível depois que a instância gerenciada é criada. Para obter mais detalhes, visite aka.ms/sqlmi-high-availability.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeDisabled – Não é possível desabilitar o recurso zoneRedundant depois que a instância gerenciada é criada. Para obter mais detalhes, visite aka.ms/sqlmi-high-availability.

  • 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido

  • 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido

  • 400 SubnetIdCantBeUpdated – não há suporte para a alteração da sub-rede da instância gerenciada. Remova esse parâmetro da solicitação.

  • 400 MigrationToAnotherVNetNotSupported - A sub-rede selecionada está em outro Rede Virtual. Não é possível mover a instância gerenciada para outra Rede Virtual. Forneça a sub-rede de Rede Virtual{0}.

  • 400 MigrationToSubnetWithDifferentDnsZoneNotSupported - A sub-rede fornecida está tendo zona DNS diferente da atual. Não há suporte para alterar a zona DNS da instância. Forneça a sub-rede com a mesma zona DNS, crie uma sub-rede ou forneça uma vazia.

  • 400 MigrationToGen4SubnetNotSupported – não é possível atualizar a sub-rede durante a execução no hardware Gen4, pois ela está sendo preterida. Atualize seu hardware de Gen4 para Gen5 como parte da operação de sub-rede de instância gerenciada em alteração especificando ambos os parâmetros ao mesmo tempo: sub-rede de destino e geração de hardware.

  • 400 PrimaryIdentityMissingPermissionForKeyId - KeyId é fornecido pelo usuário durante a criação, mas PrimaryUserAssignedIdentityId não é fornecido na chamada à API

  • 400 InvalidIdentityTypeForKeyId - KeyId é fornecido pelo usuário durante a criação, mas o tipo de identidade não está definido como 'UserAssigned'

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

  • 400 ManagedInstanceFileExceededMaxAzureStorageFileSizeLimit - A operação não pôde ser concluída porque alguns dos arquivos de banco de dados estão excedendo o limite máximo de tamanho de arquivo Uso Geral de {0} GB.

  • 400 ManagedInstanceStoppingOrStopped - Operação conflitante enviada enquanto a instância está em estado de parada/parada

  • 400 ManagedInstanceStarting – Operação conflitante enviada enquanto a instância está no estado inicial

  • 400 InstancePoolNotEnoughCapacity – um pool de instâncias não tem capacidade suficiente

  • 400 SourceAndTargetSubnetsMustBeVnetPeered – A sub-rede atualmente usada pela instância gerenciada e a sub-rede de destino fornecida fazem parte das redes virtuais que não estão conectadas ao emparelhamento de rede virtual ou têm o emparelhamento estabelecido, mas não têm tráfego permitido. Para mover a instância gerenciada de uma sub-rede para outra, o emparelhamento de rede virtual precisa ser estabelecido a partir da rede virtual de origem e de destino. Configure os requisitos de rede virtual e tente a operação novamente. Saiba mais https://docs.microsoft.com/en-us/azure/virtual-network/tutorial-connect-virtual-networks-portal#peer-virtual-networks.

  • 400 ManagedInstanceAndSubnetAreNotOnTheSameSubscription – A sub-rede fornecida para implantação de instância gerenciada está localizada na assinatura diferente daquela enviada para a instância gerenciada. A instância gerenciada e a sub-rede usadas para implantar a instância devem estar na mesma assinatura. Forneça outra sub-rede ou alterne para a assinatura de sub-rede e tente a operação novamente.

  • 400 CreateManagedInstanceInvalidSubnetSubnetSize – O usuário tentou criar uma instância gerenciada em uma sub-rede menor do que o tamanho mínimo permitido da sub-rede.

  • 400 AddressRangeOfTargetSubnetAndSubnetOfGeoDRReplicaCantOverlap – A sub-rede selecionada para migração de instância gerenciada tem um intervalo de endereços que se sobrepõe ao intervalo de endereços da sub-rede que contém a instância secundária replicada geograficamente. Verifique se sua sub-rede está configurada de acordo com as diretrizes em https://aka.ms/move-managed-instance.

  • 400 TargetSubnetMustBeConfiguredToAllowGeoDRReplication – A sub-rede selecionada para migração de instância gerenciada não está configurada para habilitar a comunicação com uma instância secundária replicada geograficamente. Verifique se todas as portas necessárias estão abertas. Para configurar corretamente sua sub-rede, leia as diretrizes em https://aka.ms/move-managed-instance.

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

  • 400 InvalidLoginName – O nome de logon fornecido é inválido.

  • 400 InvalidUsername – O nome de usuário fornecido contém caracteres inválidos.

  • 400 PasswordTooShort - A senha fornecida é muito curta

  • 400 PasswordTooLong – A senha fornecida é muito longa.

  • 400 PasswordNotComplex – a senha fornecida não é complexa o suficiente.

  • 400 GatewayInvalidEdition – '{0}' não é uma edição de banco de dados válida nesta versão do SQL Server.

  • 400 InvalidLocation – Um local inválido foi especificado.

  • 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro.

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

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

  • 404 ResourceDoesNotExist – Recurso com o nome '{0}' não existe. Para continuar, especifique um nome de recurso válido.

  • 404 InstancePoolNotFound – Não é possível encontrar um pool de instâncias

  • 404 SubscriptionNotFound – A assinatura solicitada não foi encontrada.

  • 405 InvalidVcoreValue – o valor {0} do vCore não é válido. Especifique um valor vCore válido.

  • 405 InvalidHardwareGenerationValue – HardwareGeneration {0} não é válido. Especifique um valor válido de HardwareGeneration.

  • 405 InvalidStorageSizeValue - "Tamanho de armazenamento inválido: {0} GB. O tamanho do armazenamento deve ser especificado entre {1} gigabytes e {2} gigabytes, em incrementos de {3} GB.

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

  • 409 Assinatura Desabilitada – A assinatura está desabilitada.

  • 409 ServerOverridePreconditionFailed - Falha ao aplicar a substituição de servidor na categoria '{0}', porque o banco de dados físico ou a instância '{1}' no servidor '{2}' atualmente não está no estado 'Pronto' ou 'Desativado'.

  • 409 ManagedInstanceIsBusy – O servidor '{0}' está ocupado no momento. Aguarde alguns minutos antes de tentar novamente.

  • 409 ServerAlreadyExists – nome do servidor duplicado.

  • 409 ServerDisabled – O servidor está desabilitado.

  • 409 ServerQuotaExceeded - O servidor não pode ser adicionado a uma assinatura porque excederá a cota.

  • 429 ConflictingSubscriptionOperation – Uma operação está em andamento para a assinatura.

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além do máximo de solicitações 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 GatewayInternalServerError – O servidor encontrou uma exceção inesperada.

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

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

Exemplos

Lists all distributed availability groups in instance.

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups?api-version=2021-11-01

Sample Response

{
  "value": [
    {
      "properties": {
        "targetDatabase": "testdb",
        "sourceEndpoint": "TCP://SERVER:7022",
        "replicationMode": "Async",
        "distributedAvailabilityGroupId": "6bc05a51-aa36-a196-09bd-481d7a0973c0",
        "sourceReplicaId": "543dd519-7585-faff-6ad2-11fb826d4f4d",
        "targetReplicaId": "7e218aba-0a53-6231-be09-895d99f96bf2",
        "linkState": "Catchup",
        "lastHardenedLsn": "39000000030400001"
      },
      "id": "/subscriptions/f2669dff-5f08-45dd-b857-b2a60b72cdc9/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
      "name": "dag",
      "type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups"
    },
    {
      "properties": {
        "targetDatabase": "testdb2",
        "sourceEndpoint": "TCP://SERVER:7022",
        "replicationMode": "Async",
        "distributedAvailabilityGroupId": "7ec05a51-aa36-a196-09bd-481d7a0973c0",
        "sourceReplicaId": "d423d519-7585-faff-6ad2-11fb826d4f4d",
        "targetReplicaId": "32578aba-0a53-6231-be09-895d99f96bf2",
        "linkState": "Catchup",
        "lastHardenedLsn": "39000000030400001"
      },
      "id": "/subscriptions/f2669dff-5f08-45dd-b857-b2a60b72cdc9/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag2",
      "name": "dag2",
      "type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups"
    }
  ]
}

Definições

DistributedAvailabilityGroup

Grupo de disponibilidade distribuído entre a caixa e o sql Instância Gerenciada.

DistributedAvailabilityGroupsListResult

Uma lista de grupos de disponibilidade distribuídos na instância.

ReplicationMode

O modo de replicação de um grupo de disponibilidade distribuído. O parâmetro será ignorado durante a criação do link.

DistributedAvailabilityGroup

Grupo de disponibilidade distribuído entre a caixa e o sql Instância Gerenciada.

Name Type Description
id
  • string

ID do recurso.

name
  • string

Nome do recurso.

properties.distributedAvailabilityGroupId
  • string

A ID do grupo de disponibilidade distribuída

properties.lastHardenedLsn
  • string

O último lsn protegido

properties.linkState
  • string

O estado do link

properties.primaryAvailabilityGroupName
  • string

O nome do grupo de disponibilidade primário

properties.replicationMode

O modo de replicação de um grupo de disponibilidade distribuído. O parâmetro será ignorado durante a criação do link.

properties.secondaryAvailabilityGroupName
  • string

O nome do grupo de disponibilidade secundário

properties.sourceEndpoint
  • string

O ponto de extremidade de origem

properties.sourceReplicaId
  • string

A ID da réplica de origem

properties.targetDatabase
  • string

O nome do banco de dados de destino

properties.targetReplicaId
  • string

A ID da réplica de destino

type
  • string

Tipo de recurso.

DistributedAvailabilityGroupsListResult

Uma lista de grupos de disponibilidade distribuídos na instância.

Name Type Description
nextLink
  • string

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

value

Matriz de resultados.

ReplicationMode

O modo de replicação de um grupo de disponibilidade distribuído. O parâmetro será ignorado durante a criação do link.

Name Type Description
Async
  • string
Sync
  • string