Todos los productos
Search
Centro de documentos

Simple Log Service:update_machine_group

Última actualización: Sep 03, 2026

Modifica la información de un grupo de máquinas.

Sintaxis de la solicitud

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

Parámetros de la solicitud

A continuación se describen los parámetros obligatorios y específicos del comando update_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

Archivo de configuración modificado del grupo de máquinas.

Para obtener información sobre los parámetros globales de la interfaz de línea de comandos (CLI) de Log Service, consulte Global parameters.

Ejemplos

  1. Modifique un archivo llamado machinegroup.json en el que el nombre del grupo de máquinas es group_name2. A continuación se muestra el contenido del archivo machinegroup.json:

    {
      "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 servidor 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 3 a 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 siguiente tabla.

    Parámetros de group_attribute:

    Parámetro

    Descripción

    groupTopic

    Tema del grupo de máquinas.

  2. Utilice la cuenta predeterminada para modificar el archivo de configuración de un grupo de máquinas llamado group_name2.

    aliyunlog log update_machine_group --project_name="aliyun-test-project" --group_detail="file://./machinegroup.json"
  3. Consulte la información del grupo de máquinas. Ejecute el siguiente comando:

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

    Se devuelve el siguiente resultado:

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

Códigos de error

Si se devuelve un mensaje de error, corríjalo según los códigos de error de la operación API relacionada. Para obtener más información, consulte Error codes.

Referencia de API

UpdateMachineGroup