調用CLI命令修改Logstore基本資料。
注意事項
在使用CLI命令之前,您需要注意以下事項:
- 已開通Log Service。具體操作,請參見如何開始使用Log Service?。
- 已安裝Log ServiceCLI,並完成配置。具體操作,請參見安裝CLI和配置CLI。
- 已建立Log ServiceProject和Logstore。具體操作,請參見create_project和create_logstore。
命令格式
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_name | String | 是 | aliyun-test-project | Project名稱。 |
--logstore_name | String | 是 | logstore-a | Logstore名稱。 |
--ttl | Integer | 否 | 30 | 資料的儲存時間,單位為天。取值範圍為1~3650。如果配置為3650,表示永久儲存。 |
--shard_count | Integer | 否 | 2 | Shard分區個數。 重要 不支援通過update_logstore修改分區個數,只能通過SplitShard增加或MergeShard減少。 |
--enable_tracking | Boolean | 否 | true | 是否開啟WebTracking。
|
--append_meta | Boolean | 否 | false | 是否開啟記錄外網IP地址。
|
--auto_split | Boolean | 否 | true | 是否自動分裂Shard。
|
--max_split_shard | Integer | 否 | 64 | 自動分裂Shard時的最大分裂數。取值範圍為1~256。當--autoSplit參數為true時必須設定。 |
--encrypt_conf | String | 否 | 無 | 加密配置資料結構。 更多資訊,請參見EncryptConf。 |
--telemetry_type | String | 否 | None | 可觀測資料類型。取值包括:
|
--hot_ttl | Integer | 否 | 60 | 資料在Logstore熱儲存層中的儲存時間,最少為7天。單位:天,取值範圍:7~3000。 當資料的儲存時間超過您所配置的熱儲存層資料儲存時間後,資料將轉為低頻儲存。更多資訊,請參見開啟智能儲存分層。 |
--mode | String | 否 | standard | Log Service提供標準型(Standard)和查詢型(Query)兩種類型的Logstore。
|
命令樣本
- 請求樣本使用預設帳號修改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。