Todos os produtos
Search
Central de documentação

Simple Log Service:update_machine_group

Última atualização: Sep 22, 2026

Modifique as informações de um grupo de máquinas.

Sintaxe da requisição

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 da requisição

A tabela a seguir descreve os parâmetros obrigatórios e específicos do comando update_machine_group.

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

--project_name

String

Sim

aliyun-test-project

O nome do projeto.

--group_detail

Objeto JSON

Sim

file://./machinegroup.json

O arquivo de configuração modificado do grupo de máquinas.

Para obter informações sobre os parâmetros globais da interface de linha de comando (CLI) do Log Service, consulte Global parameters.

Exemplos

  1. modifique um arquivo chamado machinegroup.json em que o nome do grupo de máquinas seja group_name2. O exemplo a seguir mostra o conteúdo do arquivo machinegroup.json:

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

    Parâmetros:

    Parâmetro

    Descrição

    machine_list

    Identificadores dos servidores no grupo de máquinas.

    machine_type

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

    • ip: Identificadores de endereço IP.

    • userdefined: Identificadores de ID personalizado.

    group_name

    Nome do grupo de máquinas. Requisitos:

    • O nome deve ser exclusivo no projeto.

    • Contém apenas letras minúsculas, dígitos, hifens (-) e sublinhados (_).

    • Inicia e termina com uma letra minúscula ou dígito.

    • Possui de 3 a 128 caracteres.

    group_type

    Tipo de grupo de máquinas, defina como nulo.

    group_attribute

    Atributos do grupo de máquinas, descritos na tabela a seguir.

    Parâmetros de group_attribute:

    Parâmetro

    Descrição

    groupTopic

    Tópico do grupo de máquinas.

  2. Use a conta padrão e modifique o arquivo de configuração de um grupo de máquinas chamado group_name2.

    aliyunlog log update_machine_group --project_name="aliyun-test-project" --group_detail="file://./machinegroup.json"
  3. Consulte as informações do grupo de máquinas. Execute o seguinte comando:

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

    O comando retorna a seguinte saída:

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

Códigos de erro

Se o sistema retornar uma mensagem de erro, corrija o problema com base nos códigos de erro da operação de API relacionada. Para obter mais informações, consulte Error codes.

Referência da API

UpdateMachineGroup