全部產品
Search

搜尋本產品

    Simple Log Service：update_logstore

    文件中心

    Simple Log Service：update_logstore

    更新時間：Jul 03, 2025

    調用CLI命令修改Logstore基本資料。

    注意事項

    在使用CLI命令之前，您需要注意以下事項：

    命令格式

    aliyunlog log update_logstore --project_name=<value> --logstore_name=<value> [--ttl=<value>] [--enable_tracking=<value>] [--shard_count=<value>] [--append_meta=<value>] [--auto_split=<value>] [--max_split_shard=<value>] [--preserve_storage=<value>] [--encrypt_conf=<value>] [--hot_ttl=<value>] [--mode=<value>] [--telemetry_type=<value>] [--infrequent_access_ttl=<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>] [--profile=<value>] [--sign-version=<value>] [--region-id=<value>]

    命令參數

    該命令的必選和特有參數描述如下。

    參數名稱

    數實值型別

    是否必選

    樣本值

    描述

    --project_name

    String

    是

    aliyun-test-project

    Project名稱：專案（Project）是Log Service的資源嵌入式管理單元，是進行多使用者隔離與存取控制的主要邊界。更多資訊，請參見管理Project。

    --logstore_name

    String

    是

    logstore-a

    Logstore名稱在Project中全域唯一，且建立後不可修改。

    其命名規則如下：

    • 僅支援小寫字母、數字、連字號（-）和底線（_）。

    • 必須以小寫字母開頭，以小寫字母和數字結尾。

    • 名稱長度為3~63個字元。

    --ttl

    Integer

    否

    30

    資料儲存時間，單位為天。取值範圍：1~3650，如果配置為3650，表示永久儲存。當設定的儲存期限到達時，日誌將被刪除。

    資料儲存時間（ttl）是以下三部分時間的總和：

    • 熱儲存資料儲存時間（hot_ttl）

    • 低頻儲存資料儲存時間（infrequent_access_ttl）

    • Archive Storage資料儲存時間

    重要

    如果調整了儲存期限，Log Service會在1小時內清除所有超出新期限的資料，但是控制台首頁的用量明細會在次日進行更新。例如，若原先的資料儲存期限是5天，並將其改為1天，那麼系統將在1小時內刪除前4天的日誌資料。

    --shard_count

    Integer

    否

    2

    分區（Shard）數量。更多資訊，請參見Shard範圍。

    重要

    不支援通過update_logstore修改分區個數，只能通過SplitShard - 分裂Shard增加分區或MergeShard - 合并shard減少分區。

    --enable_tracking

    Boolean

    否

    true

    是否開啟WebTracking。

    • true：開啟WebTracking。

    • false：不開啟WebTracking。

    --append_meta

    Boolean

    否

    false

    是否開啟記錄外網IP地址。

    • true：開啟記錄外網IP地址。

    • false：不開啟記錄外網IP地址。

    --auto_split

    Boolean

    否

    true

    是否自動分裂Shard。

    • true：自動分裂Shard。

    • false：不自動分裂Shard。

    --max_split_shard

    Integer

    否

    64

    自動分裂Shard時的最大分裂數。取值範圍為1~256。當--autoSplit參數為true時必須設定。

    --encrypt_conf

    String

    否

    無

    加密配置資料結構。

    更多資訊，請參見EncryptConf。

    --telemetry_type

    String

    否

    None

    可觀測資料類型。取值包括：

    • None：日誌資料。預設為日誌資料。

    • Metrics：時序資料。

    --hot_ttl

    Integer

    否

    7

    資料在Logstore熱儲存層中的儲存時間，單位為天。最小為7，最大不能超過ttl的值，取值為-1代表儲存時間ttl內全是熱儲存。

    當資料的儲存時間超過您所配置的熱儲存層資料儲存時間後，資料將轉為低頻儲存。關於熱儲存、低頻儲存、Archive Storage的概念和轉換流程，請參見管理智能儲存分層。

    • 熱儲存資料至少需要儲存7天才能轉換為低頻儲存，低頻儲存至少需要儲存30天才能轉換為Archive Storage。

    • 熱儲存資料至少需要儲存30天才能轉換為Archive Storage。

    --mode

    String

    否

    standard

    Simple Log Service提供Standard（標準型）和Query（查詢型）兩種類型的Logstore。

    • standard（預設值）：支援Log Service一站式資料分析功能，適用於即時監控、互動式分析以及構建完整的可觀測性系統等情境。

    • query：支援高效能查詢，索引流量費用約為Standard的一半，但不支援SELECT語句，適用於資料量大、儲存周期長（周、月層級以上）或無日誌分析的情境。

    更多資訊，請參見Logstore類型對比。

    --infrequent_access_ttl

    Integer

    否

    30

    資料在Logstore低頻儲存層中的儲存時間，單位：天。低頻儲存資料至少需要儲存30天才能轉換為Archive Storage。更多資訊，請參見管理智能儲存分層。

    關於該命令的全域參數，請參見全域參數。

    命令樣本

    • 請求樣本

      使用預設帳號修改logstore-a資訊。

      aliyunlog log update_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a" --ttl=30 --enable_tracking=true

    • 返回樣本

      命令執行成功後，無響應訊息。您可以執行如下命令查詢Logstore詳細資料。

      aliyunlog log get_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a" --format-output=json

    相關文檔