Todos los productos
Search
Centro de documentos

Simple Log Service:create_machine_group

Última actualización: Sep 08, 2026

Crea un grupo de máquinas mediante la CLI de SLS.

Sintaxis de la solicitud

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>]

Parámetros de la solicitud

Parámetros obligatorios y específicos del comando para create_machine_group:

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

--project_name

String

Sí

aliyun-test-project

Nombre del proyecto.

--group_detail

JSON Object

Sí

file://./machinegroup.json

Ruta del archivo de configuración del grupo de máquinas.

Para obtener información sobre los parámetros globales de la CLI de SLS, consulte Global parameters.

Ejemplos

  1. Cree un archivo llamado machinegroup.json. En el ejemplo a continuación se establece el nombre del grupo de máquinas como group_name2:

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

    Parámetros:

    Parámetro

    Descripción

    machine_list

    Identificadores de los servidores en el grupo de máquinas.

    • Si machineIdentifyType es ip, introduzca las direcciones IP de los servidores.

    • Si machineIdentifyType es userdefined, introduzca identificadores personalizados. Create a custom ID-based machine group.

    machine_type

    Tipo de identificador del grupo de máquinas. Valores válidos:

    • ip: identificadores de dirección IP.

    • userdefined: identificadores personalizados.

    group_name

    Nombre del grupo de máquinas. Requisitos:

    • Debe ser único dentro del proyecto.

    • Solo puede contener letras minúsculas, dígitos, guiones (-) y guiones bajos (_).

    • Debe comenzar y terminar con una letra minúscula o un dígito.

    • Longitud de entre 3 y 128 caracteres.

    group_type

    Tipo de grupo de máquinas. Establezca este valor como nulo.

    group_attribute

    Atributos del grupo de máquinas, descritos en la tabla a continuación.

    Parámetros de group_attribute:

    Parámetro

    Descripción

    groupTopic

    Tema del grupo de máquinas.

  2. Cree el grupo de máquinas group_name2 con la cuenta predeterminada:

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

    Este comando no devuelve ninguna salida.

  3. Compruebe el grupo de máquinas:

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

    Salida de ejemplo:

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

Códigos de error

Si se devuelve un error, resuelva el problema con base en los códigos de error de la API correspondiente. Para obtener más información, consulte Error codes.

Referencia de la API

CreateMachineGroup