Sdílet prostřednictvím


Distributed Availability Groups - List By Instance

Získá seznam distribuovaných skupin dostupnosti v instanci.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
managedInstanceName
path True

string

Název spravované instance.

resourceGroupName
path True

string

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

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.

Odpovědi

Name Typ Description
200 OK

DistributedAvailabilityGroupsListResult

Seznam distribuovaných skupin dostupnosti se úspěšně načetl.

Other Status Codes

Chybové odpovědi: ***

  • 400 NameAlreadyExists – zadaný název již existuje.

  • 400 InvalidCollation – neplatná kolace.

  • 400 ProvisioningDisabled – zobrazí chybovou zprávu z operace prostředků authorizer tak, jak je, beze změn.

  • 400 RegionDoesNotAllowProvisioning – vybrané umístění nepřijímá nové databázové servery windows Azure SQL. To se může později změnit.

  • 400 UnableToResolveRemoteServer – Název vzdáleného partnerského serveru nelze vyřešit kvůli neplatnému názvu serveru nebo problémům s připojením k DNS.

  • 400 HkCannotSwitchToInactive – databáze nemůže pokračovat v aktualizaci cenové úrovně, protože má objekty optimalizované pro paměť. Odstraňte tyto objekty a zkuste to znovu.

  • 400 TokenTooLong – zadaný token je příliš dlouhý.

  • 400 CloudLifterUnsupportedFeature – funkce není v tuto chvíli ve spravované instanci dostupná.

  • 400 ManagedInstanceSloUpdateFailed – operace SLO{0} nemůže být úspěšná, protože využití paměti objektu '{1}' překračuje kvótu.

  • 400 OperationCanNotStartDueToMiLink – operaci{0} nelze dokončit, protože existuje databáze v procesu vytváření prostřednictvím propojení spravované instance. Počkejte, až se vytvoření odkazu dokončí, nebo ho odstraňte a zkuste operaci zopakovat.

  • 400 ManagedInstanceLocalStorageUpdateSloDisabled – Aktualizace SLO pro spravované instance s místním úložištěm se zatím nepodporuje.

  • 400 InvalidSubnetResourceId – zadané ID prostředku podsítě pro vytvoření nebo aktualizaci spravované instance je neplatné.

  • 400 VnetInWrongRegion – Virtuální síť je v nesprávné oblasti.

  • 400 AlterDbDeactivatedNotSupported – Operace databáze pro server selhala{0}{1} kvůli neočekávanému zpoždění. Zkuste to prosím znovu.

  • 400 VnetAddressRangeError – Rozsah adres virtuální sítě je neplatný.

  • 400 RegionDoesNotSupportVersion – uživatel se pokusil vytvořit server zadané verze v umístění, kde se tato verze serveru nepodporuje.

  • 400 VnetConfigIsNotAllowed – Konfigurace virtuální sítě není povolená.

  • 400 InstanceFailoverGroupDoesNotExist – skupina převzetí služeb při selhání na serveru neexistuje.

  • 400 ManagedInstanceClassicVnetNotSupported – Spravovanou instanci nejde připojit ke klasické virtuální síti.

  • 400 VnetConfigHasNsg – uživatel se pokusil vložit podsíť spravovaného serveru se skupinami zabezpečení sítě.

  • 400 VnetConfigHasNoUdr – Uživatel se pokusil vložit podsíť spravovaného serveru bez výchozí směrovací tabulky definované uživatelem.

  • 400 VnetConfigHasInvalidUdr – Uživatel se pokusil vložit podsíť spravovaného serveru s neplatnou směrovací tabulkou definovanou uživatelem.

  • 400 VnetConfigHasInvalidDns – uživatel se pokusil vložit podsíť spravovaného serveru s neplatným vlastním DNS.

  • 400 VnetConfigHasServiceEndpoints – Uživatel se pokusil vložit podsíť spravovaného serveru s koncovými body služby.

  • 400 VnetSubnetIsInUse – Uživatel se pokusil vložit podsíť spravovaného serveru, která není prázdná.

  • 400 VnetSubnetIsLocked – Uživatel se pokusil vložit podsíť spravovaného serveru, která je v uzamčené oblasti.

  • 400 VnetSubnetIsGateway – Uživatel se pokusil vložit podsíť spravovaného serveru, která je podsítí brány.

  • 400 VnetSubnetIsUnknown – Uživatel se pokusil vložit podsíť spravovaného serveru, která neexistuje.

  • 400 VnetSubnetConflictWithIntendedPolicy – uživatel se pokusil vložit podsíť spravovaného serveru, u které došlo k konfliktu s objektem IntendedPolicy.

  • 400 ManagedInstanceInvalidEditionForSku – zadaná edice {0} není konzistentní se zadanou skladovou položkou {1}.

  • 400 ManagedInstanceInvalidLicenseType – zadaný typ {0} licence není platný.

  • 400 ManagedInstanceUpdateSloInProgress – Operace se nedala dokončit, protože pro spravovanou instanci{0} probíhá změna úrovně služby. Vyčkejte, než se operace dokončí, a zkuste to znovu.“

  • 400 VnetResourceNotFound – prostředek nebyl nalezen: '{0}'.

  • 400 InstanceCollationUpdateNotSupported – uživatel nemůže změnit kolaci instance ve spravované instanci.

  • 400 CreateManagedInstanceWithNonDefaultCollationNotSupported – Uživatel může vytvořit spravovanou instanci pouze s kolací "SQL_Latin1_General_CP1_CI_AS".

  • 400 ManagedInstanceOperationInProgress – Operaci nelze dokončit, protože {0} operace probíhá. Počkejte na dokončení probíhající operace a zkuste to znovu.

  • 400 ManagedInstanceExceedMaxAzureStorage – Operaci nelze dokončit, protože celková velikost přiděleného úložiště pro instanci Pro obecné účely by překročila {0}. Snižte počet souborů databáze a operaci opakování.

  • 400 ManagedInstanceHasGeoReplica – Operaci nelze dokončit, protože instance nakonfigurovala geograficky replikovanou sekundární instanci.

  • 400 InvalidDnsZone – operace selhala, protože se pokoušíte nasadit spravovanou instanci jako sekundární geografickou replikaci do podsítě {0} , ve které už spravovaná instance existuje. Nasazení spravované instance jako sekundární geografické replikace se podporuje pouze v případech, kdy je spravovaná instance první instancí nasazenou v podsíti. Zvažte nasazení spravované instance jako sekundární geografické replikace do jiné podsítě, ve které neexistují žádné spravované instance, nebo pokud nasazení do podsítě s existující spravovanou instancí zakažte možnost geografické replikace.

  • 400 ManagedInstanceInvalidStorageSizeLessThenCurrentSizeUsed – neplatná velikost úložiště: Limit velikosti úložiště ({0} GB) je menší než aktuální využité úložiště ({1} GB). Zadejte vyšší limit velikosti úložiště.

  • 400 InvalidTimezone – neplatné časové pásmo.

  • 400 InstanceTimezoneUpdateNotSupported – aktualizace časového pásma instance se nepodporuje.

  • 400 CreateManagedInstanceWithNonDefaultTimezoneNotSupported – vytvoření spravované instance s nepodporovaným časovým pásmem, které není výchozí.

  • 400 ManagedInstanceIpAddressRangeLimit – Nejde provést vytvoření nebo škálování spravované instance, protože v podsíti není dostatek dostupných IP adres pro provedení operace.

  • 400 VnetDelegationNotAllowed – Uživatel se pokusil vložit spravovaný server do podsítě, která je delegovaná.

  • 400 SubnetHasResourcesOfDifferentType – uživatel se pokusil vytvořit mi v podsíti, která má prostředky jiného typu.

  • 400 UpdateManagedServerWithMaintenanceWindowNotAllowed – Aktualizace spravované instance s nastavením časového období údržby není povolená.

  • 400 VnetPrepareNIPFailed – Uživatel se pokusil připravit podsíť, která má konflikt s NetworkIntentPolicy.

  • 400 ManagedInstanceDeprecatedHardwareFamily – Změna generace hardwaru na zastaralou {0} generaci není možná.

  • 400 ManagedInstanceBackupStorageTypeNotSupported – v operaci aktualizace instance není povolen parametr typu úložiště zálohování.

  • 400 EmptyPDCInvalidDnsZone – Tuto spravovanou instanci nelze nasadit, protože její zóna DNS neodpovídá předponě DNS zamýšleného virtuálního clusteru pro podsíť {0}. I když je tento virtuální cluster prázdný, jeho předponu DNS nejde změnit. Prázdné virtuální clustery se po několika hodinách automaticky odeberou. Zvažte čekání na vypršení platnosti tohoto virtuálního clusteru nebo ruční odstranění tohoto virtuálního clusteru a následné vytvoření spravované instance.

  • 400 MissingIdentityId –Při nastavení typu identity userAssigned se neposkytne žádná identita přiřazená uživatelem.

  • 400 InvalidPrimaryIdentityId – Uživatel poskytuje hodnotu PrimaryUserIdentityId, ale stejná hodnota není uvedená v parametru IdentityId.

  • 400 ManagedInstanceZoneRedudantFeatureNotSupported – Funkce ZoneRedundant se pro vybranou úroveň služby nepodporuje. Další podrobnosti najdete v aka.ms/sqlmi-service-tier-characteristics.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeEnabled – Po vytvoření spravované instance není možné povolit funkci zoneRedundant. Další podrobnosti najdete na aka.ms/sqlmi-high-availability.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeDisabled – Po vytvoření spravované instance není možné zakázat funkci zoneRedundant. Další podrobnosti najdete na aka.ms/sqlmi-high-availability.

  • 400 UmissingAkvPermissions – PrimaryUserAssignedIdentityId poskytnuté uživatelem nemá přístup k zadanému Id klíče.

  • 400 MissingPrimaryIdentity – PrimaryUserAssignedIdentityId zadané uživatelem nemá přístup k id klíče zadanému uživatelem.

  • 400 SubnetIdCantBeUpdated – Změna podsítě spravované instance se nepodporuje. Odeberte tento parametr z požadavku.

  • 400 MigrationToAnotherVNetNotSupported – Vybraná podsíť je v jiné Virtual Network. Přesunutí spravované instance do jiné Virtual Network není možné. Zadejte podsíť z Virtual Network {0}.

  • 400 MigrationToSubnetWithDifferentDnsZoneNotSupported – Zadaná podsíť má jinou zónu DNS než aktuální. Změna zóny DNS instance se nepodporuje. Zadejte podsíť se stejnou zónou DNS, vytvořte novou podsíť nebo zadejte prázdnou.

  • 400 MigrationToGen4SubnetNotSupported – Není možné aktualizovat podsíť při spuštění na hardwaru Gen4, protože je zastaralá. V rámci operace změny podsítě spravované instance upgradujte hardware z Gen4 na Gen5 tak, že současně zadáte oba parametry: cílovou podsíť a generaci hardwaru.

  • 400 PrimaryIdentityMissingPermissionForKeyId – id klíče poskytuje uživatel během vytváření, ale primaryUserAssignedIdentityId není k dispozici ve volání rozhraní API.

  • 400 InvalidIdentityTypeForKeyId – id klíče poskytne uživatel během vytváření, ale typ identity není nastavený na UserAssigned.

  • 400 ServerNotFound – požadovaný server nebyl nalezen.

  • 400 ManagedInstanceFileExceededMaxAzureStorageFileSizeLimit – operaci nelze dokončit, protože některé soubory databáze překračují maximální limit {0} velikosti souboru Pro obecné účely GB.

  • 400 ManagedInstanceStoppingOrStopped – konfliktní operace odeslaná, když je instance ve stavu zastavení nebo zastavení.

  • 400 ManagedInstanceStarting – konfliktní operace odeslaná, když je instance ve výchozím stavu.

  • 400 InstancePoolNotEnoughCapacity – fond instancí nemá dostatečnou kapacitu.

  • 400 SourceAndTargetSubnetsMustBeVnetPeered – podsíť aktuálně používaná spravovanou instancí a zadaná cílová podsíť jsou součástí virtuálních sítí, které nejsou připojené k partnerskému vztahu virtuálních sítí nebo mají vytvořený partnerský vztah, ale nemají povolený provoz. Aby bylo možné přesunout spravovanou instanci z jedné podsítě do jiné, je potřeba vytvořit partnerský vztah virtuálních sítí ze zdrojové i cílové virtuální sítě. Nakonfigurujte požadavky na virtuální síť a opakujte operaci. https://docs.microsoft.com/en-us/azure/virtual-network/tutorial-connect-virtual-networks-portal#peer-virtual-networksDalší informace

  • 400 ManagedInstanceAndSubnetAreNotOnTheSameSubscription – podsíť poskytovaná pro nasazení spravované instance se nachází v jiném předplatném než v předplatném odeslaném pro spravovanou instanci. Spravovaná instance a podsíť použité k nasazení instance musí být ve stejném předplatném. Zadejte jinou podsíť nebo přepněte na předplatné podsítě a pak operaci opakujte.

  • 400 CreateManagedInstanceInvalidSubnetSize – uživatel se pokusil vytvořit spravovanou instanci v podsíti, která je menší než povolená minimální velikost podsítě.

  • 400 AddressRangeOfTargetSubnetAndSubnetOfGeoDRReplicaCantOverlap – Podsíť vybraná pro migraci spravované instance má rozsah adres, který se překrývá s rozsahem adres podsítě, která obsahuje geograficky replikovanou sekundární instanci. Ověřte, že je vaše podsíť nakonfigurovaná podle pokynů v https://aka.ms/move-managed-instancetématu .

  • 400 TargetSubnetMustBeConfiguredToAllowGeoDRReplication – Podsíť vybraná pro migraci spravované instance není nakonfigurovaná tak, aby umožňovala komunikaci s geograficky replikovanou sekundární instancí. Zkontrolujte, jestli jsou otevřené všechny požadované porty. Pokud chcete správně nakonfigurovat podsíť, přečtěte si pokyny v tématu https://aka.ms/move-managed-instance.

  • 400 InvalidIdentifier – identifikátor obsahuje null nebo neplatný znak unicode.

  • 400 InvalidLoginName – zadané přihlašovací jméno je neplatné.

  • 400 InvalidUsername (Neplatné uživatelské jméno) – zadané uživatelské jméno obsahuje neplatné znaky.

  • 400 PasswordTooShort – zadané heslo je příliš krátké.

  • 400 PasswordTooLong – zadané heslo je příliš dlouhé.

  • 400 PasswordNotComplex – zadané heslo není dostatečně složité.

  • 400 GatewayInvalidEdition –{0} v této verzi SQL Server není platná edice databáze.

  • 400 InvalidLocation – bylo zadáno neplatné umístění.

  • 400 InvalidParameterValue – parametru byla přiřazena neplatná hodnota.

  • 400 InvalidServerName – zadaný neplatný název serveru.

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

  • 404 ResourceDoesNotExist – prostředek s názvem{0} neexistuje. Pokud chcete pokračovat, zadejte platný název prostředku.

  • 404 InstancePoolNotFound – Fond instancí nebyl nalezen.

  • 404 SubscriptionNotFound –Požadované předplatné nebylo nalezeno.

  • 405 InvalidVcoreValue – hodnota {0} virtuálního jádra není platná. Zadejte platnou hodnotu virtuálního jádra.

  • 405 InvalidHardwareGenerationValue – HardwareGeneration {0} není platný. Zadejte platnou hodnotu HardwareGeneration.

  • 405 InvalidStorageSizeValue – Neplatná velikost úložiště: {0} GB. Velikost úložiště musí být zadána mezi {1} gigabajtem a {2} v přírůstcích po {3} GB.

  • 409 ConflictingServerOperation – aktuálně probíhá operace pro server.

  • 409 SubscriptionDisabled – Předplatné je zakázané.

  • 409 ServerOverridePreconditionFailed – Nepovedlo se použít přepsání serveru u kategorie,{0} protože fyzická databáze nebo instance{1} na serveru{2} v současné době nejsou ve stavu Připraveno nebo Deaktivované.

  • 409 ManagedInstanceIsBusy – server{0} je momentálně zaneprázdněný. Počkejte prosím několik minut, než to zkuste znovu.

  • 409 ServerAlreadyExists – duplicitní název serveru.

  • 409 ServerDisabled – Server je zakázaný.

  • 409 ServerQuotaExceed – Server nelze přidat do předplatného, protože překročí kvótu.

  • 429 ConflictingSubscriptionOperation – aktuálně probíhá operace pro předplatné.

  • 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

  • 500 GatewayInternalServerError – na serveru došlo k neočekávané výjimce.

  • 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

  • 504 RequestTimeout – Žádost o službu překročila povolený časový limit.

Příklady

Lists all distributed availability groups in instance.

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
DistributedAvailabilityGroup

Distribuovaná skupina dostupnosti mezi boxem a službou SQL Managed Instance.

DistributedAvailabilityGroupsListResult

Seznam distribuovaných skupin dostupnosti v instanci

ReplicationMode

Režim replikace distribuované skupiny dostupnosti. Parametr bude při vytváření odkazu ignorován.

DistributedAvailabilityGroup

Distribuovaná skupina dostupnosti mezi boxem a službou SQL Managed Instance.

Name Typ Description
id

string

ID prostředku.

name

string

Název prostředku.

properties.distributedAvailabilityGroupId

string

ID distribuované skupiny dostupnosti

properties.lastHardenedLsn

string

Poslední kalené lsn

properties.linkState

string

Stav propojení

properties.primaryAvailabilityGroupName

string

Název primární skupiny dostupnosti

properties.replicationMode

ReplicationMode

Režim replikace distribuované skupiny dostupnosti. Parametr bude při vytváření odkazu ignorován.

properties.secondaryAvailabilityGroupName

string

Název sekundární skupiny dostupnosti

properties.sourceEndpoint

string

Zdrojový koncový bod

properties.sourceReplicaId

string

ID zdrojové repliky

properties.targetDatabase

string

Název cílové databáze

properties.targetReplicaId

string

ID cílové repliky

type

string

Typ prostředku.

DistributedAvailabilityGroupsListResult

Seznam distribuovaných skupin dostupnosti v instanci

Name Typ Description
nextLink

string

Odkaz na načtení další stránky výsledků

value

DistributedAvailabilityGroup[]

Pole výsledků

ReplicationMode

Režim replikace distribuované skupiny dostupnosti. Parametr bude při vytváření odkazu ignorován.

Name Typ Description
Async

string

Sync

string