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 nastavení modelu podporuje operace HTTP GET a UPDATE pro nastavení konfigurace modelu časové řady. Podrobné informace o modelu časové řady a definicích instancí, hierarchie a typů najdete v tématu Model časových řad.
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 washerje platný, ale nedryer 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í:
'dryer washer' dryer'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 !washerje platný, ale nedryer ! 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.