Partilhar via


Distributed Availability Groups - Get

Obtém informações de um grupo de disponibilidade distribuído.

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

Parâmetros do URI

Name Em Necessário Tipo Description
distributedAvailabilityGroupName
path True

string

O nome do grupo de disponibilidade distribuída.

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 da API do Azure Resource Manager ou 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 Tipo Description
200 OK

DistributedAvailabilityGroup

Recuperado com êxito o grupo de disponibilidade distribuída.

Other Status Codes

Respostas de erro: ***

  • 400 NameAlreadyExists - O nome fornecido já existe.

  • 400 InvalidCollation - Agrupamento inválido.

  • 400 ProvisioningDisabled - Exibe a mensagem de erro do autorizador da operação de recursos no estado em que se encontra, sem alterações

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

  • 400 UnableToResolveRemoteServer - O nome do servidor de 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 da camada de preços, pois tem objetos otimizados para memória. Por favor, solte esses objetos e tente novamente.

  • 400 TokenTooLong - O token fornecido é muito longo.

  • 400 CloudLifterUnsupportedFeature - A funcionalidade não está disponível na instância gerenciada no momento.

  • 400 ManagedInstanceSloUpdateFailed - SLO '{0}' operação 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 através do link Instância Gerenciada. Aguarde até que a criação do link seja concluída ou exclua o link e tente novamente a operação.

  • 400 ManagedInstanceLocalStorageUpdateSloDisabled - O SLO de atualização para instâncias gerenciadas com armazenamento local ainda não é suportado.

  • 400 InvalidSubnetResourceId - O ID do recurso de sub-rede fornecido para a instância gerenciada criar ou atualizar é inválido.

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

  • 400 AlterDbDeactivatedNotSupported - Falha na operação do banco de dados para o servidor '{0}', banco de dados '{1}' devido a um atraso inesperado. Por favor, 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 é suportada.

  • 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 - A instância gerenciada não pode ser unida a 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 Rotas Definida pelo Usuário padrão.

  • 400 VnetConfigHasInvalidUdr - O usuário tentou injetar a sub-rede do Servidor Gerenciado com uma Tabela de Rotas 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 IntendedPolicy.

  • 400 ManagedInstanceInvalidEditionForSku - O {0} de edição especificado não é consistente com o {1}de SKU especificado.

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

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

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

  • 400 InstanceCollationUpdateNotSupported - O usuário não pode alterar o agrupamento de instâncias na instância gerenciada.

  • 400 CreateManagedInstanceWithNonDefaultCollationNotSupported - O usuário pode criar uma instância gerenciada somente com agrupamento 'SQL_Latin1_General_CP1_CI_AS'.

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

  • 400 ManagedInstanceExceedMaxAzureStorage - A operação não pôde ser concluída porque o tamanho total de armazenamento alocado para a instância de uso geral excederia {0}. Reduza o número de arquivos de banco de dados e tente novamente a operaçã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 uma instância gerenciada como uma replicação geográfica secundária ao {0} de sub-rede no qual já existe uma instância gerenciada. A implantação da instância gerenciada como secundária de replicação geográfica é suportada somente nos casos em que a instância gerenciada é a primeira instância implantada em uma sub-rede. Considere implantar a instância gerenciada como uma replicação geográfica secundária a uma sub-rede diferente na qual não há instâncias gerenciadas existentes ou se a implantação em uma sub-rede com 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 mais elevado.

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

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

  • 400 CreateManagedInstanceWithNonDefaultTimezoneNotSupported - Criar instância gerenciada com fuso horário não padrão não suportado.

  • 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 que é delegada.

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

  • 400 UpdateManagedServerWithMaintenanceWindowNotAllowed - A atualização da instância gerenciada com as configurações da janela de manutenção não é permitida.

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

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

  • 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 - Esta instância gerenciada não pode ser implantada porque sua zona DNS não corresponde ao prefixo DNS de seu cluster virtual pretendido para {0}de sub-rede. Embora esse cluster virtual esteja vazio, seu prefixo DNS não pode ser alterado. Os clusters virtuais vazios serão removidos automaticamente após várias horas. Considere aguardar a expiração desse cluster virtual ou excluir manualmente esse cluster virtual e, em seguida, criar a instância gerenciada.

  • 400 MissingIdentityId - Nenhuma identidade atribuída ao 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 é suportado para a camada de serviço selecionada. Para mais detalhes, visite aka.ms/sqlmi-service-tier-characteristics.

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

  • 400 ManagedInstanceZoneRedudantFeatureCantBeDisabled - A desativação do recurso zoneRedundant não é possível após a criação da instância gerenciada. Para 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 este parâmetro da solicitação.

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

  • 400 MigrationToSubnetWithDifferentDnsZoneNotSupported - Desde que a sub-rede tenha uma zona DNS diferente da atual. Não há suporte para alterar a zona DNS da instância. Forneça uma sub-rede com a mesma zona DNS, crie uma nova 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 mudança, 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 da 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 de uso geral de {0} GB.

  • 400 ManagedInstanceStoppingOrStopped - Operação conflitante enviada enquanto a instância está no 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 pela sub-rede de destino fornecida faz parte das redes virtuais que não estão conectadas ao emparelhamento de rede virtual ou têm 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 em uma assinatura diferente da 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 mude para a subscrição de sub-rede e, em seguida, tente a operação novamente.

  • 400 CreateManagedInstanceInvalidSubnetSize - 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 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 a sua sub-rede está configurada de acordo com as diretrizes do https://aka.ms/move-managed-instance.

  • 400 TargetSubnetMustBeConfiguredToAllowGeoDRReplication - A sub-rede selecionada para migração de instância gerenciada não está configurada para permitir 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 login 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 - Foi especificado um local inválido.

  • 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 - vCore value {0} não é válido. Especifique um valor vCore válido.

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

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

  • 409 ConflictingServerOperation - Uma operação está atualmente em andamento para o servidor.

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

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

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

  • 409 ServerAlreadyExists - Nome do servidor duplicado.

  • 409 ServerDisabled - O servidor está desativado.

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

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

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 500 GatewayInternalServerError - O servidor encontrou uma exceção inesperada.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

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

Exemplos

Gets the distributed availability group info.

Pedido de amostra

GET https://management.azure.com/subscriptions/f2669dff-5f08-45dd-b857-b2a60b72cdc9/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag?api-version=2021-11-01

Resposta da amostra

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

Definições

Name Description
DistributedAvailabilityGroup

Grupo de disponibilidade distribuída entre box e Sql Managed Instance.

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ída entre box e Sql Managed Instance.

Name Tipo Description
id

string

ID do recurso.

name

string

Nome do recurso.

properties.distributedAvailabilityGroupId

string (uuid)

O ID do grupo de disponibilidade distribuída

properties.lastHardenedLsn

string

O último lsn endurecido

properties.linkState

string

O estado do link

properties.primaryAvailabilityGroupName

string

O nome do grupo de disponibilidade principal

properties.replicationMode

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 (uuid)

O ID da réplica de origem

properties.targetDatabase

string

O nome do banco de dados de destino

properties.targetReplicaId

string (uuid)

O ID da réplica de destino

type

string

Tipo de recurso.

ReplicationMode

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

Valor Description
Async
Sync