Azure 時間序列深入解析 Gen2 模型 API

發行項
08/05/2023

概觀

讓時間序列模型 (實例、階層和類型) 有對應的 REST API，可支援 CREATE、 READ、 UPDATE和 DELETE、編頁和/或批次作業的三個元件。

實例 API支援編頁GET作業、批次CREATE、READ、UPDATE和DELETE作業、搜尋和搜尋作業的關鍵字建議。
階層 API支援編頁GET作業和批次CREATE、READ、UPDATE和DELETE作業。
類型 API支援編頁GET作業和批次CREATE、READ、UPDATE和DELETE作業。

第四個 API 提供時間序列模型設定的 REST 支援：

模型設定 API支援時間序列模型組態設定的 HTTP GET和UPDATE作業。如需時間序列模型和實例、階層和類型定義的詳細資訊，請參閱時間序列模型。

實例 API

實例 API可讓CREATE、READ、UPDATE和DELETE作業在時間序列實例上執行：

取得實例 API會傳回符合要求的所有時間序列實例。
管理實例 API可在實例上啟用批次作業。此 API 的所有作業都是 HTTP POST 作業。每個作業都接受承載。承載是 JSON 物件。這個物件會定義單一屬性。屬性索引鍵是 API 所允許的作業名稱。支援的作業為 PUT、 UPDATE和 DELETE。
這些 API 可讓您探索時間序列實例：
- 建議會在搜尋實例時啟用自動完成案例。
- 搜尋有助於根據提供的關鍵字來識別實例。
提示

閱讀下方的搜尋查詢功能。

階層 API

階層 API可在時間序列階層上啟用CREATE、READ、UPDATE和DELETE。

API	描述
取得階層 API	傳回符合要求的所有時間序列階層。
管理階層 API	啟用階層上的批次作業。此 API 的所有作業都是 HTTP POST 作業。每個作業都接受承載。承載是 JSON 物件。這個物件會定義單一屬性。屬性索引鍵是 API 允許的作業名稱。支援的作業為 PUT、 UPDATE和 DELETE。

類型 API

類型 API可在時間序列類型及其相關聯的變數上啟用CREATE、READ、UPDATE和DELETE。

API	描述
取得類型 API	傳回所有時間序列類型及其相關聯的變數。
張貼類型 API	在類型上啟用批次作業。此 API 的所有作業都是 HTTP POST 作業。每個作業都接受承載。承載是 JSON 物件。這個物件會定義單一屬性。屬性索引鍵是 API 允許的作業名稱。支援的作業為 PUT、 UPDATE和 DELETE。

模型設定 API

模型設定 API可透過TimeSeriesIds在環境中自動建立的模型上啟用CREATE、READ、UPDATE和DELETE。

API	描述
取得模型設定 API	傳回 TimeSeriesIds環境中自動建立的模型。
更新模型設定 API	更新TimeSeriesIds環境中的模型，以及要求中提供的新值。

搜尋功能

萬用字元搜尋

我們在單一字詞內支援單一和多個字元萬用字元搜尋， (不在片語搜尋內) 。

單一字元

若要執行單一字元萬用字元搜尋，請使用 ? 符號。單一字元萬用字元搜尋會尋找符合字串且取代單一字元的字詞。

若要搜尋 text 或 test ，請搜尋： te?t 。

多個字元

若要執行多個字元萬用字元搜尋，請使用 * 符號。多個字元萬用字元搜尋會尋找零個或多個字元。

若要搜尋 test 、 tests 或 tester ，請使用搜尋： test* 。

您也可以在字詞中間使用萬用字元搜尋。若要搜尋 dryer ，您可以使用搜尋： dr*r 。

布林運算子

布林運算子允許透過邏輯運算子合併詞彙。我們支援 AND、 OR、 + 、 - 和 NOT 作為布林運算子。

重要

布林運算子必須位於 ALL CAPS 中。
布林運算子必須與使用空白字元的搜尋子句分隔。
dryer AND washer 有效，但不是 dryer ANDwasher 。

AND 運算子

AND運算子會比對這兩個詞彙都存在於單一檔文字中的任何位置的檔。

若要搜尋包含 dryer washer 並使用 foo bar 搜尋的檔： dryer washer AND foo bar 。

注意

符號 && 可用來取代運算子 AND。

OR 運算子

OR運算子會連結兩個詞彙，如果其中一個詞彙存在於檔中，則會尋找相符的檔。 OR運算子是預設的結合運算子。這表示如果兩個詞彙之間沒有布林運算子，則會使用 OR 運算子。

若要搜尋包含 dryer washer 或只 dryer 使用下列其中一項搜尋的檔：

'dryer washer' dryer
'dryer washer' OR dryer

注意

符號 || 可用來取代運算子 OR。

+ 運算子

+或必要運算子要求符號之後的 + 字詞存在於單一檔的某個欄位中。

若要搜尋必須包含 dryer 且可能包含 washer 的檔，請使用搜尋： +dryer washer 。

- 運算子

-或禁止運算子會排除包含符號之後 - 字詞的檔。

若要搜尋包含 dryer washer 但未 foo bar 使用搜尋的檔： dryer washer -foo bar 。

NOT

NOT運算子會排除包含後 NOT 一詞的檔。

若要搜尋包含 dryer washer 但未 foo bar 使用搜尋的檔： dryer washer NOT foo bar 。

NOT運算子不能只搭配一個字詞使用。

下列搜尋不會傳回任何結果： NOT dryer washer 。

注意

符號 ! 可用來取代運算子 NOT。

它必須緊接在排除的搜尋字詞之前。
dryer !washer 有效，但不是 dryer ! washer 。

另請參閱

如需應用程式註冊和 Azure Active Directory 程式設計模型的詳細資訊，請參閱適用于開發人員的 Azure Active Directory。
若要瞭解要求和驗證參數，請參閱驗證和授權。
協助測試 HTTP 要求和回應的工具組括：
Fiddler。這個免費的 Web 偵錯 Proxy 可以攔截您的 REST 要求，以便診斷 HTTP 要求和回應訊息。
JWT.io。您可以使用此工具，快速傾印持有人權杖中的宣告，然後驗證其內容。
Postman。這是免費的 HTTP 要求和回應測試控管來偵錯 REST API。
檢閱Gen2 檔，以深入瞭解 Azure 時間序列深入解析 Gen2。

共用方式為