Todos os produtos
Search
Central de documentação

Cloud Backup:UpgradeBackupClients

Última atualização: Jun 28, 2026

Atualiza um cliente HBR em uma ou mais instâncias do Elastic Compute Service (ECS).

Descrição da operação

  • Esta operação cria uma tarefa assíncrona no backend e chama o Cloud Assistant para atualizar um cliente HBR instalado em uma instância ECS.

  • Você pode chamar a operação DescribeTask para consultar o resultado da execução de uma tarefa assíncrona.

  • O tempo limite de uma tarefa assíncrona é de 15 minutos.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

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). O número total de IDs de instâncias ECS e IDs de clientes do Cloud Backup não pode exceder 100.

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

ClientIds

object

Não

Os IDs dos clientes do Cloud Backup. O número total de IDs de clientes do Cloud Backup e IDs de instâncias ECS não pode exceder 100.

["i-0xi5wj******3j3bh2gj5"]

CrossAccountType

string

Não

Especifica se o backup dos dados é realizado na mesma conta da Alibaba Cloud ou entre contas da Alibaba Cloud. Valores válidos:

  • SELF_ACCOUNT: O backup dos dados é realizado na mesma conta da Alibaba Cloud.

  • CROSS_ACCOUNT: O backup dos dados é realizado 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 realizar o backup de dados entre contas da Alibaba Cloud.

1283948272xxxxx

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 realizar o backup de dados entre contas da Alibaba Cloud.

hbrcrossrole

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 chamada foi bem-sucedida.

200

Message

string

A mensagem retornada. Se a chamada for bem-sucedida, "successful" será retornado. Se a chamada falhar, uma mensagem de erro será retornada.

successful

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

TaskId

string

O ID da tarefa assíncrona. Você pode chamar a operação DescribeTask para consultar o resultado da execução de uma tarefa assíncrona.

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

Success

boolean

Indica se a chamada foi bem-sucedida. Valores válidos:

  • true: A chamada foi bem-sucedida.

  • false: A chamada falhou.

true

InstanceStatuses

array<object>

O status das instâncias ECS. Se o status de uma instância ECS não atender aos requisitos para instalar um cliente HBR e o valor do parâmetro InstanceIds for maior que 1, uma mensagem de erro será retornada com base no valor deste parâmetro.

object

ValidInstance

boolean

Indica se um cliente HBR pode ser instalado na instância ECS. Valores válidos:

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

  • false: Um cliente HBR 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 retornado. Valores válidos:

  • Se o valor estiver vazio, a chamada 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.