Todos os produtos
Search
Central de documentação

Simple Log Service:create_machine_group

Última atualização: Aug 26, 2026

Cria um grupo de máquinas por meio do SLS CLI.

Sintaxe da solicitação

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

Parâmetros obrigatórios e específicos do comando create_machine_group:

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

--project_name

String

Sim

aliyun-test-project

Nome do projeto.

--group_detail

JSON Object

Sim

file://./machinegroup.json

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

Para obter informações sobre os parâmetros globais do SLS CLI, consulte Global parameters.

Exemplos

  1. Crie um arquivo chamado machinegroup.json. O exemplo a seguir define o nome do 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

    Descrição

    machine_list

    Identificadores de servidor 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:

    • Deve ser exclusivo no projeto.

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

    • Começa e termina com letra minúscula ou dígito.

    • Tem de 3 a 128 caracteres.

    group_type

    Tipo do 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. Crie o grupo de máquinas group_name2 com a conta padrão:

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

    Este comando não gera saída.

  3. Verifique o grupo de máquinas:

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

    Saída de exemplo:

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

Códigos de erro

Em caso de erro, solucione o problema com base nos códigos de erro da operação de API relacionada. Para mais informações, consulte Error codes.

Referência da API

CreateMachineGroup