UpdateLogs

更新時間:
Copy as MD

更新指定 Project 下某個 Logstore 中的日誌資料。

介面說明

Host 由 Project 名稱和日誌服務 Endpoint 構成,您需要在 Host 中指定 Project。

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

POST /logstores/{logstore}/updatelogs HTTP/1.1

路徑參數

名稱

類型

必填

描述

樣本值

logstore

string

Logstore 名稱。

ali-test-logstore

請求參數

名稱

類型

必填

描述

樣本值

body

object

請求體。

from

integer

查詢開始時間點。該時間是指寫入日誌資料時指定的日誌時間。

請求參數 from 和 to 定義的時間區間遵循左閉右開原則,即該時間區間包括區間開始時間點,但不包括區間結束時間點。如果 from 和 to 的值相同,則為無效區間,函數直接返回錯誤。 Unix 時間戳格式,表示從 1970-1-1 00:00:00 UTC 計算起的秒數。

1627268185

to

integer

查詢結束時間點。該時間是指寫入日誌資料時指定的日誌時間。

請求參數 from 和 to 定義的時間區間遵循左閉右開原則,即該時間區間包括區間開始時間點,但不包括區間結束時間點。如果 from 和 to 的值相同,則為無效區間,函數直接返回錯誤。 Unix 時間戳格式,表示從 1970-1-1 00:00:00 UTC 計算起的秒數。

1627268200

query

string

可選:查詢語句,用於篩選需要更新的日誌。更多資訊,請參見查詢概述

說明:本參數僅支援查詢語句,不支援如 SPL、SQL 等分析語句。

status: 401

rowId

string

可選:查詢結果中自動返回內建欄位 rowid 的值。

rowId 和 query 這兩個欄位必須給一個,如果兩個都給,rowId 的優先級更高。

0|1000001|638732499

updateMode

string

可選:取值 full 或 partial,預設值為 partial

  • full —— 請求體須包含該行所有欄位,服務端用新值整行覆蓋舊記錄。

  • partial —— 請求體只需包含要修改的欄位,未提供的欄位保持原值不變。

partial

data

string

要更新的資料,json 格式。

{"status":"success"}

project

string

Project 名稱。

ali-project-test

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

affectedRows

integer

更新的日誌行數。

10

樣本

正常返回樣本

JSON格式

{
  "affectedRows": 10
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情