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

  • 發行項

概觀

讓 時間序列模型 (實例、 階層和 類型) 有對應的 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 使用下列其中一項搜尋的檔：

  1. 'dryer washer' dryer
  2. '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。