Tous les produits
Search
Centre de documentation

Simple Log Service:update_machine_group

Dernière mise à jour :Aug 18, 2026

Modifie les informations d'un groupe de machines.

Syntaxe de la requête

aliyunlog log update_machine_group --project_name=<value> --group_detail=<value> [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]

Paramètres de la requête

Le tableau suivant décrit les paramètres obligatoires et spécifiques de la commande update_machine_group.

Parameter

Type

Required

Example

Description

--project_name

String

Yes

aliyun-test-project

Nom du projet.

--group_detail

JSON Object

Yes

file://./machinegroup.json

Fichier de configuration modifié du groupe de machines.

Pour plus d'informations sur les paramètres globaux de l'interface de ligne de commande (CLI) Log Service, consultez la rubrique Paramètres globaux.

Exemples

  1. Modifiez un fichier nommé machinegroup.json dans lequel le nom du groupe de machines est group_name2. L'exemple suivant présente le contenu du fichier machinegroup.json :

    {
      "machine_list": [
        "machine1",
        "machine2"
      ],
      "machine_type": "userdefined",
      "group_name": "group_name2",
      "group_type": "",
      "group_attribute": {
        "groupTopic": "topic x"
      }
    }

    Paramètres :

    Parameter

    Description

    machine_list

    Identifiants des serveurs du groupe de machines.

    machine_type

    Type d'identifiant du groupe de machines. Valeurs possibles :

    • ip : identifiants d'adresse IP.

    • userdefined : identifiants d'ID personnalisés.

    group_name

    Nom du groupe de machines. Contraintes :

    • Doit être unique au sein du projet.

    • Ne contient que des lettres minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (_).

    • Commence et se termine par une lettre minuscule ou un chiffre.

    • Longueur comprise entre 3 et 128 caractères.

    group_type

    Type de groupe de machines. Définissez cette valeur sur null.

    group_attribute

    Attributs du groupe de machines, décrits dans le tableau suivant.

    Paramètres group_attribute :

    Parameter

    Description

    groupTopic

    Sujet du groupe de machines.

  2. Utilisez le compte par défaut pour modifier le fichier de configuration d'un groupe de machines nommé group_name2.

    aliyunlog log update_machine_group --project_name="aliyun-test-project" --group_detail="file://./machinegroup.json"
  3. Interrogez les informations du groupe de machines. Exécutez la commande suivante :

    aliyunlog log get_machine_group --project_name="aliyun-test-project" --group_name="group_name2"

    Le système renvoie la sortie suivante :

    {
      "createTime": 1622105480,
      "groupAttribute": {
        "externalName": "",
        "groupTopic": "topic x",
        "osType": "",
        "policy": "",
        "region": ""
      },
      "groupName": "group_name2",
      "groupType": "",
      "lastModifyTime": 1622105480,
      "machineIdentifyType": "userdefined",
      "machineList": [
        "machine1",
        "machine2"
      ]
    }

Codes d'erreur

En cas de message d'erreur, corrigez l'erreur en vous basant sur les codes d'erreur de l'opération API associée. Pour plus d'informations, consultez la rubrique Codes d'erreur.

Référence API

UpdateMachineGroup