調用CLI命令修改Logstore基本信息。
注意事項
在使用CLI命令之前,您需要注意以下事項:
已開通日志服務。具體操作,請參見如何開始使用日志服務?。
已創建日志服務Project和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 | 日志服務提供標準型(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,您無需手動封裝請求和簽名操作,就可以快速對日志服務API進行調試。更多信息,請參見OpenAPI開發者門戶。
關于該API接口的詳細信息,請參見UpdateLogStore。
日志服務提供基于Java SDK和Python SDK的管理Logstore示例代碼。更多信息,請參見使用Java SDK管理日志庫Logstore和使用Python SDK管理日志庫Logstore。