Megosztás a következőn keresztül:


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=2023-08-01

URI paraméterek

Név Ban Szükséges Típus Leírás
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

Név Típus Leírás
200 OK

FailoverGroup

Sikeresen lekérte a megadott feladatátvételi csoportot.

Other Status Codes

ErrorResponse

Hibaválaszok: ***

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases – A megadott adatbázisazonosí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 csoportCreateOrUpdateRequestInvalidPartner – A feladatátvételi csoport kérésének törzsében 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ákat https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner – 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 partnerkiszolgáló egyedi.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer – A megadott adatbázisok közül legalább egy 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 az elsődleges kiszolgálón található.

  • 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – 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 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint – A readWriteEndpoint mező szükséges a kérések létrehozásához vagy frissítéséhez.

  • 400 FailoverGroupCreateOrUpdateRequestInvalid – A feladatátvételi csoport kérésének törzse üres vagy érvénytelen.

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

  • 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – 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 nagyobb vagy egyenlő a "{0}' perc minimális türelmi időszaká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 írás-olvasás végponthoz.

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

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

  • 400 Feladatátvételi csoportCreateOrUpdateRequestReadOnlyPropertyModified – A feladatátvételi csoport kérésének törzse nem módosíthatja az írásvédett tulajdonság{0}' tulajdonságát.

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

  • 400 FailoverGroupPartnerServerFromDifferentSubscription – 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 FailoverGroupCreateOrUpdateRequestInvalidReadOnlyEndpointTargetServer – A csak olvasható végpont tulajdonságkiszolgálójának érvényes kiszolgálónak kell lennie a feladatátvételi csoporthoz konfigurált partnerKiszolgálók között.

  • 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCountForStandby – A secondaryType készenléti állapothoz csak egy partnerkiszolgáló támogatott a feladatátvételi csoporthoz. Ennek megfelelően módosítsa a kérést.

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

  • 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 jogkivonat túl hosszú.

  • 400 InvalidTargetSubregion – Egy nem olvasható másodlagos célkiszolgáló 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 másolni egy Sterling-kiszolgálóra, vagy fordítva.

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

  • 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 értéke null értékű vagy üres.

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

  • 400 AzureKeyVaultInvalidUri – Érvénytelen válasz az Azure Key Vaulttól. Használjon érvényes Azure Key Vault URI-t.

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

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

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

  • 400 PlannedFailoverTimedOut – A felhasználó meghívta a tervezett feladatátvételt, é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 hiba történt az Azure Active Directoryban.

  • 400 AdalServicePrincipalNotFound – A művelet nem hajtható végre, mert egy Azure Active Directory-kódtár szolgáltatásnév nem talált hibát.

  • 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 kiszolgálón.

  • 400 FailoverGroupNotSecondary – Feladatátvétel nem kezdeményezhető 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ánya 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 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égpontjával.

  • 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-kulcsméret 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ós korlátot.

  • 400 FailoverGroupWithVirtualNetworkRulesNotSupported – 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 Azure Key Vault (BYOK) használatával történő engedélyezésekor.

  • 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 UnsupportedReplicationOperation – Nem támogatott replikációs művelet lett elindítva az adatbázisban.

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

  • 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 várniuk kell, 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, míg a másodlagos olyan állapotban van, ahol fizikailag nem konzisztens, ezért nem léphet be 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 FailoverGroupAlreadyExists – A feladatátvételi csoport már létezik egy adott kiszolgálón. Használjon más 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 várnia kell, amíg a művelet befejeződik az eltávolítással.

  • 409 DatabaseBeingRemovedFromFailoverGroup – Az adatbázis jelenleg el van távolítva a feladatátvételi csoportból, az ügyfélnek meg kell várnia, amíg a művelet befejeződik a hozzáadással.

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

  • 409 InvalidFailoverGroupName – Érvénytelen feladatátvételi csoport neve lett megadva.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – Replikációs műveletet hajtottak végre egy olyan adatbázisban, amely nincs replikációs kapcsolatban.

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

  • 409 DuplicateGeoDrRelation – Az adatbázisok már replikációs kapcsolatban vannak. Ez egy ismétlődő 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éréseken túli kérések.

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható kérelmek maximálisnál több kérése.

  • 503 TooManyRequests – A rendelkezésre álló 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 sikertelen volt az Azure Key Vaulthoz való kapcsolódási kísérlet

  • 503 AzureKeyVaultGenericConnectionError – A művelet nem hajtható végre, mert hiba történt a Key Vault adatainak 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 a megengedett időtúllépést.

Példák

Get failover group

Mintakérés

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver/failoverGroups/failovergrouptest3?api-version=2023-08-01

Mintaválasz

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver/failoverGroups/failovergrouptest3",
  "name": "failovergrouptest3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan West",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 120
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Enabled",
      "targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver",
        "location": "Japan East",
        "replicationRole": "Secondary"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver/databases/testdb1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver/databases/testdb2"
    ]
  }
}

Meghatározások

Név Leírás
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

FailoverGroup

Feladatátvételi csoport.

FailoverGroupDatabasesSecondaryType

Másodlagos típusú adatbázisok a partnerkiszolgálón.

FailoverGroupReadOnlyEndpoint

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

FailoverGroupReadWriteEndpoint

A feladatátvételi csoportpéldány olvasási-írá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 olvasási-írási végpontjának feladatátvételi szabályzata. Ha a feladatátvételi házirend automatikus, akkor a feladatátvételWithDataLossGracePeriodMinutes szükséges.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Név Típus Leírás
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Név Típus Leírás
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Név Típus Leírás
error

ErrorDetail

A hibaobjektum.

FailoverGroup

Feladatátvételi csoport.

Név Típus Leírás
id

string

Erőforrás-azonosító.

location

string

Erőforrás helye.

name

string

Erőforrás neve.

properties.databases

string[] (arm-id)

A feladatátvételi csoport adatbázisainak 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 olvasási-írá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.

properties.secondaryType

FailoverGroupDatabasesSecondaryType

Másodlagos típusú adatbázisok a partnerkiszolgálón.

tags

object

Erőforráscímkék.

type

string

Erőforrás típusa.

FailoverGroupDatabasesSecondaryType

Másodlagos típusú adatbázisok a partnerkiszolgálón.

Érték Leírás
Geo
Standby

FailoverGroupReadOnlyEndpoint

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

Név Típus Leírás
failoverPolicy

ReadOnlyEndpointFailoverPolicy

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

targetServer

string (arm-id)

A célpartner-kiszolgáló, amelyre az írásvédett végpont mutat.

FailoverGroupReadWriteEndpoint

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

Név Típus Leírás
failoverPolicy

ReadWriteEndpointFailoverPolicy

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

failoverWithDataLossGracePeriodMinutes

integer (int32)

Az olvasási-írási végpont esetében a feladatátvételt megelőző türelmi időszak adatvesztéssel történik. Ha a feladatátvételi házirend automatikus, akkor a feladatátvételWithDataLossGracePeriodMinutes szükséges.

FailoverGroupReplicationRole

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

Érték Leírás
Primary
Secondary

PartnerInfo

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

Név Típus Leírás
id

string (arm-id)

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.

Érték Leírás
Disabled
Enabled

ReadWriteEndpointFailoverPolicy

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

Érték Leírás
Manual
Automatic