Compartilhar via

Databases - Force Link To Replication Group

  • Referência
Serviço:
Redis Cache
Versão da API:
2024-10-01

Recria à força um banco de dados existente no cluster especificado e o reencontra em um grupo de replicação existente. OBSERVAÇÃO IMPORTANTE: Todos os dados neste banco de dados serão descartados e o banco de dados ficará temporariamente indisponível ao reencontrar o grupo de replicação.

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 URI

Nome Em Obrigatório Tipo Description
clusterName
 path True

string

O nome do cluster Redis Enterprise. O nome deve ter de 1 a 60 caracteres. Caracteres permitidos (A-Z, a-z, 0-9) e hifen(-). Não pode haver hífens à esquerda nem à direita nem consecutivos

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

string

O nome do banco de dados Redis Enterprise.

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

string

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId
 path True

string

A ID da assinatura de destino.
api-version
 query True

string

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Obrigatório Tipo Description
groupNickname True

string

O nome do grupo de recursos de banco de dados vinculados. Isso deve corresponder ao nome do grupo de replicação existente.
linkedDatabases True

LinkedDatabase[]

As IDs de recurso dos bancos de dados que devem ser vinculados e incluídos no grupo de replicação. Esse parâmetro é usado para validar que a vinculação é para a parte esperada (desvinculada) do grupo de replicação, se for fragmentada.

Respostas

Nome Tipo Description
202 Accepted

Forçar operação de link enfileirada com êxito; siga o cabeçalho Azure-AsyncOperation para sondar o resultado final.

Cabeçalhos

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

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
202 
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Cache/...pathToOperationStatus...

Definições

Nome Description
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta de erro
ForceLinkParameters

Parâmetros para reconfigurar a replicação geográfica ativa de um banco de dados existente que foi desvinculado anteriormente de um grupo de replicação.
LinkedDatabase

Banco de dados vinculado
LinkState

Estado do link entre os recursos do banco de dados.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

ForceLinkParameters

Parâmetros para reconfigurar a replicação geográfica ativa de um banco de dados existente que foi desvinculado anteriormente de um grupo de replicação.

Nome Tipo Description
groupNickname

string

O nome do grupo de recursos de banco de dados vinculados. Isso deve corresponder ao nome do grupo de replicação existente.
linkedDatabases

LinkedDatabase[]

As IDs de recurso dos bancos de dados que devem ser vinculados e incluídos no grupo de replicação. Esse parâmetro é usado para validar que a vinculação é para a parte esperada (desvinculada) do grupo de replicação, se for fragmentada.

LinkedDatabase

Banco de dados vinculado

Nome Tipo Description
id

string

ID de recurso de um recurso de banco de dados para vincular a esse banco de dados.
state

LinkState

Estado do link entre os recursos do banco de dados.

LinkState

Estado do link entre os recursos do banco de dados.

Nome Tipo Description
LinkFailed

string

Linked

string

Linking

string

UnlinkFailed

string

Unlinking

string