Availability Group Listeners - Create Or Update

Vytvoří nebo aktualizuje naslouchací proces skupiny dostupnosti.

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

Parametry identifikátoru URI

Name In Required Type Description
availabilityGroupListenerName
path True
  • string

Název naslouchacího procesu skupiny dostupnosti

resourceGroupName
path True
  • string

Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo portálu.

sqlVirtualMachineGroupName
path True
  • string

Název skupiny virtuálních počítačů SQL.

subscriptionId
path True
  • string

ID předplatného, které identifikuje předplatné Azure.

api-version
query True
  • string

Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name Type Description
properties.availabilityGroupConfiguration

Konfigurace skupiny dostupnosti

properties.availabilityGroupName
  • string

Název skupiny dostupnosti

properties.createDefaultAvailabilityGroupIfNotExist
  • boolean

Vytvořte výchozí skupinu dostupnosti, pokud neexistuje.

properties.loadBalancerConfigurations

Seznam konfigurací nástroje pro vyrovnávání zatížení pro naslouchací proces skupiny dostupnosti

properties.port
  • integer

Port naslouchacího procesu.

Odpovědi

Name Type Description
200 OK

Naslouchací proces skupiny dostupnosti byl úspěšně aktualizován.

201 Created

Naslouchací proces skupiny dostupnosti byl úspěšně vytvořen.

Other Status Codes

Chybové odpovědi: ***

  • 400 InvalidParameterValue – parametr dostal neplatnou hodnotu.

  • 400 RPGenericUser – Chyba uživatele při volání jiného poskytovatele prostředků

  • 400 RPResponseMissingAsyncOperationHeader – V odpovědi chybí informace hlavičky asynchronní operace.

  • 400 InvalidArgument – neplatný argument '{0}'.

  • 400 ArgumentNotInRange – argument '{0}' není v rozsahu.

  • 400 ResourceNotProvisioned – protože prostředek {0} není ve zřízeném stavu, požadavek nelze pokračovat vpřed.

  • 400 CRPNotAllowedOperation – Operaci nelze dokončit kvůli následující chybě: {0}

  • 400 AadAppDisabled – Aplikace Microsoft AAD SQLVMResourceProviderAuth ({0}) je ve vašem tenantovi zakázaná.

  • 400 InvalidRgResourceId – Zadané ID prostředku skupiny prostředků je neplatné.

  • 400 InternalAPIAccessDenied – Interní přístup rozhraní API byl odepřen. ID {0} aplikace není platné pro použití tohoto rozhraní API.

  • 400 AgDoesNotExist – Skupina dostupnosti neexistuje.

  • 400 AgListDoesNotMatch – SQL seznam skupin dostupnosti neodpovídá seznamu virtuálních počítačů ve skupině virtuálních počítačů SQL.

  • 400 NoIpProvided – Musí být zadána alespoň jedna IP adresa.

  • 400 MoreIpProvided – je potřeba poskytnout pouze jednu IP adresu.

  • 400 SqlVmGroupDoesNotHaveAGListener – SQL skupina virtuálních počítačů nemá naslouchací proces skupiny dostupnosti.

  • 400 AgListenerUpdateNotAllowed – aktualizovat lze pouze několik vlastností naslouchacího procesu skupiny dostupnosti.

  • 400 SqlVmNotInGroup – SQL virtuální počítač není součástí skupiny.

  • 400 SqlVmListCannotBeEmpty – seznam SQL virtuálních počítačů nemůže být prázdný.

  • 400 PublicIpNotIPv4 – Veřejná IP adresa musí být adresa IPv4.

  • 400 PublicIPDynamicAllocation – Režim přidělování veřejných IP adres musí být statický

  • 400 PublicLBInvalid – Zadaný nástroj pro vyrovnávání zatížení není veřejný.

  • 400 SubnetMissingFromPrivateIP – Podsíť musí být poskytována s privátní IP adresou.

  • 400 IPNotInSubnet – IP adresa není součástí podsítě.

  • 400 NoActivePrimaryInAG – Žádný z uzlů ve skupině dostupnosti není primární

  • 400 MultipleListenerSameAG – Více naslouchacích procesů skupiny dostupnosti pro stejnou skupinu dostupnosti není povoleno.

  • 400 AgListenerNotEmpty – naslouchací proces skupiny dostupnosti není prázdný.

  • 400 AgListenerVnetMismatch – Zadaná virtuální síť pro naslouchací proces skupiny dostupnosti neodpovídá virtuální síti interního nástroje pro vyrovnávání zatížení.

  • 400 InternalLBInvalid – Zadaný nástroj pro vyrovnávání zatížení není interní.

  • 400 InvalidSqlVmResourceIdParameterValue – SQL zadané ID prostředku virtuálního počítače je neplatné.

  • 400 DifferentSubSqlVmList – Všechny virtuální počítače SQL by měly být ve stejném předplatném.

  • 400 OnlyStandardPublicIp – Každý virtuální počítač by měl mít standardní veřejnou IP adresu.

  • 400 ListenerNameTooLong – název naslouchacího procesu by neměl překročit 15 znaků.

  • 400 InvalidListenerName – neplatný název naslouchacího procesu.

  • 400 InvalidLBResourceIdParameterValue – ID prostředku nástroje pro vyrovnávání zatížení je neplatné.

  • 400 InvalidPublicIpResourceIdParameterValue – ID prostředku veřejné IP adresy je neplatné.

  • 400 InvalidSubnetIdParameterValue – Neplatné ID prostředku zadané pro parametr podsítě.

  • 400 InvalidPrivateIpParameterValue – Neplatná adresa zadaná pro privátní IP adresu.

  • 400 ExtVersionNotSupported – virtuální počítač: {0} používá starší verzi sqlIaasExtension, kterou tato operace nepodporuje. Aktualizujte rozšíření a zkuste operaci zopakovat.

  • 400 InvalidReplicaRole – Neplatná role repliky: {0} zadaná pro SQL virtuální počítač: {1}.

  • 400 InvalidReplicaFailover – Neplatné převzetí služeb při selhání repliky: {0} pro SQL virtuální počítač: {1}.

  • 400 InvalidReplicaReadableSecondary – neplatná sekundární replika čitelná: {0} pro SQL virtuální počítač: {1}.

  • 400 InvalidReplicaCommit - Neplatný režim potvrzení repliky: {0} pro SQL virtuální počítač: {1}.

  • 400 ExpectedSynchronousCommitForAutomaticFailover – Neplatný režim potvrzení repliky: {0} pro SQL virtuální počítač: {1}. {2} očekává se pro režim převzetí služeb při selhání: {3}.

  • 400 NoPrimaryInAg – Primární role neobsahuje žádné repliky. Měla by existovat přesně jedna replika s rolí jako primární.

  • 400 MoreThanOnePrimaryInAg - Existuje více než jedna replika s primární rolí. Měla by existovat přesně jedna replika s rolí jako primární.

  • 400 MoreThanThreeSynchronousCommitInAg - Existuje více než tři repliky s režimem potvrzení jako: {0}. V režimu potvrzení by měl být maximálně tři repliky: {0}

  • 400 MoreThanEightSecondariesInAg - Existuje více než osm sekundární repliky s sekundární rolí. Měla by existovat maximálně osm replik s rolí jako sekundární.

  • 400 AlwaysOnNotEnabled – Funkce AlwaysOnon není na virtuálním počítači povolená: {0}.

  • 400 ExpectedReplicaNotPrimary – virtuální počítač: {0} není hostitelem primární repliky.

  • 400 LoadBalancerSqlvmsMismatchWithReplicaSqlvms – Seznam virtuálních počítačů SQL zadaných ve skupině dostupnosti neodpovídá seznamu virtuálních počítačů SQL v konfiguraci nástroje pro vyrovnávání zatížení.

  • 400 ReplicaSqlvmHasDuplicateEntries – Konfigurace repliky by měla být jedinečná pro každý SQL virtuální počítač. Zjistili jsme jednu nebo více konfigurací pro stejný SQL prostředek virtuálního počítače.

  • 400 ReplicaDeleteNotAllowed – Odstranění repliky prostřednictvím SQL RP virtuálního počítače se zatím nepodporuje.

  • 400 OnlyBasicPublicIP – Všechny zadané virtuální počítače by měly obsahovat pouze základní veřejnou IP adresu při poskytování skladové položky Loadbalancer Basic.

  • 400 NICCannotUseMultipleLBsOfSameType – nic: {0} nejde odkazovat na více než jeden nástroj pro vyrovnávání zatížení interního nebo veřejného typu.

  • 400 AGReplicaSQLStartupAccount – Účet služby NT nelze použít jako SQL spouštěcí účet pro nastavení skupiny dostupnosti. Měli byste použít účet domény.

  • 400 AgListenerMultiSubnetUpdateNotAllowed – Aktualizace naslouchacího procesu skupiny dostupnosti více podsítí není povolená.

  • 400 Naslouchací procesIpSubnetVmSubnetMismatch – podsíť statické IP adresy naslouchacího procesu a podsíť virtuálního počítače by měla být stejná.

  • 400 VmNicVnetMismatch – Neshoda virtuálních sítí síťových adaptérů virtuálního počítače

  • 400 NoAvailabilitySet – Virtuální počítač není přidružený k žádné skupině dostupnosti.

  • 400 AvailabilitySetMismatch – Skupina dostupnosti virtuálních počítačů neodpovídá.

  • 400 NeshodaVmGroupSubscription – ID předplatného pro SQL virtuální počítač a SQL skupinu virtuálních počítačů se liší.

  • 400 VmNotRunning – Virtuální počítač není ve spuštěném stavu.

  • 400 VmAgentNotRunning – Agent virtuálního počítače není nainstalovaný nebo ve spuštěném stavu.

  • 400 NoIpAvailable – žádná dostupná IP adresa.

  • 403 AccessDenied – Přístup byl odepřen.

  • 404 ResourceNotFound – Požadovaný prostředek nebyl nalezen.

  • 404 SubscriptionDoesNotExist – ID předplatného neexistuje.

  • 404 ResourceDoesNotExist – Prostředek neexistuje.

  • 404 RPOperationNotFound – Operace nebyla nalezena

  • 404 OperationIdNotFound – ID operace nebylo nalezeno.

  • 404 OperationTypeNotFound – Typ operace nebyl nalezen.

  • 404 SubscriptionDoesNotHaveSqlVMGroupInResourceGroup – Předplatné nemá ve skupině prostředků SQL skupinu virtuálních počítačů.

  • 409 ResourceAlreadyExists – Prostředek již existuje.

  • 409 LBGenericErrors – Operace nástroje pro vyrovnávání zatížení selhala

  • 409 NICGenericError – Operace síťové karty selhala

  • 409 SqlExtensionNotInstalled – SQL rozšíření není nainstalované.

  • 409 RPPluginSubstatusMissing – Chybějící dílčí statistiky modulu plug-in RP

  • 409 MissingMoveResources – Prostředky nelze přesunout, protože některé prostředky v požadavku chybí.

  • 409 ResourceExists – při čištění prostředků došlo k vnitřní chybě.

  • 409 SubscriptionOperationInProgress – už probíhá operace s předplatným.

  • 409 OperationInProgress – Operace probíhající u prostředku již.

  • 409 OperationCanceled – Operace byla zrušena.

  • 409 ReplicasWithDifferentSqlStartupAccounts – Ujistěte se, že všechny vaše spouštěcí účty SQL serveru v zadaných replikách jsou stejné. Toto je jedním z našich požadavků na nastavení skupin dostupnosti.

  • 409 ReplikyJoinedToMoreThanOneCluster – repliky skupiny dostupnosti jsou připojené k více než jednomu clusteru s podporou převzetí služeb při selhání. Ujistěte se, že jsou všechny repliky připojené ke stejnému clusteru s podporou převzetí služeb při selhání.

  • 409 IPNotAvailable – IP {0} adresa není dostupná{1}. Zvažte použití jednoho z ({2})

  • 409 IpAddressAlreadyReserved – IP adresa vyhrazená pro tento naslouchací proces již existuje. Použijte IP adresu.

  • 429 TooManyRequestsReceived -

  • 500 RPGenericSystem – Selhání systému při volání jiného poskytovatele prostředků

  • 500 UnExpectedErrorOccurred – Došlo k neočekávané chybě.

  • 500 OperationTimeout – Vypršel časový limit operace.

  • 500 SqlVmGroupIsBusy – SQL skupina virtuálních počítačů je zaneprázdněná.

Příklady

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

Definice

AgConfiguration

Konfigurace skupiny dostupnosti

AgReplica

Konfigurace repliky skupiny dostupnosti

AvailabilityGroupListener

Naslouchací proces skupiny dostupnosti SQL Server.

Commit

Režim potvrzení repliky ve skupině dostupnosti

createdByType

Typ identity, která prostředek vytvořila.

Failover

Režim převzetí služeb při selhání repliky ve skupině dostupnosti

LoadBalancerConfiguration

Konfigurace nástroje pro vyrovnávání zatížení pro naslouchací proces skupiny dostupnosti

PrivateIPAddress

Privátní IP adresa vázaná na naslouchací proces skupiny dostupnosti.

ReadableSecondary

Sekundární režim pro čtení repliky ve skupině dostupnosti

Role

Role repliky ve skupině dostupnosti

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

AgConfiguration

Konfigurace skupiny dostupnosti

Name Type Description
replicas

Konfigurace replik.

AgReplica

Konfigurace repliky skupiny dostupnosti

Name Type Description
commit

Režim potvrzení repliky ve skupině dostupnosti

failover

Režim převzetí služeb při selhání repliky ve skupině dostupnosti

readableSecondary

Sekundární režim pro čtení repliky ve skupině dostupnosti

role

Role repliky ve skupině dostupnosti

sqlVirtualMachineInstanceId
  • string

ID instance služby Sql VirtualMachine

AvailabilityGroupListener

Naslouchací proces skupiny dostupnosti SQL Server.

Name Type Description
id
  • string

ID prostředku.

name
  • string

Název prostředku.

properties.availabilityGroupConfiguration

Konfigurace skupiny dostupnosti

properties.availabilityGroupName
  • string

Název skupiny dostupnosti

properties.createDefaultAvailabilityGroupIfNotExist
  • boolean

Vytvořte výchozí skupinu dostupnosti, pokud neexistuje.

properties.loadBalancerConfigurations

Seznam konfigurací nástroje pro vyrovnávání zatížení pro naslouchací proces skupiny dostupnosti

properties.port
  • integer

Port naslouchacího procesu.

properties.provisioningState
  • string

Stav zřizování pro sledování stavu asynchronní operace

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

type
  • string

Typ prostředku.

Commit

Režim potvrzení repliky ve skupině dostupnosti

Name Type Description
ASYNCHRONOUS_COMMIT
  • string
SYNCHRONOUS_COMMIT
  • string

createdByType

Typ identity, která prostředek vytvořila.

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

Failover

Režim převzetí služeb při selhání repliky ve skupině dostupnosti

Name Type Description
AUTOMATIC
  • string
MANUAL
  • string

LoadBalancerConfiguration

Konfigurace nástroje pro vyrovnávání zatížení pro naslouchací proces skupiny dostupnosti

Name Type Description
loadBalancerResourceId
  • string

ID prostředku nástroje pro vyrovnávání zatížení

privateIpAddress

Privátní IP adresa.

probePort
  • integer

Port sondy

publicIpAddressResourceId
  • string

ID prostředku veřejné IP adresy

sqlVirtualMachineInstances
  • string[]

Seznam ID prostředku instance virtuálního počítače SQL, které jsou zaregistrované do naslouchacího procesu skupiny dostupnosti.

PrivateIPAddress

Privátní IP adresa vázaná na naslouchací proces skupiny dostupnosti.

Name Type Description
ipAddress
  • string

Privátní IP adresa svázaná s naslouchacím procesem skupiny dostupnosti

subnetResourceId
  • string

Podsíť použitá k zahrnutí privátní IP adresy

ReadableSecondary

Sekundární režim pro čtení repliky ve skupině dostupnosti

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

Role

Role repliky ve skupině dostupnosti

Name Type Description
PRIMARY
  • string
SECONDARY
  • string

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Type Description
createdAt
  • string

Časové razítko vytvoření prostředku (UTC).

createdBy
  • string

Identita, která prostředek vytvořila.

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt
  • string

Časové razítko poslední změny zdroje (UTC)

lastModifiedBy
  • string

Identita, která prostředek naposledy upravila.

lastModifiedByType

Typ identity, která naposledy upravila prostředek.