Todos os produtos
Search
Central de documentação

Cloud Backup:UninstallBackupClients

Última atualização: Jun 28, 2026

Desinstala um cliente do Cloud Backup de uma ou mais instâncias do Elastic Compute Service (ECS).

Descrição da operação

  • Esta operação cria um trabalho assíncrono no back-end e chama o Cloud Assistant para desinstalar um cliente de backup de uma instância ECS.

  • Você pode chamar a operação DescribeTask para consultar o resultado da execução de um trabalho assíncrono.

  • O tempo limite de um trabalho assíncrono é de 15 minutos. Recomendamos que você chame a operação DescribeTask para executar a primeira consulta 30 segundos após chamar a operação UninstallBackupClients para desinstalar clientes de backup. Em seguida, execute as próximas consultas em um intervalo de 30 segundos.

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

hbr:UninstallBackupClients

update

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

InstanceIds

object

Não

Os IDs das instâncias do Elastic Compute Service (ECS). Você pode especificar no máximo 20 instâncias ECS.

["i-0xi5wj5*****v3j3bh2gj5"]

ClientIds

object

Não

Os IDs dos clientes do Cloud Backup. A soma do número de IDs de clientes do Cloud Backup e o número de IDs de instâncias ECS não pode exceder 20. Caso contrário, ocorrerá um erro.

["c-*********************"]

CrossAccountType

string

Não

Especifica se os dados são submetidos a backup e restaurados na mesma conta da Alibaba Cloud ou entre contas da Alibaba Cloud. Valores válidos:

  • SELF_ACCOUNT: Os dados são submetidos a backup e restaurados na mesma conta da Alibaba Cloud.

  • CROSS_ACCOUNT: Os dados são submetidos a backup e restaurados entre contas da Alibaba Cloud.

CROSS_ACCOUNT

CrossAccountUserId

integer

Não

O ID da conta de origem da Alibaba Cloud que autoriza a conta atual da Alibaba Cloud a fazer backup e restaurar dados entre contas da Alibaba Cloud.

129349237xxxxx

CrossAccountRoleName

string

Não

O nome da função RAM que é criada na conta de origem da Alibaba Cloud e atribuída à conta atual da Alibaba Cloud para autorizar a conta atual da Alibaba Cloud a fazer backup e restaurar dados entre contas da Alibaba Cloud.

BackupRole

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Code

string

O código de status HTTP. O código de status 200 indica que a solicitação foi bem-sucedida.

200

Message

string

A mensagem retornada. Se a solicitação for bem-sucedida, o valor successful será retornado. Se a solicitação falhar, uma mensagem de erro será retornada.

successful

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

TaskId

string

O ID do trabalho assíncrono. Você pode chamar a operação DescribeTask para consultar o resultado da execução do trabalho assíncrono.

t-*********************

Success

boolean

Indica se a solicitação foi bem-sucedida.

  • true: A solicitação foi bem-sucedida.

  • false: A solicitação falhou.

true

InstanceStatuses

array<object>

O status das instâncias ECS.

object

ValidInstance

boolean

Indica se um cliente de backup pode ser instalado na instância ECS.

  • true: Um cliente de backup pode ser instalado na instância ECS.

  • false: Um cliente de backup não pode ser instalado na instância ECS.

true

InstanceId

string

O ID da instância ECS.

i-0xi5w***v3j3bh2gj5

ErrorCode

string

O código de erro. Valores válidos:

  • Se o valor estiver vazio, a solicitação foi bem-sucedida.

  • InstanceNotExists: A instância ECS não existe.

  • InstanceNotRunning: A instância ECS não está em execução.

  • CloudAssistNotRunningOnInstance: O Cloud Assistant não está disponível.

InstanceNotExists

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TaskId": "t-*********************",
  "Success": true,
  "InstanceStatuses": [
    {
      "ValidInstance": true,
      "InstanceId": "i-0xi5w***v3j3bh2gj5",
      "ErrorCode": "InstanceNotExists"
    }
  ]
}

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.