Azure Time Series Insights Rozhraní API pro modely Gen2

Přehled

Každá ze tří komponent, které tvoří model časové řady (instance, hierarchie a typy), má odpovídající rozhraní REST API, která podporují operace CREATE, READ, UPDATE a DELETE, stránkované a/nebo dávkové operace.

  • Rozhraní API instance podporuje stránkované operace GET, dávkové operace CREATE, READ, UPDATE a DELETE, hledání a návrhy klíčových slov pro operace hledání.
  • Rozhraní API hierarchie podporuje stránkované operace GET a dávkové operace CREATE, READ, UPDATE a DELETE.
  • Rozhraní API typu podporuje stránkované operace GET a dávkové operace CREATE, READ, UPDATE a DELETE.

Čtvrté rozhraní API poskytuje podporu REST pro nastavení modelu Time Series:

Rozhraní API pro instance

Rozhraní API instance umožňuje provádět operace CREATE, READ, UPDATE a DELETE v instancích time series:

  • Rozhraní GET Instances API vrátí všechny instance time series, které odpovídají požadavku.

  • Rozhraní API pro správu instancí umožňuje dávkové operace s instancemi. Všechny operace s tímto rozhraním API jsou operace HTTP POST . Každá operace přijímá datovou část. Datová část je objekt JSON. Tento objekt definuje jednu vlastnost. Klíč vlastnosti je název operace povolené rozhraním API. Podporované operace jsou PUT, UPDATE a DELETE.

  • Tato rozhraní API umožňují zjišťování instancí time series:

    • Funkce Navrhnout povolí scénáře automatického dokončování při hledání instance.
    • Vyhledávání pomáhá identifikovat instance na základě zadaných klíčových slov.

    Tip

    Informace o funkcích vyhledávacích dotazů najdete níže.

Rozhraní API pro hierarchie

Rozhraní API hierarchií umožňuje u hierarchií časových řad CREATE, READ, UPDATE a DELETE .

Rozhraní API Popis
Rozhraní API pro získání hierarchií Vrátí všechny hierarchie časových řad, které odpovídají požadavku.
Správa rozhraní API hierarchií Umožňuje dávkové operace v hierarchiích. Všechny operace s tímto rozhraním API jsou operace HTTP POST . Každá operace přijímá datovou část. Datová část je objekt JSON. Tento objekt definuje jednu vlastnost. Klíč vlastnosti je název operace, kterou rozhraní API umožňuje. Podporované operace jsou PUT, UPDATE a DELETE.

Rozhraní API pro typy

Rozhraní API pro typy umožňuje create, READ, UPDATE a DELETE u typů časových řad a jejich přidružených proměnných.

Rozhraní API Popis
Rozhraní API pro získání typů Vrátí všechny typy časových řad a jejich přidružené proměnné.
Rozhraní API typů post Umožňuje dávkové operace s typy. Všechny operace s tímto rozhraním API jsou operace HTTP POST . Každá operace přijímá datovou část. Datová část je objekt JSON. Tento objekt definuje jednu vlastnost. Klíč vlastnosti je název operace, kterou rozhraní API umožňuje. Podporované operace jsou PUT, UPDATE a DELETE.

Rozhraní API pro nastavení modelu

Rozhraní API pro nastavení modelu umožňuje vytvořit, ČÍST, AKTUALIZOVAT a ODSTRANIT automaticky vytvořené modely v prostředí pomocí TimeSeriesIds.

Rozhraní API Popis
Získat rozhraní API pro nastavení modelu Vrátí automaticky vytvořený model v prostředí pro TimeSeriesIds.
Aktualizace rozhraní API pro nastavení modelu Aktualizace model v prostředí pro TimeSeriesIds s novými hodnotami zadanými v požadavku.

Funkce vyhledávání

Hledání pomocí zástupných znaků

Podporujeme vyhledávání s jedním a více znaky se zástupnými znaky v rámci jednoho výrazu (ne v rámci vyhledávání frází).

Jeden znak

Chcete-li provést vyhledávání pomocí jednoho znaku se zástupným znakem ? , použijte symbol . Vyhledávání pomocí zástupných znaků s jedním znakem hledá termíny, které odpovídají řetězci s nahrazeným jedním znakem.

Pokud chcete vyhledat nebo texttest, vyhledejte: te?t.

Více znaků

Chcete-li provést vyhledávání pomocí více znaků se zástupnými znaky, použijte * symbol . Vyhledávání pomocí více znaků se zástupnými znaky hledá nula nebo více znaků.

Pokud chcete vyhledat test, testsnebo tester, použijte vyhledávání: test*.

Můžete také použít vyhledávání pomocí zástupných znaků uprostřed termínu. Pokud chcete vyhledat dryer, můžete použít vyhledávání: dr*r.

Logické operátory

Logické operátory umožňují kombinování termínů prostřednictvím logických operátorů. Operátory AND, OR, +, -a NE podporujeme jako logické operátory.

Důležité

  • Logické operátory musí být ve VŠECH CAPS.
  • Logické operátory musí být oddělené od vyhledávacích klauzulí pomocí prázdných znaků.
  • dryer AND washer je platný, ale ne dryer ANDwasher.

Operátor AND

Operátor AND odpovídá dokumentům, kde oba termíny existují kdekoli v textu jednoho dokumentu.

Pokud chcete hledat dokumenty, které obsahují dryer washer a foo bar používají vyhledávání: dryer washer AND foo bar.

Poznámka

Symbol && lze použít místo operátoru AND.

Operátor OR

Operátor OR propojí dva termíny a najde odpovídající dokument, pokud některý z termínů v dokumentu existuje. Operátor OR je výchozím operátorem spojení. To znamená, že pokud mezi dvěma termíny neexistuje logický operátor, použije se operátor OR .

Pokud chcete vyhledat dokumenty, které obsahují některou dryer washer z těchto položek, nebo použijte dryer některé z následujících hledání:

  1. 'dryer washer' dryer
  2. 'dryer washer' OR dryer

Poznámka

Symbol || lze použít místo operátoru OR.

+ Operátor

Operátor + nebo vyžaduje, aby termín za + symbolem existoval někde v poli jednoho dokumentu.

Pokud chcete vyhledat dokumenty, které musí obsahovat dryer a mohou obsahovat, washer použijte vyhledávání: +dryer washer.

-Operátor

Operátor - nebo zákaz vyloučí dokumenty, které obsahují termín za - symbolem.

Pokud chcete hledat dokumenty, které obsahují dryer washer , ale nepoužívejte foo bar ho: dryer washer -foo bar.

NOT

Operátor NOT vyloučí dokumenty, které obsahují termín za NOT.

Pokud chcete hledat dokumenty, které obsahují dryer washer , ale nepoužívají foo bar vyhledávání: dryer washer NOT foo bar.

Operátor NOT nelze použít pouze s jedním termínem.

Následující hledání nevrátí žádné výsledky: NOT dryer washer.

Poznámka

Symbol ! lze použít místo operátoru NOT.

  • Musí bezprostředně předcházet vyloučený hledaný termín.
  • dryer !washer je platný, ale ne dryer ! washer.

Viz také

  • Další informace o registraci aplikací a programovacím modelu Azure Active Directory najdete v tématu Azure Active Directory pro vývojáře.

  • Další informace o parametrech požadavků a ověřování najdete v tématu Ověřování a autorizace.

  • Mezi nástroje, které pomáhají s testováním požadavků a odpovědí HTTP, patří:

  • Fiddleři. Tento bezplatný webový ladicí proxy server může zachycovat vaše požadavky REST, abyste mohli diagnostikovat požadavky HTTP a zprávy odpovědí.

  • JWT.io. Tento nástroj můžete použít k rychlému výpisu deklarací identity v nosným tokenu a následnému ověření jejich obsahu.

  • Postman. Toto je bezplatný nástroj pro testování požadavků HTTP a odpovědí pro ladění rozhraní REST API.

  • Další informace o Azure Time Series Insights Gen2 najdete v dokumentaci k Gen2.