更新 Logstore 的屬性資訊。
介面說明
介面說明
更新 Logstore 前需要先使用 GetLogStore 取得 Logstore 的原設定,在此基礎上修改後,作為參數傳入到 UpdateLogStore 中。
請求語法中的 Host 由 Project 名稱和日誌服務 Endpoint 構成,您需要在 Host 中指定 Project。
已建立並取得 AccessKey。更多資訊,請參見存取金鑰。
阿里雲帳號 AccessKey 擁有所有 API 的存取權限,風險很高。強烈建議您建立並使用 RAM 使用者進行 API 存取或日常維運。RAM 使用者需具備操作日誌服務資源的權限。具體操作,請參見建立 RAM 使用者及授權。
已明確您查詢日誌所屬的 Project 名稱、所屬地域、Logstore 名稱等資訊。如何查詢,請參見管理 Project和管理 Logstore。
鑑權資源
下表列出了 API 對應的授權資訊。您可以在 RAM 權限策略語句的 Action 元素中新增該資訊,用於為 RAM 使用者或 RAM 角色授予呼叫此 API 的權限。
| 動作(Action) | 授權策略中的資源描述方式(Resource) |
log:UpdateLogStore | acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName} |
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
log:UpdateLogStore |
update |
*LogStore
|
|
無 |
請求文法
PUT /logstores/{logstore} HTTP/1.1
路徑參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| logstore |
string |
是 |
Logstore 名稱。 |
test-logstore |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| project |
string |
是 |
Project 名稱。 |
ali-test-project |
| body |
object |
是 |
請求體參數。 |
|
| logstoreName |
string |
是 |
Logstore 名稱。 |
test-logstore |
shardCount
deprecated
|
integer |
否 |
Shard 分割區個數。 說明
該介面不支援更新分割區個數。只能透過 SplitShard 或 MergeShards 介面修改分割區個數。 |
2 |
| ttl |
integer |
是 |
資料的儲存時間,單位為天。取值範圍為 1~3650。如果設定為 3650,表示永久儲存。 |
30 |
| encrypt_conf | EncryptConf |
否 |
加密設定資料結構。預設不啟用加密。 範例 1(啟用預設加密設定):
範例 2(啟用 BYOK 加密): |
|
| autoSplit |
boolean |
否 |
是否自動分裂 Shard。啟用後,當日誌寫入流量持續超限,會觸發 Shard 自動分裂,提升寫入能力。啟用自動分裂時必須設定 maxSplitShard(最大分裂 Shard 數)。 |
true |
| enable_tracking |
boolean |
否 |
是否啟用 WebTracking 功能。預設值為 false。當需要收集和分析使用者在瀏覽器或小程序中的行為資料(如頁面瀏覽、購買記錄、停留時長等)時,可以使用 WebTracking 功能。
|
false |
| appendMeta |
boolean |
否 |
是否記錄公網 IP 位址和日誌接收時間。預設值為 false。
|
false |
| maxSplitShard |
integer |
否 |
自動分裂時最大的 Shard 個數,最小值是 1,最大值是 256。 說明
當 autoSplit 為 true 時必須指定。 |
64 |
telemetryType
deprecated
|
string |
否 |
可觀測資料類型。預設為日誌資料,可選取值包括:
|
None |
| hot_ttl |
integer |
否 |
資料在 Logstore 熱儲存層中的儲存時間。單位:天,最小為 7,最大不能超過 ttl 的值,預設儲存時間 ttl 內全是熱儲存。 當資料的儲存時間超過您所設定的熱儲存層資料儲存時間後,資料將轉為低頻儲存(啟用低頻儲存時,要求熱儲存時間至少為 7 天)。更多資訊,請參見智慧冷熱分層儲存。 範例:
|
60 |
| mode |
string |
否 |
日誌服務提供標準型(Standard)和查詢型(Query)兩種類型的 Logstore。
|
standard |
| infrequentAccessTTL |
integer |
否 |
低頻儲存。沒有最少儲存時間要求,至少儲存 30 天轉歸檔儲存。 當日誌儲存時間大於熱儲存時間與低頻儲存時間之和時,剩餘的儲存時間將轉化為歸檔儲存。 範例:
|
30 |
| shardingPolicy | ShardingPolicy |
否 |
雜湊寫入設定。寫入資料時,日誌會根據設定的雜湊策略選擇儲存的 Shard。設定前需要確保 Shard 的雜湊範圍均勻,可能會影響寫入能力,請謹慎設定。 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
當前API暫無返回參數
樣本
正常返回樣本
JSON格式
{}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。