查詢指定 Project 下某個 Logstore 中的日誌資料。已廢棄，請使用 GetLogsV2 介面替代。
介面說明
介面說明
日誌服務支援建立定時 SQL 任務。具體操作，請參見建立定時 SQL 任務。
請求語法中 Host 由 Project 名稱和日誌服務 Endpoint 構成，您需要在 Host 中指定 Project。
已建立並取得 AccessKey。更多資訊，請參見存取金鑰。
阿里雲帳號 AccessKey 擁有所有 API 的存取權限，風險很高。強烈建議您建立並使用 RAM 使用者進行 API 存取或日常維運。RAM 使用者需具備操作日誌服務資源的權限。具體操作，請參見建立 RAM 使用者及授權。
-
已明確您查詢日誌所屬的 Project 名稱、所屬地域、Logstore 名稱等。如何查詢，請參見管理 Project和管理 Logstore。
-
日誌服務查詢日誌時存在使用限制。請設計合理查詢與分析語句、設定合理查詢區間等。更多資訊，請參見查詢日誌使用限制和分析日誌使用限制。
-
查詢日誌前，已設定索引。具體操作，請參見建立索引。
-
當查詢涉及的日誌數量變化非常大時，日誌服務 API 無法預測需要呼叫多少次該介面來取得完整結果。所以需要您檢視每次請求返回結果中的 x-log-progress 狀態值，根據狀態值來確定是否需要重複呼叫該介面來取得最終完整結果。每次重複呼叫該介面都會重新消耗相同數量的查詢 CU。
-
當日誌寫入到 Logstore 中，日誌服務的查詢介面（GetHistograms 和 GetLogs）能夠查到該日誌的延遲因寫入日誌類型不同而異。日誌服務按日誌時間戳記把日誌分為如下兩類：
即時資料：日誌中時間點為伺服器當前時間點 (-180 秒，900 秒]。例如，日誌時間為 UTC 2014-09-25 12:03:00，伺服器收到時為 UTC 2014-09-25 12:05:00，則該日誌被作為即時資料處理，一般出現在正常場景下。
歷史資料：日誌中時間點為伺服器當前時間點 [-7*86400 秒，-180 秒）。例如，日誌時間為 UTC 2014-09-25 12:00:00，伺服器收到時為 UTC 2014-09-25 12:05:00，則該日誌被作為歷史資料處理，一般出現在補資料場景下。 其中，即時資料寫入至可查詢的延遲為 3 秒左右。
日誌服務將日誌時間（欄位名稱為 time）和伺服器收到時間（欄位名稱為 tag:receive_time）做差，若其差值位於 (-180 秒，900 秒] 範圍，則為即時資料，若其差位於 [-7x86400 秒，-180 秒），則為歷史資料。
日誌服務提供 Java 和 Python SDK 的 GetLogs 查詢使用範例。更多資訊，請參見Java GetLogs 使用範例和Python GetLogs 使用範例。
鑑權資源
下表列出了 API 對應的授權資訊。您可以在 RAM 權限策略語句的 Action 元素中新增該資訊，用於為 RAM 使用者或 RAM 角色授予呼叫此 API 的權限。
| 動作（Action） | 授權策略中的資源描述方式（Resource） |
log:GetLogStoreLogs | acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName} |
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
POST /logstores/{logstore}/logs HTTP/1.1路徑參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| logstore |
string |
是 |
查詢 Logstore 中的資料。 |
example-logstore |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| project |
string |
是 |
Project 名稱。 |
ali-test-project |
|
否 |
lz4 |
|||
|
否 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
array |
日誌陣列 Logs。其每個元素就是一條 Log。 |
||
|
object |
日誌陣列 Logs，其每個元素就是一條 Log。 |
[{'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.100.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}] |
樣本
正常返回樣本
JSON格式
[
{
"test": "test",
"test2": 1
}
]錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。