全部產品
Search
文件中心

Simple Log Service:UpdateLogStore

更新時間:Jul 24, 2026

更新 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:UpdateLogStoreacs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

log:UpdateLogStore

update

*LogStore

acs:log:{#regionId}:{#accountId}:project/{#project}/logstore/{#logstore}

  • log:TLSVersion
  • log:Encrypted

請求文法

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(啟用預設加密設定):

{
    "enable": true,
    "encrypt_conf": "default"
}

範例 2(啟用 BYOK 加密):

{
    "enable": true,
    "encrypt_conf": "default",
    "user_cmk_info": {
        "cmk_key_id": "xxxxx",
        "arn": "acs:ram::112340000000:role/rolename",
        "region": "cn-hangzhou"
    }
}

autoSplit

boolean

是否自動分裂 Shard。啟用後,當日誌寫入流量持續超限,會觸發 Shard 自動分裂,提升寫入能力。啟用自動分裂時必須設定 maxSplitShard(最大分裂 Shard 數)。

true

enable_tracking

boolean

是否啟用 WebTracking 功能。預設值為 false。當需要收集和分析使用者在瀏覽器或小程序中的行為資料(如頁面瀏覽、購買記錄、停留時長等)時,可以使用 WebTracking 功能。

  • true:啟用 WebTracking。

  • false:不啟用 WebTracking。

false

appendMeta

boolean

是否記錄公網 IP 位址和日誌接收時間。預設值為 false。

  • true:啟用記錄公網 IP 和日誌接收時間功能,啟用後日誌服務自動把日誌來源裝置的公網 IP 位址和日誌到達伺服器的時間新增到日誌的 Tag 欄位中。

  • false:不啟用記錄公網 IP 和日誌接收時間功能。

false

maxSplitShard

integer

自動分裂時最大的 Shard 個數,最小值是 1,最大值是 256。

說明

當 autoSplit 為 true 時必須指定。

64

telemetryType deprecated

string

可觀測資料類型。預設為日誌資料,可選取值包括:

  • None:日誌資料。預設為日誌資料。

  • Metrics:時序資料。

None

hot_ttl

integer

資料在 Logstore 熱儲存層中的儲存時間。單位:天,最小為 7,最大不能超過 ttl 的值,預設儲存時間 ttl 內全是熱儲存。

當資料的儲存時間超過您所設定的熱儲存層資料儲存時間後,資料將轉為低頻儲存(啟用低頻儲存時,要求熱儲存時間至少為 7 天)。更多資訊,請參見智慧冷熱分層儲存

範例:

  • 場景 1(只啟用熱儲存 30 天):{"ttl": 30} 或者 {"ttl": 30, "hot_ttl": 30}

  • 場景 2(啟用熱儲存 7 天,低頻儲存 23 天):{"ttl": 30, "hot_ttl": 7}

60

mode

string

日誌服務提供標準型(Standard)和查詢型(Query)兩種類型的 Logstore。

  • standard:支援日誌服務一站式資料分析功能,適用於即時監控、互動式分析以及建構完整的可觀測性系統等場景。

  • query:支援高效能查詢,索引流量費用約為 Standard 的一半,但不支援 SQL 分析,適用於資料量大、儲存週期長(週、月級別以上)、無日誌分析的場景。

standard

infrequentAccessTTL

integer

低頻儲存。沒有最少儲存時間要求,至少儲存 30 天轉歸檔儲存。

當日誌儲存時間大於熱儲存時間與低頻儲存時間之和時,剩餘的儲存時間將轉化為歸檔儲存。

範例:

  • 場景 1(啟用熱存 7 天,低頻儲存 23 天):{"ttl": 30, "hot_ttl": 7}

  • 場景 2(啟用熱存 7 天,低頻儲存 30 天,歸檔 60 天):{"ttl": 97, "hot_ttl": 7, "infrequentAccessTTL": 30}

  • 場景 3(啟用熱存 60 天,低頻儲存 0 天,歸檔 60 天):{"ttl": 120, "hot_ttl": 60, "infrequentAccessTTL": 0}

30

shardingPolicy ShardingPolicy

雜湊寫入設定。寫入資料時,日誌會根據設定的雜湊策略選擇儲存的 Shard。設定前需要確保 Shard 的雜湊範圍均勻,可能會影響寫入能力,請謹慎設定。

返回參數

名稱

類型

描述

樣本值

當前API暫無返回參數

樣本

正常返回樣本

JSON格式

{}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情