Tous les produits
Search
Centre de documentation

Simple Log Service:create_machine_group

Dernière mise à jour :Aug 26, 2026

Créez un groupe de machines à l'aide de la CLI SLS.

Syntaxe de la requête

aliyunlog log create_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

Paramètres obligatoires et spécifiques à la commande pour create_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

Chemin d'accès au fichier de configuration du groupe de machines.

Pour plus d'informations sur les paramètres globaux de la CLI SLS, consultez la rubrique Global parameters.

Exemples

  1. Créez un fichier nommé machinegroup.json. L'exemple suivant définit le nom du groupe de machines sur group_name2 :

    {
      "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 dans le groupe de machines.

    • Si machineIdentifyType est défini sur ip, saisissez les adresses IP des serveurs.

    • Si machineIdentifyType est défini sur userdefined, saisissez des ID personnalisés. Create a custom ID-based machine group.

    machine_type

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

    • ip : identifiants basés sur l'adresse IP.

    • userdefined : identifiants basés sur un ID personnalisé.

    group_name

    Nom du groupe de machines. Conditions requises :

    • 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. Créez le groupe de machines group_name2 avec le compte par défaut :

    aliyunlog log create_machine_group --project_name="aliyun-test-project" --group_detail="file://./machinegroup.json"

    Cette commande ne renvoie aucune sortie.

  3. Vérifiez le groupe de machines :

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

    Exemple de sortie :

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

Codes d'erreur

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

Référence API

CreateMachineGroup