全部產品
Search
文件中心

Simple Log Service:update_logstore

更新時間:Jun 30, 2024

調用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>] [--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>]

命令參數

該命令的必選和特有參數描述如下。
參數名稱數實值型別是否必選樣本值描述
--project_nameStringaliyun-test-projectProject名稱。
--logstore_nameStringlogstore-aLogstore名稱。
--ttlInteger30資料的儲存時間,單位為天。取值範圍為1~3650。如果配置為3650,表示永久儲存。
--shard_countInteger2Shard分區個數。
重要 不支援通過update_logstore修改分區個數,只能通過SplitShard增加或MergeShard減少。
--enable_trackingBooleantrue是否開啟WebTracking。
  • true:開啟WebTracking。
  • false:不開啟WebTracking。
--append_metaBooleanfalse是否開啟記錄外網IP地址。
  • true:開啟記錄外網IP地址。
  • false:不開啟記錄外網IP地址。
--auto_splitBooleantrue是否自動分裂Shard。
  • true:自動分裂Shard。
  • false:不自動分裂Shard。
--max_split_shardInteger64自動分裂Shard時的最大分裂數。取值範圍為1~256。當--autoSplit參數為true時必須設定。
--encrypt_confString

加密配置資料結構。

更多資訊,請參見EncryptConf
--telemetry_typeStringNone

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

  • None:日誌資料。預設為日誌資料。
  • Metrics:時序資料。
--hot_ttlInteger60

資料在Logstore熱儲存層中的儲存時間,最少為7天。單位:天,取值範圍:7~3000。

當資料的儲存時間超過您所配置的熱儲存層資料儲存時間後,資料將轉為低頻儲存。更多資訊,請參見開啟智能儲存分層

--modeStringstandard

Log Service提供標準型(Standard)和查詢型(Query)兩種類型的Logstore。

  • standard:支援Log Service一站式資料分析功能,適用於即時監控、互動式分析以及構建完整的可觀測性系統等情境。
  • query:支援高效能查詢,索引流量費用約為Standard的一半,但不支援SQL分析,適用於資料量大、儲存周期長(周、月層級以上)、無日誌分析的情境。
關於該命令的全域參數,請參見全域參數

命令樣本

  • 請求樣本
    使用預設帳號修改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

相關文檔

  • 在調用API介面過程中,若服務端返回結果中包含錯誤資訊,則表示調用API介面失敗。您可以參考API錯誤碼對照表尋找對應的解決方案。更多資訊,請參見API錯誤處理對照表

  • 阿里雲OpenAPI開發人員門戶提供調試、SDK、樣本和配套文檔。通過OpenAPI,您無需手動封裝請求和簽名操作,就可以快速對Log ServiceAPI進行調試。更多資訊,請參見OpenAPI開發人員門戶

  • 關於該API介面的詳細資料,請參見UpdateLogStore
  • Log Service提供基於Java SDK和Python SDK的管理Logstore範例程式碼。更多資訊,請參見使用Java SDK管理日誌庫Logstore使用Python SDK管理日誌庫Logstore