Distributed Availability Groups - List By Instance

Pobiera listę rozproszonych grup dostępności w wystąpieniu.

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

Parametry identyfikatora URI

Name In Required Type Description
managedInstanceName
path True
  • string

Nazwa wystąpienia zarządzanego.

resourceGroupName
path True
  • string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.

subscriptionId
path True
  • string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.

api-version
query True
  • string

Wersja interfejsu API do użycia dla żądania.

Odpowiedzi

Name Type Description
200 OK

Pomyślnie pobrano listę rozproszonych grup dostępności.

Other Status Codes

Odpowiedzi na błędy: ***

  • 400 NameAlreadyExists — podana nazwa już istnieje.

  • 400 InvalidCollation — nieprawidłowe sortowanie.

  • 400 ProvisioningDisabled — wyświetla komunikat o błędzie z autoryzatora operacji zasobów bez zmian

  • 400 RegionDoesNotAllowProvisioning — wybrana lokalizacja nie akceptuje nowych serwerów bazy danych systemu Windows Azure SQL. Może to ulec zmianie w późniejszym czasie.

  • 400 UnableToResolveRemoteServer — nie można rozpoznać nazwy serwera zdalnego partnera z powodu problemów z nieprawidłową nazwą serwera lub łącznością DNS.

  • 400 HkCannotSwitchToInactive — baza danych nie może kontynuować aktualizacji warstwy cenowej, ponieważ ma obiekty zoptymalizowane pod kątem pamięci. Upuść takie obiekty i spróbuj ponownie.

  • 400 TokenTooLong — podany token jest za długi.

  • 400 CloudLifterUnsupportedFeature — funkcja nie jest obecnie dostępna w wystąpieniu zarządzanym.

  • 400 ManagedInstanceSloUpdateFailed — operacja SLO "{0}" nie może zakończyć się powodzeniem, ponieważ użycie pamięci "{1}" przekracza limit przydziału.

  • 400 OperationCanNotStartDueToMiLink — nie można ukończyć operacji "{0}", ponieważ istnieje baza danych w procesie tworzenia za pośrednictwem łącza wystąpienia zarządzanego. Poczekaj na ukończenie tworzenia linku lub usuń link i ponów próbę wykonania operacji.

  • 400 ManagedInstanceLocalStorageUpdateSloDisabled — aktualizacja slo dla wystąpień zarządzanych z magazynem lokalnym nie jest jeszcze obsługiwana.

  • 400 InvalidSubnetResourceId — podany identyfikator zasobu podsieci dla tworzenia lub aktualizowania wystąpienia zarządzanego jest nieprawidłowy.

  • 400 VnetInWrongRegion — sieć wirtualna znajduje się w niewłaściwym regionie.

  • 400 AlterDbDeactivatedNotSupported — operacja bazy danych nie powiodła się dla serwera "{0}", bazy danych "{1}" z powodu nieoczekiwanego opóźnienia. Spróbuj ponownie.

  • 400 VnetAddressRangeError — zakres adresów sieci wirtualnej jest nieprawidłowy.

  • 400 RegionDoesNotSupportVersion — użytkownik próbował utworzyć serwer określonej wersji w lokalizacji, w której ta wersja serwera nie jest obsługiwana.

  • 400 VnetConfigIsNotAllowed — konfiguracja sieci wirtualnej jest niedozwolona.

  • 400 InstanceFailoverGroupDoesNotExist — grupa trybu failover nie istnieje na serwerze.

  • 400 ManagedInstanceClassicVnetNotSupported — wystąpienie zarządzane nie może być przyłączone do klasycznej sieci wirtualnej.

  • 400 VnetConfigHasNsg — użytkownik próbował wstrzyknąć podsieć serwera zarządzanego z sieciowymi grupami zabezpieczeń.

  • 400 VnetConfigHasNoUdr — użytkownik próbował wstrzyknąć podsieć serwera zarządzanego bez domyślnej tabeli tras zdefiniowanych przez użytkownika.

  • 400 VnetConfigHasInvalidUdr — użytkownik próbował wstrzyknąć podsieć serwera zarządzanego z nieprawidłową tabelą tras zdefiniowanych przez użytkownika.

  • 400 VnetConfigHasInvalidDns — użytkownik próbował wstrzyknąć podsieć serwera zarządzanego z nieprawidłowym niestandardowym systemem DNS.

  • 400 VnetConfigHasServiceEndpoints — użytkownik próbował wstrzyknąć podsieć serwera zarządzanego z punktami końcowymi usługi.

  • 400 VnetSubnetIsInUse — użytkownik próbował wstrzyknąć podsieć serwera zarządzanego, która nie jest pusta.

  • 400 VnetSubnetIsLocked — użytkownik próbował wstrzyknąć podsieć serwera zarządzanego, która znajduje się w zablokowanym zakresie.

  • 400 VnetSubnetIsGateway — użytkownik próbował wstrzyknąć podsieć serwera zarządzanego, która jest podsiecią bramy.

  • 400 VnetSubnetIsUnknown — użytkownik próbował wstrzyknąć podsieć serwera zarządzanego, która nie istnieje.

  • 400 VnetSubnetConflictWithIntendedPolicy — użytkownik próbował wstrzyknąć podsieć managed server, która ma konflikt z przeznaczeniemPolicy.

  • 400 ManagedInstanceInvalidEditionForSku — określona wersja {0} nie jest zgodna z określoną jednostkę SKU {1}.

  • 400 ManagedInstanceInvalidLicenseType — określony typ {0} licencji jest nieprawidłowy.

  • 400 ManagedInstanceUpdateSloInProgress — "Nie można ukończyć operacji, ponieważ zmiana warstwy usługi jest w toku dla wystąpienia zarządzanego "{0}". Poczekaj na zakończenie trwającej operacji i spróbuj ponownie”.

  • 400 VnetResourceNotFound — nie znaleziono zasobu: "{0}".

  • 400 InstanceCollationUpdateNotSupported — użytkownik nie może zmienić sortowania wystąpienia w wystąpieniu zarządzanym.

  • 400 CreateManagedInstanceWithNonDefaultCollationNotSupported — użytkownik może utworzyć wystąpienie zarządzane tylko przy użyciu sortowania "SQL_Latin1_General_CP1_CI_AS".

  • 400 ManagedInstanceOperationInProgress — nie można ukończyć operacji, ponieważ {0} operacja jest w toku. Poczekaj na zakończenie operacji i spróbuj ponownie.

  • 400 ManagedInstanceExceedMaxAzureStorage — nie można ukończyć operacji, ponieważ łączny przydzielony rozmiar magazynu dla wystąpienia Ogólnego przeznaczenia przekroczy {0}wartość . Zmniejsz liczbę plików bazy danych i spróbuj ponownie wykonać operację.

  • 400 ManagedInstanceHasGeoReplica — nie można ukończyć operacji, ponieważ wystąpienie skonfigurowało replikowane geograficznie wystąpienie pomocnicze.

  • 400 InvalidDnsZone — operacja nie powiodła się, ponieważ próbujesz wdrożyć wystąpienie zarządzane jako pomocnicze replikacji geograficznej w podsieci {0} , w której istnieje już wystąpienie zarządzane. Wdrażanie wystąpienia zarządzanego jako pomocniczej replikacji geograficznej jest obsługiwane tylko w przypadkach, gdy wystąpienie zarządzane jest pierwszym wystąpieniem wdrożonym w podsieci. Rozważ wdrożenie wystąpienia zarządzanego jako pomocniczej replikacji geograficznej w innej podsieci, w której nie ma istniejących wystąpień zarządzanych, lub jeśli wdrożenie w podsieci z istniejącym wystąpieniem zarządzanym spowoduje wyłączenie opcji replikacji geograficznej.

  • 400 ManagedInstanceInvalidStorageSizeLessThenCurrentSizeUsed — nieprawidłowy rozmiar magazynu: limit rozmiaru magazynu ({0} GB) jest mniejszy niż obecnie używany magazyn ({1} GB). Określ większy limit rozmiaru magazynu.

  • 400 InvalidTimezone — nieprawidłowa strefa czasowa.

  • 400 InstanceTimezoneUpdateNotSupported — aktualizacja strefy czasowej wystąpienia nie jest obsługiwana.

  • 400 CreateManagedInstanceWithNonDefaultTimezoneNotSupported — tworzenie wystąpienia zarządzanego bez domyślnej strefy czasowej nie jest obsługiwane.

  • 400 ManagedInstanceIpAddressRangeLimit — nie można wykonać tworzenia/skalowania wystąpienia zarządzanego, ponieważ w podsieci nie ma wystarczającej liczby dostępnych adresów IP do wykonania operacji.

  • 400 VnetDelegationNotAllowed — użytkownik próbował wstrzyknąć serwer zarządzany do podsieci, która jest delegowana.

  • 400 SubnetHasResourcesOfDifferentType — użytkownik próbował utworzyć wystąpienie zarządzane w podsieci, która ma zasoby innego typu.

  • 400 UpdateManagedServerWithMaintenanceWindowNotAllowed — aktualizacja wystąpienia zarządzanego z ustawieniami okna obsługi jest niedozwolona.

  • 400 VnetPrepareNIPFailed — użytkownik próbował przygotować podsieć, która ma konflikt z siecią NetworkIntentPolicy.

  • 400 ManagedInstanceDeprecatedHardwareFamily — zmiana generacji sprzętu na przestarzałą {0} generację nie jest możliwa.

  • 400 ManagedInstanceBackupStorageTypeNotSupported — parametr typu magazynu kopii zapasowej nie jest dozwolony w operacji aktualizacji wystąpienia.

  • 400 EmptyPDCInvalidDnsZone — nie można wdrożyć tego wystąpienia zarządzanego, ponieważ jego strefa DNS jest niezgodna z prefiksem DNS zamierzonego klastra wirtualnego dla podsieci {0}. Mimo że ten klaster wirtualny jest pusty, nie można zmienić jego prefiksu DNS. Puste klastry wirtualne zostaną automatycznie usunięte po kilku godzinach. Rozważ oczekiwanie na wygaśnięcie tego klastra wirtualnego lub ręczne usunięcie tego klastra wirtualnego, a następnie utworzenie wystąpienia zarządzanego.

  • 400 MissingIdentityId — nie podano tożsamości przypisanej przez użytkownika, gdy typ tożsamości jest ustawiony na UserAssigned

  • 400 InvalidPrimaryIdentityId — użytkownik udostępnia wartość PrimaryUserIdentityId, ale ta sama wartość nie znajduje się na liście w parametrze IdentityId

  • 400 ManagedInstanceZoneRedudantFeatureNotSupported — funkcja ZoneRedundant nie jest obsługiwana dla wybranej warstwy usługi. Aby uzyskać więcej informacji, odwiedź aka.ms/sqlmi-service-tier-characteristics.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeEnabled — włączanie funkcji zoneRedundant nie jest możliwe po utworzeniu wystąpienia zarządzanego. Aby uzyskać więcej informacji, odwiedź aka.ms/sqlmi-high-availability.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeDisabled — wyłączenie funkcji zoneRedundant nie jest możliwe po utworzeniu wystąpienia zarządzanego. Aby uzyskać więcej informacji, odwiedź aka.ms/sqlmi-high-availability.

  • 400 UmiMissingAkvPermissions — PrimaryUserAssignedIdentityId podany przez użytkownika nie ma dostępu do podanego identyfikatora KeyId

  • 400 MissingPrimaryIdentity — PrimaryUserAssignedIdentityId podany przez użytkownika nie ma dostępu do podanego identyfikatora KeyId

  • 400 SubnetIdCantBeUpdated — zmiana podsieci wystąpienia zarządzanego nie jest obsługiwana. Usuń ten parametr z żądania.

  • 400 MigrationToAnotherVNetNotSupported — wybrana podsieć znajduje się w innej Virtual Network. Przenoszenie wystąpienia zarządzanego do innego Virtual Network nie jest możliwe. Podaj podsieć z Virtual Network {0}.

  • 400 MigrationToSubnetWithDifferentDnsZoneNotSupported — podana podsieć ma inną strefę DNS od bieżącej. Zmiana strefy DNS wystąpienia nie jest obsługiwana. Podaj podsieć z tą samą strefą DNS, utwórz nową podsieć lub podaj pustą.

  • 400 MigrationToGen4SubnetNotSupported — nie można zaktualizować podsieci podczas uruchamiania na sprzęcie Gen4, ponieważ jest przestarzały. Uaktualnij sprzęt z gen4 do gen5 w ramach zmieniającej się operacji podsieci wystąpienia zarządzanego, określając jednocześnie oba parametry: podsieć docelową i generację sprzętu.

  • 400 PrimaryIdentityMissingPermissionForKeyId — KeyId jest udostępniany przez użytkownika podczas tworzenia, ale parametr PrimaryUserAssignedIdentityId nie jest udostępniany w wywołaniu interfejsu API

  • 400 InvalidIdentityTypeForKeyId — identyfikator KeyId jest dostarczany przez użytkownika podczas tworzenia, ale typ tożsamości nie jest ustawiony na wartość "UserAssigned"

  • 400 ServerNotFound — żądany serwer nie został znaleziony.

  • 400 ManagedInstanceFileExceededMaxAzureStorageFileSizeLimit — nie można ukończyć operacji, ponieważ niektóre pliki bazy danych przekraczają maksymalny limit {0} rozmiaru pliku Ogólnego przeznaczenia GB.

  • 400 ManagedInstanceStoppingOrStopped — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie zatrzymania/zatrzymania

  • 400 ManagedInstanceStarting — operacja powodująca konflikt przesłana podczas uruchamiania wystąpienia

  • 400 InstancePoolNotEnoughCapacity — pula wystąpień nie ma wystarczającej pojemności

  • 400 SourceAndTargetSubnetsMustBeVnetPeered — podsieć używana obecnie przez wystąpienie zarządzane i podsieć docelowa są częścią sieci wirtualnych, które nie są połączone z komunikacją równorzędną sieci wirtualnych lub mają ustanowioną komunikację równorzędną, ale nie mają dozwolonego ruchu. Aby przenieść wystąpienie zarządzane z jednej podsieci do innej, należy ustanowić komunikację równorzędną sieci wirtualnych zarówno ze źródłowej, jak i docelowej sieci wirtualnej. Skonfiguruj wymagania dotyczące sieci wirtualnej, a następnie spróbuj ponownie wykonać operację. Dowiedz się więcej https://docs.microsoft.com/en-us/azure/virtual-network/tutorial-connect-virtual-networks-portal#peer-virtual-networks.

  • 400 ManagedInstanceAndSubnetAreNotOnTheSameSubscription — podsieć podana na potrzeby wdrożenia wystąpienia zarządzanego znajduje się w subskrypcji innej niż ta przesłana dla wystąpienia zarządzanego. Wystąpienie zarządzane i podsieć używane do wdrażania wystąpienia muszą znajdować się w tej samej subskrypcji. Podaj inną podsieć lub przełącz się do subskrypcji podsieci, a następnie spróbuj ponownie wykonać operację.

  • 400 CreateManagedInstanceInvalidSubnetSize — użytkownik próbował utworzyć wystąpienie zarządzane w podsieci mniejszej niż dozwolony minimalny rozmiar podsieci.

  • 400 AddressRangeOfTargetSubnetAndSubnetOfGeoDRReplicaCantOverlap — podsieć wybrana na potrzeby migracji wystąpienia zarządzanego ma zakres adresów nakładający się na zakres adresów podsieci, która zawiera wystąpienie pomocnicze replikowane geograficznie. Sprawdź, czy podsieć jest skonfigurowana zgodnie z wytycznymi w temacie https://aka.ms/move-managed-instance.

  • 400 TargetSubnetMustBeConfiguredToAllowGeoDRReplication — podsieć wybrana na potrzeby migracji wystąpienia zarządzanego nie jest skonfigurowana do włączania komunikacji z wystąpieniem pomocniczym replikowanym geograficznie. Sprawdź, czy wszystkie wymagane porty są otwarte. Aby prawidłowo skonfigurować podsieć, zapoznaj się z wytycznymi w temacie https://aka.ms/move-managed-instance.

  • 400 InvalidIdentifier — identyfikator zawiera wartość NULL lub nieprawidłowy znak Unicode.

  • 400 InvalidLoginName — podana nazwa logowania jest nieprawidłowa.

  • 400 InvalidUsername — podana nazwa użytkownika zawiera nieprawidłowe znaki.

  • 400 PasswordTooShort — podane hasło jest za krótkie

  • 400 PasswordTooLong — podane hasło jest za długie.

  • 400 PasswordNotComplex — podane hasło nie jest wystarczająco złożone.

  • 400 GatewayInvalidEdition — "{0}" nie jest prawidłową wersją bazy danych w tej wersji SQL Server.

  • 400 InvalidLocation — określono nieprawidłową lokalizację.

  • 400 InvalidParameterValue — nieprawidłowa wartość została nadana parametrowi.

  • 400 InvalidServerName — określona nieprawidłowa nazwa serwera.

  • 404 ResourceNotFound — żądany zasób nie został znaleziony.

  • 404 ResourceDoesNotExist — zasób o nazwie "{0}" nie istnieje. Aby kontynuować, określ prawidłową nazwę zasobu.

  • 404 InstancePoolNotFound — nie można odnaleźć puli wystąpień

  • 404 SubscriptionNotFound — nie znaleziono żądanej subskrypcji.

  • 405 InvalidVcoreValue — wartość {0} rdzenia wirtualnego jest nieprawidłowa. Określ prawidłową wartość rdzeni wirtualnych.

  • 405 InvalidHardwareGenerationValue — generowanie {0} sprzętu jest nieprawidłowe. Określ prawidłową wartość HardwareGeneration.

  • 405 InvalidStorageSizeValue — "Nieprawidłowy rozmiar magazynu: {0} GB. Rozmiar magazynu musi być określony między {1}{2} gigabajtami, w przyrostach {3} GB.

  • 409 ConflictingServerOperation — operacja jest obecnie w toku dla serwera.

  • 409 SubscriptionDisabled — subskrypcja jest wyłączona.

  • 409 ServerOverridePreconditionFailed — nie można zastosować zastąpienia serwera w kategorii "{0}", ponieważ fizyczna baza danych lub wystąpienie "{1}" na serwerze "{2}" nie jest obecnie w stanie "Gotowe" lub "Dezaktywowane".

  • 409 ManagedInstanceIsBusy — serwer "{0}" jest obecnie zajęty. Poczekaj kilka minut, zanim spróbuj ponownie.

  • 409 ServerAlreadyExists — zduplikowana nazwa serwera.

  • 409 ServerDisabled — serwer jest wyłączony.

  • 409 ServerQuotaExceeded — nie można dodać serwera do subskrypcji, ponieważ przekroczy limit przydziału.

  • 429 ConflictingSubscriptionOperation — operacja jest obecnie w toku dla subskrypcji.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 500 GatewayInternalServerError — serwer napotkał nieoczekiwany wyjątek.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 504 RequestTimeout — żądanie usługi przekroczyło dozwolony limit czasu.

Przykłady

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

Definicje

DistributedAvailabilityGroup

Rozproszona grupa dostępności między usługami Box i Sql Managed Instance.

DistributedAvailabilityGroupsListResult

Lista rozproszonych grup dostępności w wystąpieniu.

ReplicationMode

Tryb replikacji rozproszonej grupy dostępności. Parametr zostanie zignorowany podczas tworzenia linku.

DistributedAvailabilityGroup

Rozproszona grupa dostępności między usługami Box i Sql Managed Instance.

Name Type Description
id
  • string

Identyfikator zasobu.

name
  • string

Nazwa zasobu.

properties.distributedAvailabilityGroupId
  • string

Identyfikator rozproszonej grupy dostępności

properties.lastHardenedLsn
  • string

Ostatni wzmocniony lsn

properties.linkState
  • string

Stan łącza

properties.primaryAvailabilityGroupName
  • string

Nazwa podstawowej grupy dostępności

properties.replicationMode

Tryb replikacji rozproszonej grupy dostępności. Parametr zostanie zignorowany podczas tworzenia linku.

properties.secondaryAvailabilityGroupName
  • string

Nazwa pomocniczej grupy dostępności

properties.sourceEndpoint
  • string

Źródłowy punkt końcowy

properties.sourceReplicaId
  • string

Identyfikator repliki źródłowej

properties.targetDatabase
  • string

Nazwa docelowej bazy danych

properties.targetReplicaId
  • string

Identyfikator repliki docelowej

type
  • string

Typ zasobu.

DistributedAvailabilityGroupsListResult

Lista rozproszonych grup dostępności w wystąpieniu.

Name Type Description
nextLink
  • string

Łącze, aby pobrać następną stronę wyników.

value

Tablica wyników.

ReplicationMode

Tryb replikacji rozproszonej grupy dostępności. Parametr zostanie zignorowany podczas tworzenia linku.

Name Type Description
Async
  • string
Sync
  • string