Partager via

Databases - Force Link To Replication Group

  • Référence
Service:
Redis Cache
Version d'API:
2024-10-01

Recrée de force une base de données existante sur le cluster spécifié et la rejoint à un groupe de réplication existant. REMARQUE IMPORTANTE : toutes les données de cette base de données seront ignorées et la base de données sera temporairement indisponible lors de la jointion du groupe de réplication.

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

Paramètres URI

Nom Dans Obligatoire Type Description
clusterName
 path True

string

Nom du cluster Redis Enterprise. Le nom doit comporter 1 à 60 caractères. Caractères autorisés (A-Z, a-z, 0-9) et trait d’union(-). Il ne peut y avoir aucun trait d’union de début ni de fin ni de traits d’union consécutifs

Modèle d’expression régulière: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$
databaseName
 path True

string

Nom de la base de données Redis Enterprise.

Modèle d’expression régulière: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$
resourceGroupName
 path True

string

Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId
 path True

string

ID de l’abonnement cible.
api-version
 query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Obligatoire Type Description
groupNickname True

string

Nom du groupe de ressources de base de données liées. Cela doit correspondre au nom du groupe de réplication existant.
linkedDatabases True

LinkedDatabase[]

ID de ressources des bases de données censées être liées et incluses dans le groupe de réplication. Ce paramètre est utilisé pour vérifier que la liaison est à la partie attendue (non lié) du groupe de réplication, si elle est éplinterée.

Réponses

Nom Type Description
202 Accepted

Forcer l’opération de liaison correctement mise en file d’attente ; suivez l’en-tête Azure-AsyncOperation pour interroger le résultat final.

En-têtes

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

ErrorResponse

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

Exemple de requête

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

Exemple de réponse

Code d’état:
202 
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Cache/...pathToOperationStatus...

Définitions

Nom Description
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail

Détail de l’erreur.
ErrorResponse

Réponse d’erreur
ForceLinkParameters

Paramètres de reconfiguration de la géoréplication active d’une base de données existante qui était précédemment dissociée d’un groupe de réplication.
LinkedDatabase

Base de données liée
LinkState

État du lien entre les ressources de base de données.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.
type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.
code

string

Code d’erreur.
details

ErrorDetail[]

Détails de l’erreur.
message

string

Message d’erreur.
target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

ForceLinkParameters

Paramètres de reconfiguration de la géoréplication active d’une base de données existante qui était précédemment dissociée d’un groupe de réplication.

Nom Type Description
groupNickname

string

Nom du groupe de ressources de base de données liées. Cela doit correspondre au nom du groupe de réplication existant.
linkedDatabases

LinkedDatabase[]

ID de ressources des bases de données censées être liées et incluses dans le groupe de réplication. Ce paramètre est utilisé pour vérifier que la liaison est à la partie attendue (non lié) du groupe de réplication, si elle est éplinterée.

LinkedDatabase

Base de données liée

Nom Type Description
id

string

ID de ressource d’une ressource de base de données à lier à cette base de données.
state

LinkState

État du lien entre les ressources de base de données.

LinkState

État du lien entre les ressources de base de données.

Nom Type Description
LinkFailed

string

Linked

string

Linking

string

UnlinkFailed

string

Unlinking

string