Todos os produtos
Search

Este produto

    Tair (Redis® OSS-Compatible):MasterNodeShutDownFailOver

    Central de documentação

    Tair (Redis® OSS-Compatible):MasterNodeShutDownFailOver

    Última atualização: Oct 13, 2026

    Simula uma falha de um nó de dados ou nó de proxy especificado no Tair (compatível com Redis® OSS). A instância realiza automaticamente uma alternância primário/secundário para garantir a alta disponibilidade.

    Descrição da operação

    • Ao chamar esta operação, o nó especificado é desligado. A instância aciona automaticamente uma alternância primário/secundário para promover o nó secundário a nó primário.

    • O nó com a falha simulada se recupera automaticamente mais tarde.

    • Esta operação não é suportada para instâncias de nó único (réplica única).

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    kvstore:MasterNodeShutDownFailOver

    none

    *DBInstance

    acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    FailMode

    string

    Não

    • Hard: Simula uma falha de hardware irrecuperável. Uma alternância (HA) é acionada diretamente.

    • Soft (padrão): Simula uma falha de hardware recuperável. O sistema tenta prioritariamente recuperar o nó com falha. Se a recuperação falhar, uma alternância (HA) é acionada.

    Valores válidos:

    • UnSafe :

      Obsoleto.

    • Hard :

      Hard.

    • Safe :

      Obsoleto.

    • Soft :

      Soft.

    Hard
    DBNodes

    string

    Não

    Os nós de dados especificados.

    r-rdsdavinx01003-db-0,r-rdsdavinx01003-db-1
    ProxyInstanceIds

    string

    Não

    Os nós de proxy especificados.

    6981,6982
    ProxyFaultMode

    string

    Não

    • Specify: Especifica os nós de proxy.

    • Random: O sistema simula aleatoriamente uma falha para um quarto dos nós de proxy (arredondado para cima para o inteiro mais próximo, com um mínimo de 1). Este parâmetro entra em vigor apenas quando nenhum nó de proxy é especificado.

    Valores válidos:

    • Specify :

      Especifica nós de proxy.

    • Random :

      Seleciona nós de proxy aleatoriamente.

    Specify
    DBFaultMode

    string

    Não

    • Specify: Especifica os nós de dados.

    • Random: O sistema simula aleatoriamente uma falha para um quarto dos nós de dados (arredondado para cima para o inteiro mais próximo, com um mínimo de 1). Este parâmetro entra em vigor apenas quando nenhum nó de dados é especificado.

    Valores válidos:

    • Specify :

      Especifica nós de dados.

    • Random :

      Seleciona nós de dados aleatoriamente.

    Random
    InstanceId

    string

    Não

    O ID da instância. Você pode chamar a operação DescribeInstances para consultar o ID da instância.

    r-bp1zxszhcgatnx****
    Category

    string

    Não

    O tipo de recurso. Defina o valor como instance.

    instance

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    A resposta da operação de simulação.

    RequestId

    string

    O ID da solicitação.

    12123216-4B00-4378-BE4B-08005BFC****
    DBInstanceId

    string

    O ID da instância.

    r-bp1zxszhcgatnx****
    TaskID

    string

    O ID da tarefa.

    17566

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "12123216-4B00-4378-BE4B-08005BFC****",
  "DBInstanceId": "r-bp1zxszhcgatnx****",
  "TaskID": "17566"
}

    Códigos de erro

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.