Availability Group Listeners - Create Or Update

Cria ou atualiza um ouvinte de grupo de disponibilidade.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/{sqlVirtualMachineGroupName}/availabilityGroupListeners/{availabilityGroupListenerName}?api-version=2021-11-01-preview

Parâmetros do URI

Name In Required Type Description
availabilityGroupListenerName
path True
  • string

Nome do ouvinte do grupo de disponibilidade.

resourceGroupName
path True
  • string

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

sqlVirtualMachineGroupName
path True
  • string

Nome do grupo de máquinas virtuais SQL.

subscriptionId
path True
  • string

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

api-version
query True
  • string

Versão API para usar para o pedido.

Corpo do Pedido

Name Type Description
properties.availabilityGroupConfiguration

Configuração do Grupo disponibilidade.

properties.availabilityGroupName
  • string

Nome do grupo de disponibilidade.

properties.createDefaultAvailabilityGroupIfNotExist
  • boolean

Crie um grupo de disponibilidade padrão se não existir.

properties.loadBalancerConfigurations

Lista de configurações do balanceador de carga para um ouvinte de grupo de disponibilidade.

properties.port
  • integer

Porta de escuta.

Respostas

Name Type Description
200 OK

Atualizou com sucesso o ouvinte do grupo de disponibilidade.

201 Created

Criou com sucesso o ouvinte do grupo de disponibilidade.

Other Status Codes

Respostas de erro: ***

  • 400 InvalidParameterValue - Foi dado um valor inválido ao parâmetro.

  • 400 RPGenericUser - Falha do utilizador ao ligar para outro Fornecedor de Recursos.

  • 400 RPResponseMissingAsyncOperationHeader - Falta informações do cabeçalho da operação Async

  • 400 InvalidArgument - Argumento inválido '{0}'.

  • 400 ArgumentNotInRange - Argumento '{0}' não está ao alcance.

  • 400 RecursosNotProvisioned - Como recurso: {0} não está num estado provisionado, o pedido não pode ser prosseguido

  • 400 CRPNotAllowedOperation - A operação não pode ser concluída devido ao seguinte erro: {0}

  • 400 AadAppDisabled - App Microsoft AAD SQLVMResourceProviderAuth ({0}) está desativada no seu inquilino.

  • 400 InvalidRgResourceId - Id de recursos inválidos especificado.

  • 400 InternalAPIAccessDenied - Acesso interno da API negado. O Id de {0} aplicações não é válido para usar esta API.

  • 400 AgDoesNotExist - Grupo de disponibilidade não existe.

  • 400 AgListDoesNotMatch - SQL lista de grupos de disponibilidade não corresponde à lista de máquinas virtuais no grupo de máquinas virtual SQL.

  • 400 NoIpProvided - Pelo menos um IP precisa de ser fornecido.

  • 400 MaisIpProvided - Apenas um IP precisa de ser fornecido.

  • 400 SqlVmGroupDoesNotHaveAGListener - SQL grupo de máquinas virtuais não tem o ouvinte AG.

  • 400 AgListenerUpdateNotAllowed - Apenas algumas propriedades do ouvinte do grupo de disponibilidade podem ser atualizadas.

  • 400 SqlVmNotInGroup - SQL máquina virtual não faz parte do grupo.

  • 400 SqlVmListCannotBeEmpty - SQL lista de máquinas virtuais não pode estar vazia.

  • 400 PublicIpNotIPv4 - IP público deve ser endereço IPv4.

  • 400 PublicIPDynamicAllocation - Modo de atribuição de IP público deve ser estático

  • 400 PublicLBInvalid - Balanceador de carga especificado não é público.

  • 400 SubnetMissingFromPrivateIP - Subnet deve ser fornecido com IP privado.

  • 400 IPNotInSubnet - IP não faz parte da sub-rede.

  • 400 NoActivePrimaryInAG - Nenhum dos nós no AvailabilityGroup são primários

  • 400 MultipleListenerSameAG - Não são permitidos ouvintes de grupo de disponibilidade múltipla para o mesmo grupo de disponibilidade.

  • 400 AgListenerNotEmpty - Ouvinte do grupo de disponibilidade não está vazio.

  • 400 AgListenerVnetMismatch - Desde que o VNet para o ouvinte do grupo Availability não corresponda ao Vnet do equilibrador interno de carga.

  • 400 InternalLBInvalid - Balanceador de carga especificado não é interno.

  • 400 InvalidSqlVmResourceIdemeterValue - SQL id de recurso de máquina virtual fornecido é inválido.

  • 400 DifferentSubSqlVmList - Todas as máquinas virtuais SQL devem estar na mesma subscrição.

  • 400 OnlyStandardPublicIp - Todas as máquinas virtuais devem ter IP público padrão.

  • 400 ListenerNameTooLong - O nome do ouvinte não deve exceder 15 caracteres.

  • 400 InvalidListenerName - Nome de ouvinte inválido.

  • 400 InvalidLBResourceIdParameterValue - Id de recursos do balanceador de carga é inválido.

  • 400 InvalidPublicIpResourceIdemeterValue - Id de recursos IP públicos é inválido.

  • 400 InvalidSubnetIdParameterValue - Id de recursos inválidos previsto para o parâmetro da sub-rede.

  • 400 InvalidPrivateIpParameterValue - Endereço inválido dado para endereço IP privado.

  • 400 ExtVersionNotSupported - A máquina virtual: {0} está a executar a versão mais antiga da SqlIaasExtension que não é suportada por esta operação. Por favor, atualize a extensão e revendo a operação.

  • 400 InvalidReplicaRole - Função de réplica inválida: {0} especificada para SQL VM: {1}.

  • 400 InvalidReplicaFailover - Réplica inválida Failover: {0} para SQL VM: {1}.

  • 400 InvalidReplicaReadableSecondary - Réplica inválida legível secundária: {0} para SQL VM: {1}.

  • 400 InvalidReplicaCommit - Modo de compromisso de réplica inválida: {0} para SQL VM: {1}.

  • 400 ExpectSynchronousCommitForAutomaticFailover - Modo de compromisso de réplica inválida: {0} para SQL VM: {1}. {2} é esperado para o modo de failover: {3}.

  • 400 NoPrimaryInAg - Não existem réplicas com papel primário. Deve haver exatamente uma réplica com o papel de primária.

  • 400 MoreThanOnePrimaryInAg - Existem mais de uma réplica com papel primário. Deve haver exatamente uma réplica com o papel de primária.

  • 400 MoreThanThreeSynchronousCommitInAg - Existem mais de três réplicas com modo de compromisso como: {0}. Deve haver no máximo três réplicas com modo de compromisso como: {0}

  • 400 MoreThanEightSecondariesInAg - Existem mais de oito réplicas secundárias com papel secundário. Deve haver no máximo oito réplicas com papel secundário.

  • 400 AlwaysOnNotEnabled - A funcionalidade "Sempre em funcionalidade" não está ativada na máquina Virtual: {0}.

  • 400 ExpectedReplicaNotPrimary - O VM: {0} não acolhe a réplica primária.

  • 400 LoadBalancerSqlvmsMismatchWithReplicaSqlvms - Lista de VMs SQL especificados no grupo Availability não corresponde à lista de VMs SQL na configuração do balançador de carga.

  • 400 ReplicaSqlvmHasDuplicates - A configuração da réplica deve ser única para cada SQL máquina virtual. Encontramos uma ou mais configurações para o mesmo recurso SQL máquina virtual.

  • 400 ReplicaDeleteNotAllowed - Eliminação de réplicas através de SQL VM RP ainda não está suportado.

  • 400 OnlyBasicPublicIP - Todos os VM especificados devem conter apenas IP público básico, ao fornecer Loadbalancer Basic Sku.

  • 400 NICCannotUseMultipleLBsOfSameType - NIC: {0} não pode fazer referência a mais de um equilibrador de carga de tipo INTERNO ou PÚBLICO

  • 400 AGReplicaSQLStartupAccount - Conta de serviço NT não pode ser usada como SQL conta de arranque para configuração AG. Deve usar uma conta de domínio.

  • 400 AgListenerMultiSubnetUpdateNotAllowed - Não é permitida a atualização do ouvinte AG multi-rede.

  • 400 ListenerIpSubnetVmSubnetMismatch - Sub-rede ip do ouvinte estática e sub-rede VM devem ser as mesmas

  • 400 VmNicVnetMismatch - Incompatibilidade da máquina virtual NIC VNet.

  • 400 NoAvailabilitySet - Vm não está associado a qualquer conjunto de disponibilidade.

  • 400 AvailabilitySetMismatch - O conjunto de disponibilidade de máquinas virtuais não corresponde.

  • 400 MismatchVmGroupSubscription - O id de subscrição para SQL máquina virtual e SQL grupo de máquinas virtuais são diferentes.

  • 400 VmNotRunning - O VM não está em funcionamento.

  • 400 VmAgentNotRunning - O agente VM não está instalado ou em funcionamento.

  • 400 NoIp Disponível - Sem IP disponível.

  • 403 AccessDenied - Acesso negado.

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

  • 404 SubscriçãoDoesNotExist - Id de assinatura não existe.

  • 404 RecursosDoesNotExist - Recurso não existe.

  • 404 RPOperationNotFound - Operação não encontrada

  • 404 OperaçãoIdNotFound - Id de operação não foi encontrado.

  • 404 OperaçãoTypeNotFound - Tipo de operação não encontrado.

  • 404 SubscriçãoDoesNotHaveSqlVMGroupInResourceGroup - A subscrição não tem SQL grupo de máquinas virtuais no grupo de recursos.

  • 409 RecursosAlreadyExists - Recursos já existem.

  • 409 LBGenericErrors - Operação LB falhou

  • 409 NICGenericError - Operação NIC falhou

  • 409 SqlExtensionNotInstalled - SQL extensão não instalada.

  • 409 RPPluginSubstatusMissing - Substato plugin RP desaparecido

  • 409 MissingMoveResources - Não é possível mover recursos porque alguns recursos estão em falta no pedido.

  • 409 ResourcesExists - Houve um erro interno na limpeza dos recursos.

  • 409 SubscriçãoOperaçãoInProgress - Uma operação de subscrição já está em andamento

  • 409 OperaçãoInProgress - Operação em curso em recursos já.

  • 409 OperaçãoCanceled - Operação Cancelada.

  • 409 ReplicasWithDifferentSqlStartupAccounts - Certifique-se de que todas as contas de arranque do servidor SQL nas réplicas especificadas são as mesmas. Este é um dos nossos pré-requisitos para a criação de grupos de disponibilidade.

  • 409 ReplicasJoinedToMoreThanOneCluster - Réplicas AG juntam-se a mais de um cluster de failover. Por favor, certifique-se de que todas as suas réplicas estão unidas ao mesmo aglomerado de falhas.

  • 409 IPNot Disponível - IP {0} não está disponível{1}. Considere usar um de ({2})

  • 409 IpAddressAlreadyReserved - Endereço IP reservado para este ouvinte já existe. Por favor, use o endereço IP

  • 429 TooManyRequestsReceived -

  • 500 RPGenericSystem - Falha no sistema ao ligar para outro Fornecedor de Recursos.

  • 500 UnExpectedErrorOccurred - Ocorreu um erro inesperado.

  • 500 OperationTimeout - Operação cronometrada.

  • 500 SqlVmGroupIsBusy - SQL grupo de máquinas virtuais está ocupado.

Exemplos

Creates or updates an availability group listener.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup/availabilityGroupListeners/agl-test?api-version=2021-11-01-preview

{
  "properties": {
    "availabilityGroupName": "ag-test",
    "loadBalancerConfigurations": [
      {
        "privateIpAddress": {
          "ipAddress": "10.1.0.112",
          "subnetResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
        },
        "loadBalancerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/loadBalancers/lb-test",
        "probePort": 59983,
        "sqlVirtualMachineInstances": [
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm2",
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm3"
        ]
      }
    ],
    "port": 1433
  }
}

Sample Response

{
  "properties": {
    "provisioningState": "Updating",
    "loadBalancerConfigurations": [
      {
        "privateIpAddress": {
          "ipAddress": "10.1.0.113",
          "subnetResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
        },
        "sqlVirtualMachineInstances": [
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm2",
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm3"
        ]
      }
    ],
    "port": 1433
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup/availabilityGroupListeners/agl-test",
  "name": "agl-test",
  "type": "Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/availabilityGroupListeners"
}
{
  "properties": {
    "provisioningState": "Provisioning",
    "loadBalancerConfigurations": [
      {
        "privateIpAddress": {
          "ipAddress": "10.1.0.112",
          "subnetResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
        },
        "sqlVirtualMachineInstances": [
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm2",
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm3"
        ]
      }
    ],
    "port": 1433
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup/availabilityGroupListeners/agl-test",
  "name": "agl-test",
  "type": "Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/availabilityGroupListeners"
}

Definições

AgConfiguration

Configuração do grupo de disponibilidade.

AgReplica

Configuração de réplica de grupo de disponibilidade.

AvailabilityGroupListener

Um ouvinte de grupo de disponibilidade SQL Server.

Commit

Replica o modo de compromisso no grupo de disponibilidade.

createdByType

O tipo de identidade que criou o recurso.

Failover

Replica modo de failover no grupo de disponibilidade.

LoadBalancerConfiguration

Uma configuração do balanceador de carga para um ouvinte de grupo de disponibilidade.

PrivateIPAddress

Um endereço IP privado ligado ao ouvinte do grupo de disponibilidade.

ReadableSecondary

Replica o modo secundário legível no grupo de disponibilidade.

Role

Réplica Papel no grupo de disponibilidade.

systemData

Metadados relativos à criação e última modificação do recurso.

AgConfiguration

Configuração do grupo de disponibilidade.

Name Type Description
replicas

Configurações de réplica.

AgReplica

Configuração de réplica de grupo de disponibilidade.

Name Type Description
commit

Replica o modo de compromisso no grupo de disponibilidade.

failover

Replica modo de failover no grupo de disponibilidade.

readableSecondary

Replica o modo secundário legível no grupo de disponibilidade.

role

Réplica Papel no grupo de disponibilidade.

sqlVirtualMachineInstanceId
  • string

Sql VirtualMachine Instance Id.

AvailabilityGroupListener

Um ouvinte de grupo de disponibilidade SQL Server.

Name Type Description
id
  • string

Identificação de recursos.

name
  • string

Nome de recurso.

properties.availabilityGroupConfiguration

Configuração do Grupo disponibilidade.

properties.availabilityGroupName
  • string

Nome do grupo de disponibilidade.

properties.createDefaultAvailabilityGroupIfNotExist
  • boolean

Crie um grupo de disponibilidade padrão se não existir.

properties.loadBalancerConfigurations

Lista de configurações do balanceador de carga para um ouvinte de grupo de disponibilidade.

properties.port
  • integer

Porta de escuta.

properties.provisioningState
  • string

Estado de provisionamento para acompanhar o estado de funcionamento da async.

systemData

Metadados relativos à criação e última modificação do recurso.

type
  • string

Tipo de recurso.

Commit

Replica o modo de compromisso no grupo de disponibilidade.

Name Type Description
ASYNCHRONOUS_COMMIT
  • string
SYNCHRONOUS_COMMIT
  • string

createdByType

O tipo de identidade que criou o recurso.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

Failover

Replica modo de failover no grupo de disponibilidade.

Name Type Description
AUTOMATIC
  • string
MANUAL
  • string

LoadBalancerConfiguration

Uma configuração do balanceador de carga para um ouvinte de grupo de disponibilidade.

Name Type Description
loadBalancerResourceId
  • string

Identificação de recursos do equilibrador de carga.

privateIpAddress

Endereço IP privado.

probePort
  • integer

Porta de sonda.

publicIpAddressResourceId
  • string

Identificação de recursos do IP público.

sqlVirtualMachineInstances
  • string[]

A lista dos SQL id de identificação de casos de máquinas virtuais que estão inscritos no ouvinte do grupo de disponibilidade.

PrivateIPAddress

Um endereço IP privado ligado ao ouvinte do grupo de disponibilidade.

Name Type Description
ipAddress
  • string

Endereço IP privado ligado ao ouvinte do grupo de disponibilidade.

subnetResourceId
  • string

Sub-rede usado para incluir IP privado.

ReadableSecondary

Replica o modo secundário legível no grupo de disponibilidade.

Name Type Description
ALL
  • string
NO
  • string
READ_ONLY
  • string

Role

Réplica Papel no grupo de disponibilidade.

Name Type Description
PRIMARY
  • string
SECONDARY
  • string

systemData

Metadados relativos à criação e última modificação do recurso.

Name Type Description
createdAt
  • string

O calendário da criação de recursos (UTC).

createdBy
  • string

A identidade que criou o recurso.

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt
  • string

O tempotampesso da última modificação de recursos (UTC)

lastModifiedBy
  • string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

O tipo de identidade que modificou o recurso pela última vez.