Failover Groups - Get

Feladatátvételi csoportot kap.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2021-11-01

URI-paraméterek

Name In Kötelező Típus Description
failoverGroupName
path True

string

A feladatátvételi csoport neve.

resourceGroupName
path True

string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.

serverName
path True

string

A feladatátvételi csoportot tartalmazó kiszolgáló neve.

subscriptionId
path True

string

Az Azure-előfizetést azonosító előfizetés-azonosító.

api-version
query True

string

A kéréshez használni kívánt API-verzió.

Válaszok

Name Típus Description
200 OK

FailoverGroup

Sikerült beolvasni a megadott feladatátvételi csoportot.

Other Status Codes

Hibaválaszok: ***

  • 400 Feladatátvételi csoportCreateOrUpdateRequestInvalidDatabases – A megadott adatbázis-azonosítók nem megfelelően összeállított adatbázis-erőforrásazonosítók. A megfelelő formázás példáját lásd: https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestInvalidPartner – A feladatátvételi csoport kérelemtörzsének létrehozása vagy frissítése során megadott partnerek mező üres vagy érvénytelen. Adja meg a mező érvényes értékét. A megfelelően formázott kérelmekre példákért lásd: https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestDuplicatePartner – A megadott partnerkiszolgálók közül legalább egy már része a feladatátvételi csoportnak. Győződjön meg arról, hogy az elsődleges kiszolgáló és az összes adott partnerkiszolgáló egyedi.

  • 400 Feladatátvételi csoportCreateOrUpdateRequestInvalidDatabaseServer – Egy vagy több megadott adatbázis nem létezik a feladatátvételi csoport elsődleges kiszolgálóján. Győződjön meg arról, hogy az összes adatbázis létezik az elsődleges kiszolgálón.

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestUnsupportedPartnerCount – A feladatátvételi csoporthoz csak egy partnerkiszolgáló támogatott. Ennek megfelelően módosítsa a kérést. Az érvényes kérelmekre vonatkozó példákért lásd: https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 Feladatátvételi csoportCreateOrUpdateRequestInvalidReadWriteEndpoint – A readWriteEndpoint mező szükséges a kérések létrehozásához vagy frissítéséhez.

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestInvalid – A feladatátvételi csoport létrehozásának vagy frissítésének kérelemtörzse üres vagy érvénytelen.

  • 400 Feladatátvételi csoportUpdateOrDeleteRequestOnSecondary – A feladatátvételi csoport módosítása másodlagos kiszolgálón nem engedélyezett. Hajtsa végre a kérést az elsődleges kiszolgálón.

  • 400 Feladatátvételi csoportCreateOrUpdateRequestNegativeGracePeriodValues – Az olvasási-írási végpont türelmi időszakának értéke nem lehet negatív.

  • 400 Feladatátvételi csoportCreateOrUpdateRequestLessThanMinimumGracePeriodValues – A feladatátvételi csoport türelmi időszakának értéke nem lehet hosszabb vagy egyenlő a minimális türelmi időszak "{0}perc" időtartamával

  • 400 Feladatátvételi csoportCreateOrUpdateRequestInvalidReadWriteEndpointFields – A feladatátvételWithDataLossGracePeriodMinutes tulajdonságot meg kell adni, ha a feladatátvételi szabályzat automatikusan be van jelölve az olvasási-írási végponthoz.

  • 400 Feladatátvételi csoportCreateOrUpdateRequestInvalidReadWriteFailoverPolicy – Az írási-olvasási végpont feladatátvételi házirend mezőjére van szükség a kérések létrehozásához vagy frissítéséhez.

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – A türelmi időszak értéke nem adható meg, ha a feladatátvételi szabályzat kézikönyve be van jelölve az olvasási-írási végponthoz. Távolítsa el a kérésből.

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestReadOnlyPropertyModified – A feladatátvételi csoport létrehozásának vagy frissítésének kérelemtörzse nem módosíthatja a ""{0} írásvédett tulajdonságot.

  • 400 Feladatátvételi csoportFailoverRequestOnPrimary – A feladatátvételi kérelmet a feladatátvételi csoport másodlagos kiszolgálóján kell kezdeményezni.

  • 400 Feladatátvételi csoportPartnerServerFromDifferentSubscription – Az elsődleges kiszolgáló és a feladatátvételi csoport partnerkiszolgálói különböző előfizetésekből származnak. A feladatátvételi csoport kiszolgálóinak kereszt-előfizetése nem engedélyezett.

  • 400 InvalidAddSecondaryPermission – A felhasználó nem rendelkezik elegendő engedéllyel a másodlagos kiszolgáló hozzáadásához.

  • 400 InvalidSku – A felhasználó érvénytelen termékváltozatot adott meg.

  • 400 ServerNotFound – A kért kiszolgáló nem található.

  • 400 FeatureDisabledOnSelectedEdition – A felhasználó olyan funkciót próbált használni, amely le van tiltva az aktuális adatbázis-kiadásban.

  • 400 TokenTooLong – A megadott token túl hosszú.

  • 400 InvalidTargetSubregion – Egy nem olvasható másodlagos kiszolgáló célkiszolgálója nem dr. párosított Azure-régióban található.

  • 400 PartnerServerNotCompatible – A felhasználó egy SAWA V1-kiszolgálóról próbál adatbázist egy Sterling-kiszolgálóra másolni, vagy fordítva.

  • 400 IncorrectReplicationLinkState – A művelet elvárja, hogy az adatbázis várt állapotban legyen a replikációs hivatkozáson.

  • 400 ResourcePoolNotFound – A megadott rugalmas készlet nem létezik a megadott logikai kiszolgálón.

  • 400 AzureKeyVaultKeyDisabled – A művelet nem hajtható végre a kiszolgálón, mert az Azure Key Vault kulcs le van tiltva.

  • 400 AzureKeyVaultInvalidExpirationDate – A művelet nem hajtható végre, mert az Azure Key Vault kulcs lejárati dátuma érvénytelen.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty – A művelet nem hajtható végre, mert az Azure Key Vault URI null értékű vagy üres.

  • 400 AzureKeyVaultNoServerIdentity – A kiszolgálóidentitás nincs megfelelően konfigurálva.

  • 400 AzureKeyVaultInvalidUri – Az Azure Key Vault érvénytelen válasza. Használjon érvényes Azure Key Vault URI-t.

  • 400 AzureKeyVaultMissingPermissions – A kiszolgáló nem rendelkezik szükséges engedélyekkel az Azure Key Vault.

  • 400 SecurityAzureKeyVaultInvalidKeyName – Érvénytelen kiszolgálókulcsnév miatt nem sikerült végrehajtani a műveletet.

  • 400 PlannedFailoverTimedOutForDatabase – A felhasználó meghívta tervezett feladatátvétel, időtúllépést tapasztalt, és úgy tűnik, hogy egy adott adatbázis a hibás.

  • 400 PlannedFailoverTimedOut – A felhasználó meghívta tervezett feladatátvétel, és időtúllépést tapasztalt a partnerfelügyeleti szolgáltatással való kapcsolatfelvétel során.

  • 400 AdalGenericError – A művelet nem hajtható végre, mert Azure Active Directory-hiba történt.

  • 400 AdalServicePrincipalNotFound – A művelet nem hajtható végre, mert egy Azure Active Directory-kódtár szolgáltatásnévje nem található hiba történt.

  • 400 AzureKeyVaultMalformedVaultUri – A megadott Key Vault uri érvénytelen.

  • 400 CannotUseReservedDatabaseName – Ebben a műveletben nem használható fenntartott adatbázisnév.

  • 400 InvalidFailoverGroupRegion – A feladatátvételi csoportban megadott kiszolgálóknak különböző régiókban kell elhelyezkedniük az elkülönítés biztosításához.

  • 400 FailoverGroupDoesNotExist – A feladatátvételi csoport nem létezik egy kiszolgálón.

  • 400 Feladatátvételi csoportNotSecondary – Feladatátvétel nem kezdeményezhető a feladatátvételi csoport elsődleges kiszolgálójáról.

  • 400 InvalidServerName – Érvénytelen kiszolgálónév van megadva.

  • 400 DatabaseInFailoverGroupNotPrimary – Az adatbázis geoDR-hivatkozása már létezik, de a szerepköre nem elsődleges, vagy nem folyamatos másolási hivatkozás.

  • 400 SecurityAdalPrincipalCertExpiredError – A művelet nem hajtható végre, mert az Azure Key Vault főtanúsítvány lejárt.

  • 400 UnableToCreateFailoverGroupDueToTableAuditing – A feladatátvételi csoport nem hozható létre olyan kiszolgálóhoz, amelyen be van kapcsolva a táblanaplózás.

  • 400 InvalidIdentifier – Az azonosító NULL értéket vagy érvénytelen Unicode-karaktert tartalmaz.

  • 400 UnableToAddDbWithTableAuditingToFailoverGroup – A táblanaplózást engedélyező adatbázis nem lesz elérhető a feladatátvételi csoport végponton keresztül.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel – A megadott Key Vault uri érvénytelen.

  • 400 KeyMaterialNotFoundOnRemoteServer – A távoli kiszolgáló nem rendelkezik hozzáféréssel a TDE-védőként használt kulcsanyagokhoz.

  • 400 LimitOfFailoverGroupsPerServerExceeded – Az új feladatátvételi csoport létrehozása meghaladja a kiszolgálónként engedélyezett feladatátvételi csoportok számát.

  • 400 SameKeyUriNotFoundOnRemoteServer – A másodlagos kiszolgáló nem rendelkezik a kulcs anyagával ugyanabból a kulcstartóból, mint az elsődleges kiszolgáló titkosítási védője, és a kulcs automatikus elforgatása engedélyezve van.

  • 400 AzureKeyVaultRsaKeyNotSupported – A megadott kulcstartó nem támogatott RSA-kulcsméretet vagy kulcstípust használ. A támogatott RSA-kulcs mérete 2048 vagy 3072, a kulcstípus pedig RSA vagy RSA-HSM.

  • 400 SameKeyMaterialNotFoundOnRemoteServer – A másodlagos kiszolgáló nem rendelkezik az elsődleges kiszolgáló titkosítási védőjének kulcsanyagával.

  • 400 GeoReplicationDatabaseNotSecondary – A művelet azt várja, hogy az adatbázis replikációs cél legyen.

  • 400 GeoReplicaLimitReached – Elérte a replikánkénti replikáció korlátját.

  • 400 Feladatátvételi csoportWithVirtualNetworkRulesNotSupported – Az automatikus feladatátvételi szabályzattal konfigurált feladatátvételi csoportok jelenleg nem támogatottak a virtuális hálózati tűzfalszabályokkal konfigurált kiszolgálókon. Konfigurálja a feladatátvételi csoportot manuális feladatátvételi szabályzattal.

  • 400 UnableToResolveRemoteServer – A távoli partnerkiszolgáló neve érvénytelen kiszolgálónév vagy DNS-kapcsolati problémák miatt nem oldható meg.

  • 400 RemoteDatabaseCopyPermission – A felhasználó nem rendelkezik elegendő engedéllyel ahhoz, hogy adatbázis-másolatot hozzon létre a megadott kiszolgálón.

  • 400 SecurityAzureKeyVaultGeoChainError – A másodlagos (láncolásnak nevezett) folyamat másodlagos létrehozása nem támogatott az Transzparens adattitkosítás engedélyezésekor az Azure Key Vault (BYOK) használatával.

  • 404 ResourceNotFound – A kért erőforrás nem található.

  • 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben.

  • 404 ServerNotInSubscription – A megadott kiszolgáló nem létezik a megadott előfizetésben.

  • 404 SourceDatabaseNotFound – A forrásadatbázis nem létezik.

  • 405 Nem támogatottReplicationOperation – Nem támogatott replikációs művelet indult el az adatbázisban.

  • 409 ConflictingServerOperation – Folyamatban van egy művelet a kiszolgálóhoz.

  • 409 SubscriptionDisabled – Az előfizetés le van tiltva.

  • 409 ConflictingSystemOperationInProgress – Rendszerkarbantartási művelet van folyamatban az adatbázisban, és a további műveleteknek meg kell várniuk, amíg befejeződik.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo – A felhasználó feladatátvételt kísérelt meg vagy kényszerítetten leállított egy geohivatkozást, miközben a másodlagos olyan állapotban van, ahol fizikailag nem konzisztens, ezért nem tud belépni az elsődleges szerepkörbe.

  • 409 ServerKeyNameAlreadyExists – A kiszolgálókulcs már létezik a kiszolgálón.

  • 409 ServerKeyUriAlreadyExists – A kiszolgálókulcs URI-ja már létezik a kiszolgálón.

  • 409 ServerKeyDoesNotExists – A kiszolgálókulcs nem létezik.

  • 409 UpdateSloInProgress – A felhasználó inkompatibilis műveletet próbált kezdeményezni, miközben SLO-frissítés volt folyamatban.

  • 409 AzureKeyVaultKeyNameNotFound – A művelet nem hajtható végre, mert az Azure Key Vault kulcsneve nem létezik.

  • 409 AzureKeyVaultKeyInUse – A kulcsot jelenleg a kiszolgáló használja.

  • 409 Feladatátvételi csoportAlreadyExists – A feladatátvételi csoport már létezik egy adott kiszolgálón. Használjon másik feladatátvételi csoportnevet.

  • 409 FailoverGroupBusy – A feladatátvételi csoport egy másik művelettel van elfoglalva.

  • 409 DatabaseBelongsToOtherFailoverGroup – Az adatbázis más feladatátvételi csoporthoz tartozik, és nem tekinthető ennek a csoportnak.

  • 409 DatabaseBeingAddedToFailoverGroup – Az adatbázis jelenleg a feladatátvételi csoporthoz van hozzáadva, az ügyfélnek meg kell várnia, amíg a művelet befejeződik az eltávolítással.

  • 409 DatabaseBeingRemovedFromFailoverGroup – Az adatbázist jelenleg eltávolítják a feladatátvételi csoportból, az ügyfélnek meg kell várnia, amíg a művelet befejeződik a hozzáadás kiadásához.

  • 409 FailoverGroupDnsRecordInUse – A kért végponthoz duplikált DNS-rekord tartozik.

  • 409 InvalidFailoverGroupName – Érvénytelen feladatátvételi csoportnév lett megadva.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – Replikációs magolási műveletet hajtottak végre egy olyan adatbázison, amely már replikációs kapcsolatban van.

  • 409 InvalidDatabaseStateForOperation – A művelet nem engedélyezett az adatbázis jelenlegi replikációs állapotában.

  • 409 DuplicateGeoDrRelation – Az adatbázisok már replikációs kapcsolatban vannak. Ez egy duplikált kérés.

  • 409 RemoteDatabaseExists – A céladatbázis neve már létezik a célkiszolgálón.

  • 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

  • 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

  • 503 AzureKeyVaultConnectionFailed – A művelet nem hajtható végre a kiszolgálón, mert nem sikerült csatlakozni az Azure Key Vault

  • 503 AzureKeyVaultGenericConnectionError – A művelet nem hajtható végre, mert hiba történt Key Vault információ lekérésekor.

  • 503 DatabaseUnavailable – A művelet meghiúsult, mert az adatbázis nem érhető el.

  • 504 RequestTimeout – A szolgáltatáskérés túllépte az engedélyezett időtúllépést.

Példák

Get failover group

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test?api-version=2021-11-01

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test",
  "name": "failover-group-test",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan East",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "databases": []
  }
}

Definíciók

Name Description
FailoverGroup

Feladatátvételi csoport.

FailoverGroupReadOnlyEndpoint

A feladatátvételi csoportpéldány írásvédett végpontja.

FailoverGroupReadWriteEndpoint

A feladatátvételi csoportpéldány írási-olvasási végpontja.

FailoverGroupReplicationRole

A feladatátvételi csoportpéldány helyi replikációs szerepköre.

PartnerInfo

Partnerkiszolgáló adatai a feladatátvételi csoporthoz.

ReadOnlyEndpointFailoverPolicy

A feladatátvételi csoport írásvédett végpontjának feladatátvételi szabályzata.

ReadWriteEndpointFailoverPolicy

A feladatátvételi csoport írási-olvasási végpontjának feladatátvételi szabályzata. Ha a feladatátvételPolicy automatikus, akkor a feladatátvételWithDataLossGracePeriodMinutes szükséges.

FailoverGroup

Feladatátvételi csoport.

Name Típus Description
id

string

Erőforrás-azonosító.

location

string

Erőforrás helye.

name

string

Erőforrás neve.

properties.databases

string[]

A feladatátvételi csoportban lévő adatbázisok listája.

properties.partnerServers

PartnerInfo[]

A feladatátvételi csoport partnerkiszolgálói adatainak listája.

properties.readOnlyEndpoint

FailoverGroupReadOnlyEndpoint

A feladatátvételi csoportpéldány írásvédett végpontja.

properties.readWriteEndpoint

FailoverGroupReadWriteEndpoint

A feladatátvételi csoportpéldány írási-olvasási végpontja.

properties.replicationRole

FailoverGroupReplicationRole

A feladatátvételi csoportpéldány helyi replikációs szerepköre.

properties.replicationState

string

A feladatátvételi csoportpéldány replikációs állapota.

tags

object

Erőforráscímkék.

type

string

Erőforrástípus.

FailoverGroupReadOnlyEndpoint

A feladatátvételi csoportpéldány írásvédett végpontja.

Name Típus Description
failoverPolicy

ReadOnlyEndpointFailoverPolicy

A feladatátvételi csoport írásvédett végpontjának feladatátvételi szabályzata.

FailoverGroupReadWriteEndpoint

A feladatátvételi csoportpéldány írási-olvasási végpontja.

Name Típus Description
failoverPolicy

ReadWriteEndpointFailoverPolicy

A feladatátvételi csoport írási-olvasási végpontjának feladatátvételi szabályzata. Ha a feladatátvételPolicy automatikus, akkor a feladatátvételWithDataLossGracePeriodMinutes szükséges.

failoverWithDataLossGracePeriodMinutes

integer

Türelmi időszak az adatvesztéssel járó feladatátvétel előtt az olvasási-írási végponton. Ha a feladatátvételPolicy automatikus, akkor a feladatátvételWithDataLossGracePeriodMinutes szükséges.

FailoverGroupReplicationRole

A feladatátvételi csoportpéldány helyi replikációs szerepköre.

Name Típus Description
Primary

string

Secondary

string

PartnerInfo

Partnerkiszolgáló adatai a feladatátvételi csoporthoz.

Name Típus Description
id

string

A partnerkiszolgáló erőforrás-azonosítója.

location

string

A partnerkiszolgáló földrajzi helye.

replicationRole

FailoverGroupReplicationRole

A partnerkiszolgáló replikációs szerepköre.

ReadOnlyEndpointFailoverPolicy

A feladatátvételi csoport írásvédett végpontjának feladatátvételi szabályzata.

Name Típus Description
Disabled

string

Enabled

string

ReadWriteEndpointFailoverPolicy

A feladatátvételi csoport írási-olvasási végpontjának feladatátvételi szabályzata. Ha a feladatátvételPolicy automatikus, akkor a feladatátvételWithDataLossGracePeriodMinutes szükséges.

Name Típus Description
Automatic

string

Manual

string