Delen via

Databases - Force Link To Replication Group

  • Referentie
Service:
Redis Cache
API-versie:
2024-10-01

Hiermee wordt een bestaande database op het opgegeven cluster geforceerd opnieuw gemaakt en opnieuw toegevoegd aan een bestaande replicatiegroep. BELANGRIJKE OPMERKING: Alle gegevens in deze database worden verwijderd en de database is tijdelijk niet beschikbaar tijdens het opnieuw deelnemen aan de replicatiegroep.

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

URI-parameters

Name In Vereist Type Description
clusterName
 path True

string

De naam van het Redis Enterprise-cluster. De naam moet 1 tot 60 tekens lang zijn. Toegestane tekens (A-Z, a-z, 0-9) en afbreekstreepje(-). Er kunnen geen voorloop- of volgstreepjes of opeenvolgende afbreekstreepjes zijn

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

string

De naam van de Redis Enterprise-database.

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

string

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
subscriptionId
 path True

string

De id van het doelabonnement.
api-version
 query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Vereist Type Description
geoReplication True

GeoReplication

Eigenschappen voor het configureren van geo-replicatie voor deze database.

Antwoorden

Name Type Description
202 Accepted

Geforceerde koppelingsbewerking is geforceerd; volg de Azure-AsyncOperation header om te peilen naar het uiteindelijke resultaat.

Kopteksten

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

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
ForceLinkParameters

Parameters voor het opnieuw configureren van actieve geo-replicatie van een bestaande database die eerder niet was gekoppeld vanuit een replicatiegroep.
GeoReplication

Optionele set eigenschappen voor het configureren van geo-replicatie voor deze database.
LinkedDatabase

Gekoppelde database
LinkState

Status van de koppeling tussen de databasebronnen.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ForceLinkParameters

Parameters voor het opnieuw configureren van actieve geo-replicatie van een bestaande database die eerder niet was gekoppeld vanuit een replicatiegroep.

Name Type Description
geoReplication

GeoReplication

Eigenschappen voor het configureren van geo-replicatie voor deze database.

GeoReplication

Optionele set eigenschappen voor het configureren van geo-replicatie voor deze database.

Name Type Description
groupNickname

string

Naam voor de groep gekoppelde databasebronnen
linkedDatabases

LinkedDatabase[]

Lijst met databasebronnen die u aan deze database wilt koppelen

LinkedDatabase

Gekoppelde database

Name Type Description
id

string

Resource-id van een databaseresource die moet worden gekoppeld aan deze database.
state

LinkState

Status van de koppeling tussen de databasebronnen.

LinkState

Status van de koppeling tussen de databasebronnen.

Name Type Description
LinkFailed

string

Linked

string

Linking

string

UnlinkFailed

string

Unlinking

string