Condividi tramite

Databases - Force Link To Replication Group

  • Riferimento
Servizio:
Redis Cache
Versione API:
2024-10-01

Ricrea forzatamente un database esistente nel cluster specificato e lo rielabora a un gruppo di replica esistente. NOTA IMPORTANTE: Tutti i dati in questo database verranno eliminati e il database non sarà temporaneamente disponibile durante la ricongiuzione del gruppo di replica.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
clusterName
 path True

string

Nome del cluster Redis Enterprise. Il nome deve avere una lunghezza di 1-60 caratteri. Caratteri consentiti (A-Z, a-z, 0-9) e trattino (-). Non ci possono essere trattini iniziali né finali né consecutivi

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

string

Nome del database Redis Enterprise.

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

string

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId
 path True

string

ID della sottoscrizione di destinazione.
api-version
 query True

string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Necessario Tipo Descrizione
geoReplication True

GeoReplication

Proprietà per configurare la replica geografica per questo database.

Risposte

Nome Tipo Descrizione
202 Accepted

Forzare l'operazione di collegamento accodato; seguire l'intestazione Azure-AsyncOperation per eseguire il polling del risultato finale.

Intestazioni

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

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Esempio di richiesta

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

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

Risposta di esempio

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

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail

Dettagli dell'errore.
ErrorResponse

Risposta di errore
ForceLinkParameters

Parametri per la riconfigurazione della replica geografica attiva, di un database esistente precedentemente scollegato da un gruppo di replica.
GeoReplication

Set facoltativo di proprietà per configurare la replica geografica per questo database.
LinkedDatabase

Database collegato
LinkState

Stato del collegamento tra le risorse del database.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.
code

string

Codice di errore.
details

ErrorDetail[]

Dettagli dell'errore.
message

string

Messaggio di errore.
target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

ForceLinkParameters

Parametri per la riconfigurazione della replica geografica attiva, di un database esistente precedentemente scollegato da un gruppo di replica.

Nome Tipo Descrizione
geoReplication

GeoReplication

Proprietà per configurare la replica geografica per questo database.

GeoReplication

Set facoltativo di proprietà per configurare la replica geografica per questo database.

Nome Tipo Descrizione
groupNickname

string

Nome del gruppo di risorse del database collegato
linkedDatabases

LinkedDatabase[]

Elenco di risorse del database da collegare a questo database

LinkedDatabase

Database collegato

Nome Tipo Descrizione
id

string

ID risorsa di una risorsa di database da collegare al database.
state

LinkState

Stato del collegamento tra le risorse del database.

LinkState

Stato del collegamento tra le risorse del database.

Nome Tipo Descrizione
LinkFailed

string

Linked

string

Linking

string

UnlinkFailed

string

Unlinking

string