Tous les produits
Search
Centre de documentation

:UpgradeBackupClients

Dernière mise à jour :Aug 07, 2026

Met à niveau un client HBR sur une ou plusieurs instances Elastic Compute Service (ECS).

Description de l'opération

  • Cette opération crée une tâche asynchrone en arrière-plan et appelle Cloud Assistant pour mettre à niveau un client HBR installé sur une instance ECS.

  • Vous pouvez appeler l'opération DescribeTask pour interroger le résultat d'exécution d'une tâche asynchrone.

  • Le délai d'expiration d'une tâche asynchrone est de 15 minutes.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

InstanceIds

object

Non

Les identifiants des instances Elastic Compute Service (ECS). Le nombre total d'identifiants d'instances ECS et d'identifiants de clients Cloud Backup ne peut pas dépasser 100.

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

ClientIds

object

Non

Les identifiants des clients Cloud Backup. Le nombre total d'identifiants de clients Cloud Backup et d'identifiants d'instances ECS ne peut pas dépasser 100.

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

CrossAccountType

string

Non

Indique si les données sont sauvegardées au sein du même compte Alibaba Cloud ou entre plusieurs comptes Alibaba Cloud. Valeurs valides :

  • SELF_ACCOUNT : Les données sont sauvegardées au sein du même compte Alibaba Cloud.

  • CROSS_ACCOUNT : Les données sont sauvegardées entre plusieurs comptes Alibaba Cloud.

CROSS_ACCOUNT

CrossAccountUserId

integer

Non

L'identifiant du compte Alibaba Cloud source qui autorise le compte Alibaba Cloud actuel à sauvegarder des données entre plusieurs comptes Alibaba Cloud.

1283948272xxxxx

CrossAccountRoleName

string

Non

Le nom du rôle RAM créé au sein du compte Alibaba Cloud source et attribué au compte Alibaba Cloud actuel pour autoriser ce dernier à sauvegarder des données entre plusieurs comptes Alibaba Cloud.

hbrcrossrole

Éléments de réponse

Élément

Type

Description

Exemple

object

Code

string

Le code d'état HTTP. Le code d'état 200 indique que l'appel a réussi.

200

Message

string

Le message renvoyé. Si l'appel réussit, « successful » est renvoyé. Si l'appel échoue, un message d'erreur est renvoyé.

successful

RequestId

string

L'identifiant de la requête.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

TaskId

string

L'identifiant de la tâche asynchrone. Vous pouvez appeler l'opération DescribeTask pour interroger le résultat d'exécution d'une tâche asynchrone.

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

Success

boolean

Indique si l'appel a réussi. Valeurs valides :

  • true : L'appel a réussi.

  • false : L'appel a échoué.

true

InstanceStatuses

array<object>

L'état de l'instance ECS. Si l'état d'une instance ECS ne répond pas aux exigences d'installation d'un client HBR et que la valeur du paramètre InstanceIds est supérieure à 1, un message d'erreur est renvoyé en fonction de la valeur de ce paramètre.

object

ValidInstance

boolean

Indique si un client HBR peut être installé sur l'instance ECS. Valeurs valides :

  • true : Un client HBR peut être installé sur l'instance ECS.

  • false : Un client HBR ne peut pas être installé sur l'instance ECS.

true

InstanceId

string

L'identifiant de l'instance ECS.

i-0xi5w***v3j3bh2gj5

ErrorCode

string

Le code d'erreur renvoyé. Valeurs valides :

  • Si la valeur est vide, l'appel a réussi.

  • InstanceNotExists : L'instance ECS n'existe pas.

  • InstanceNotRunning : L'instance ECS n'est pas en cours d'exécution.

  • CloudAssistNotRunningOnInstance : Cloud Assistant n'est pas disponible.

InstanceNotExists

Exemples

JSON format

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

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.