調用CLI命令建立Logstore。
注意事項
在使用CLI命令之前,您需要注意以下事項:
已開通Log Service。具體操作,請參見如何開始使用Log Service?。
已建立Log ServiceProject。具體操作,請參見create_project。
命令格式
aliyunlog log create_logstore --project_name=<value> --logstore_name=<value> [--ttl=<value>] [--shard_count=<value>] [--enable_tracking=<value>] [--append_meta=<value>] [--auto_split=<value>] [--max_split_shard=<value>] [--preserve_storage=<value>] [--encrypt_conf=<value>] [--telemetry_type=<value>] [--hot_ttl=<value>] [--mode=<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個數。取值範圍為1~10。 |
--enable_tracking | Boolean | 否 | true | 是否開啟WebTracking功能。預設值為false。
|
--append_meta | Boolean | 否 | false | 是否開啟記錄外網IP地址功能。預設值為false。
|
--auto_split | Boolean | 否 | true | 是否自動分裂Shard功能。預設值為false,表示不自動分裂Shard。
|
--max_split_shard | Integer | 否 | 64 | 自動分裂Shard時的最大分裂數。取值範圍為1~256。當--auto_split參數為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 create_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a"
返回樣本
命令執行成功後,無響應訊息。您可以執行如下命令查詢Logstore詳細資料。
aliyunlog log get_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a" --format-output=json
使用指定帳號test,建立一個名為logstore-b的Logstore。
命令樣本
aliyunlog log create_logstore --project_name="aliyun-test-project" --logstore_name="logstore-b" --client-name="test"
返回樣本
命令執行成功後,無響應訊息。您可以執行如下命令查詢Logstore詳細資料。
aliyunlog log get_logstore --project_name="aliyun-test-project" --logstore_name="logstore-b" --client-name="test" --format-output=json
返回結果如下:
{ "appendMeta": false, "archiveSeconds": 0, "autoSplit": true, "createTime": 1719280391, "enable_tracking": false, "lastModifyTime": 1719282255, "logstoreName": "logstore-b", "maxSplitShard": 64, "mode": "standard", "productType": "", "resourceQuota": { "storage": { "preserved": -1, "used": 0 } }, "shardCount": 5, "telemetryType": "", "ttl": 30 }
相關文檔
在調用API介面過程中,若服務端返回結果中包含錯誤資訊,則表示調用API介面失敗。您可以參考API錯誤碼對照表尋找對應的解決方案。更多資訊,請參見API錯誤處理對照表。
阿里雲OpenAPI開發人員門戶提供調試、SDK、樣本和配套文檔。通過OpenAPI,您無需手動封裝請求和簽名操作,就可以快速對Log ServiceAPI進行調試。更多資訊,請參見OpenAPI開發人員門戶。
關於該API介面的詳細資料,請參見CreateLogStore。
Log Service提供基於Java SDK和Python SDK的管理Logstore範例程式碼。更多資訊,請參見使用Java SDK管理日誌庫Logstore和使用Python SDK管理日誌庫Logstore。