Databases - Force Link To Replication Group

Servicio:

Redis Cache

Versión de la API:

2024-10-01

Vuelve a crear una base de datos existente en el clúster especificado y la vuelve a unir a un grupo de replicación existente. NOTA IMPORTANTE: Se descartarán todos los datos de esta base de datos y la base de datos no estará disponible temporalmente al volver a unir el grupo de replicación.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
clusterName	path	True	string	Nombre del clúster de Redis Enterprise. El nombre debe tener entre 1 y 60 caracteres. Caracteres permitidos (A-Z, a-z, 0-9) y guion(-). No puede haber guiones iniciales ni finales ni consecutivos Patrón de Regex: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$
databaseName	path	True	string	Nombre de la base de datos de Redis Enterprise. Patrón de Regex: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$
resourceGroupName	path	True	string	Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
subscriptionId	path	True	string	Identificador de la suscripción de destino.
api-version	query	True	string	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
geoReplication	True	GeoReplication	Propiedades para configurar la replicación geográfica para esta base de datos.

Respuestas

Nombre	Tipo	Description
202 Accepted		Forzar operación de vínculo puesta en cola correctamente; siga el encabezado Azure-AsyncOperation para sondear el resultado final. Encabezados Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

How to relink a database after a regional outage

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:

202

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

Definiciones

Nombre	Description
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
ForceLinkParameters	Parámetros para volver a configurar la replicación geográfica activa, de una base de datos existente que se desvinculó previamente de un grupo de replicación.
GeoReplication	Conjunto opcional de propiedades para configurar la replicación geográfica para esta base de datos.
LinkedDatabase	Base de datos vinculada
LinkState	Estado del vínculo entre los recursos de la base de datos.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ForceLinkParameters

Parámetros para volver a configurar la replicación geográfica activa, de una base de datos existente que se desvinculó previamente de un grupo de replicación.

Nombre	Tipo	Description
geoReplication	GeoReplication	Propiedades para configurar la replicación geográfica para esta base de datos.

GeoReplication

Conjunto opcional de propiedades para configurar la replicación geográfica para esta base de datos.

Nombre	Tipo	Description
groupNickname	string	Nombre del grupo de recursos de base de datos vinculados
linkedDatabases	LinkedDatabase[]	Lista de recursos de base de datos para vincular con esta base de datos

LinkedDatabase

Base de datos vinculada

Nombre	Tipo	Description
id	string	Identificador de recurso de un recurso de base de datos que se va a vincular con esta base de datos.
state	LinkState	Estado del vínculo entre los recursos de la base de datos.

LinkState

Estado del vínculo entre los recursos de la base de datos.

Nombre	Tipo	Description
LinkFailed	string
Linked	string
Linking	string
UnlinkFailed	string
Unlinking	string