Todos os produtos
Search
Central de documentação

Simple Log Service:atualize_logtail_config

Última atualização: Jul 03, 2026

Atualiza uma configuração do Logtail por meio da CLI do Log Service.

Sintaxe da solicitação

aliyunlog log update_logtail_config --project_name=<value> --config_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 específicos do comando:

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

--project_name

String

Sim

aliyun-test-project

Nome do projeto.

--config_detail

String

Sim

file://./logtailconfig.json

Caminho do arquivo de configuração do Logtail. Para mais informações, consulte Configurações do Logtail (Legado).

Para obter os parâmetros globais da CLI do Log Service, consulte Parâmetros globais.

Exemplos

  1. Prepare o arquivo logtailconfig.json com uma configuração chamada config_name2:

    {
      "config_name": "config_name2",
      "logstore_name": "logstore-a",
      "file_pattern": "file_pattern",
      "time_format": "time_format",
      "log_path": "/log_path",
      "endpoint": "endpoint",
      "log_parse_regex": "xxx ([\\w\\-]+\\s[\\d\\:]+)\\s+(.*)",
      "log_begin_regex": "xxx.*",
      "reg_keys": [
        "time",
        "value"
      ],
      "topic_format": "none",
      "filter_keys": [
        "time",
        "value"
      ],
      "filter_keys_reg": [
        "time",
        "value"
      ],
      "logSample": "xxx 2017-11-11 11:11:11 hello alicloud."
    }
  2. Atualize a configuração config_name2 com a conta padrão:

    aliyunlog log update_logtail_config --project_name="aliyun-test-project" --config_detail="file://./logtailconfig.json"

    Este comando não retorna saída.

  3. Verifique a atualização consultando a configuração:

    aliyunlog log get_logtail_config --project_name="aliyun-test-project" --config_name="config_name2"

    Saída de exemplo:

    {
      "configName": "config_name2",
      "createTime": 1719370155,
      "inputDetail": {
        "adjustTimezone": false,
        "delayAlarmBytes": 0,
        "delaySkipBytes": 0,
        "discardNonUtf8": false,
        "discardUnmatch": true,
        "dockerFile": false,
        "enableRawLog": false,
        "enableTag": false,
        "fileEncoding": "utf8",
        "filePattern": "file_pattern",
        "filterKey": [
          "time",
          "value"
        ],
        "filterRegex": [
          "time",
          "value"
        ],
        "key": [
          "time",
          "value"
        ],
        "localStorage": true,
        "logBeginRegex": "xxx.*",
        "logPath": "/log_path",
        "logTimezone": "",
        "logType": "common_reg_log",
        "maxDepth": 1000,
        "maxSendRate": -1,
        "mergeType": "topic",
        "preserve": true,
        "preserveDepth": 0,
        "priority": 0,
        "regex": "xxx ([\\w\\-]+\\s[\\d\\:]+)\\s+(.*)",
        "sendRateExpire": 0,
        "sensitive_keys": [],
        "tailExisted": false,
        "timeFormat": "time_format",
        "timeKey": "time",
        "topicFormat": "none"
      },
      "inputType": "file",
      "lastModifyTime": 1719370155,
      "logSample": "xxx 2017-11-11 11:11:11 hello alicloud.",
      "outputDetail": {
        "endpoint": "cn-hangzhou-intranet.log.aliyuncs.com",
        "logstoreName": "logstore-a",
        "region": "cn-hangzhou",
        "telemetryType": "logs"
      },
      "outputType": "LogService"
    }

Códigos de erro

Se ocorrer um erro, solucione-o com base nos códigos de erro da API relacionada. Para mais informações, consulte Códigos de erro.

Referência da API

UpdateConfig