All Products
Search
Document Center

Cloud Backup:UpgradeBackupClients

Last Updated:Jun 11, 2026

Meningkatkan klien HBR pada satu atau beberapa Instance ECS.

Deskripsi operasi

  • This operation creates an asynchronous job at the backend and calls Cloud Assistant to upgrade an HBR client that is installed on an ECS instance.

  • You can call the DescribeTask operation to query the execution result of an asynchronous job.

  • The timeout period of an asynchronous job is 15 minutes.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

InstanceIds

object

No

ID Instance ECS. Jumlah total ID Instance ECS dan ID Klien Cloud Backup tidak boleh melebihi 100.

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

ClientIds

object

No

ID Klien Cloud Backup. Jumlah total ID Klien Cloud Backup dan ID Instance ECS tidak boleh melebihi 100.

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

CrossAccountType

string

No

Apakah data akan dicadangkan dalam satu akun Alibaba Cloud yang sama atau lintas akun Alibaba Cloud. Nilai valid:

  • SELF_ACCOUNT: Data dicadangkan dalam satu akun Alibaba Cloud yang sama.

  • CROSS_ACCOUNT: Data dicadangkan lintas akun Alibaba Cloud.

CROSS_ACCOUNT

CrossAccountUserId

integer

No

ID akun Alibaba Cloud sumber yang mengotorisasi akun Alibaba Cloud saat ini untuk mencadangkan data lintas akun Alibaba Cloud.

1283948272xxxxx

CrossAccountRoleName

string

No

Nama Peran RAM yang dibuat dalam akun Alibaba Cloud sumber dan ditetapkan ke akun Alibaba Cloud saat ini untuk mengotorisasi akun Alibaba Cloud saat ini mencadangkan data lintas akun Alibaba Cloud.

hbrcrossrole

Elemen respons

Element

Type

Description

Example

object

Code

string

The HTTP status code. The status code 200 indicates that the call is successful.

200

Message

string

The message that is returned. If the call is successful, "successful" is returned. If the call fails, an error message is returned.

successful

RequestId

string

The ID of the request.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

TaskId

string

The ID of the asynchronous job. You can call the DescribeTask operation to query the execution result of an asynchronous job.

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

Success

boolean

Indicates whether the call is successful. Valid values:

  • true: The call is successful.

  • false: The call fails.

true

InstanceStatuses

array<object>

The status of the ECS instance. If the status of an ECS instance cannot meet the requirements to install an HBR client and the value of the InstanceIds parameter is greater than 1, an error message is returned based on the value of this parameter.

object

ValidInstance

boolean

Indicates whether an HBR client can be installed on the ECS instance. Valid values:

  • true: An HBR client can be installed on the ECS instance.

  • false: An HBR client cannot be installed on the ECS instance.

true

InstanceId

string

The ID of the ECS instance.

i-0xi5w***v3j3bh2gj5

ErrorCode

string

The error code that is returned. Valid values:

  • If the value is empty, the call is successful.

  • InstanceNotExists: The ECS instance does not exist.

  • InstanceNotRunning: The ECS instance is not running.

  • CloudAssistNotRunningOnInstance: Cloud Assistant is unavailable.

InstanceNotExists

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.