Freigeben über

Databases - Force Link To Replication Group

  • Referenz
Dienst:
Redis Cache
API-Version:
2024-10-01

Erstellt eine vorhandene Datenbank im angegebenen Cluster forcibly neu und wird erneut an einer vorhandenen Replikationsgruppe teilnehmen. WICHTIGER HINWEIS: Alle Daten in dieser Datenbank werden verworfen, und die Datenbank ist vorübergehend nicht verfügbar, während Sie die Replikationsgruppe erneut verknüpfen.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}/forceLinkToReplicationGroup?api-version=2024-10-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
clusterName
 path True

string

Der Name des Redis Enterprise-Clusters. Der Name muss 1 bis 60 Zeichen lang sein. Zulässige Zeichen (A-Z, a-z, 0-9) und Bindestrich(-). Es kann weder führende noch nachfolgende Bindestriche oder aufeinander folgende Bindestriche geben.

RegEx-Muster: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$
databaseName
 path True

string

Der Name der Redis Enterprise-Datenbank.

RegEx-Muster: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$
resourceGroupName
 path True

string

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId
 path True

string

Die ID des Zielabonnements.
api-version
 query True

string

Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
groupNickname True

string

Der Name der Gruppe der verknüpften Datenbankressourcen. Dies sollte mit dem namen der vorhandenen Replikationsgruppe übereinstimmen.
linkedDatabases True

LinkedDatabase[]

Die Ressourcen-IDs der Datenbanken, die voraussichtlich verknüpft und in der Replikationsgruppe enthalten sind. Dieser Parameter wird verwendet, um zu überprüfen, ob die Verknüpfung mit dem erwarteten (nicht verknüpften) Teil der Replikationsgruppe ist, wenn sie geplintert wird.

Antworten

Name Typ Beschreibung
202 Accepted

Verknüpfungsvorgang erfolgreich erzwingen; Folgen Sie der kopfzeile Azure-AsyncOperation, um das endgültige Ergebnis abzufragen.

Header

  • Location: string
  • Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Beispielanforderung

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default/forceLinkToReplicationGroup?api-version=2024-10-01

{
  "groupNickname": "groupName",
  "linkedDatabases": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default"
    },
    {
      "id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg2/providers/Microsoft.Cache/redisEnterprise/cache2/databases/default"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:
202 
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Cache/...pathToOperationStatus...

Definitionen

Name Beschreibung
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail

Das Fehlerdetails.
ErrorResponse

Fehlerantwort
ForceLinkParameters

Parameter für die Neukonfiguration der aktiven Georeplikation einer vorhandenen Datenbank, die zuvor von einer Replikationsgruppe getrennt wurde.
LinkedDatabase

Verknüpfte Datenbank
LinkState

Der Status der Verknüpfung zwischen den Datenbankressourcen.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.
type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.
code

string

Der Fehlercode.
details

ErrorDetail[]

Die Fehlerdetails.
message

string

Die Fehlermeldung.
target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

ForceLinkParameters

Parameter für die Neukonfiguration der aktiven Georeplikation einer vorhandenen Datenbank, die zuvor von einer Replikationsgruppe getrennt wurde.

Name Typ Beschreibung
groupNickname

string

Der Name der Gruppe der verknüpften Datenbankressourcen. Dies sollte mit dem namen der vorhandenen Replikationsgruppe übereinstimmen.
linkedDatabases

LinkedDatabase[]

Die Ressourcen-IDs der Datenbanken, die voraussichtlich verknüpft und in der Replikationsgruppe enthalten sind. Dieser Parameter wird verwendet, um zu überprüfen, ob die Verknüpfung mit dem erwarteten (nicht verknüpften) Teil der Replikationsgruppe ist, wenn sie geplintert wird.

LinkedDatabase

Verknüpfte Datenbank

Name Typ Beschreibung
id

string

Ressourcen-ID einer Datenbankressource, die mit dieser Datenbank verknüpft werden soll.
state

LinkState

Der Status der Verknüpfung zwischen den Datenbankressourcen.

LinkState

Der Status der Verknüpfung zwischen den Datenbankressourcen.

Name Typ Beschreibung
LinkFailed

string

Linked

string

Linking

string

UnlinkFailed

string

Unlinking

string