Azure Time Series Insights Gen2 modell API-k

Áttekintés

Az idősorozat-modelleket (példányokat, hierarchiákat és típusokat) alkotó három összetevő mindegyike rendelkezik a CREATE, READ, UPDATE és DELETE, lapszámozott és/vagy kötegelt műveleteket támogató REST API-kkal.

  • Az Instance API támogatja a lapszámozott GET műveleteket, a batch CREATE, a READ, az UPDATE és a DELETE műveleteket, a keresési műveleteket és a kulcsszavakra vonatkozó javaslatokat.
  • A Hierarchy API támogatja a többoldalas GET műveleteket és a kötegelt CREATE, READ, UPDATE és DELETE műveleteket.
  • A Type API támogatja a többoldalas GET műveleteket, valamint a batch CREATE, READ, UPDATE és DELETE műveleteket.

A negyedik API REST-támogatást biztosít a Time Series Model beállításaihoz:

  • A Modellbeállítások API támogatja a HTTP GET és UPDATE műveleteket a Time Series Model konfigurációs beállításaihoz. Az Idősormodell és - példány, -hierarchia és -típusdefiníciók részletes információiért olvassa el az Idősormodell című cikket.

Instances API

Az Instances API lehetővé teszi a CREATE, READ, UPDATE és DELETE műveletek végrehajtását a Time Series Instancesben:

  • A Get Instances API a kérésnek megfelelő összes idősorpéldányt visszaadja.

  • A Példányok kezelése API lehetővé teszi a kötegelt műveleteket a példányokon. Az API-val végzett összes művelet HTTP POST-műveletek . Minden művelet hasznos adatokat fogad el. A hasznos adat egy JSON-objektum. Ez az objektum egyetlen tulajdonságot határoz meg. A tulajdonságkulcs az API által engedélyezett művelet neve. A támogatott műveletek a PUT, AZ UPDATE és a DELETE.

  • Ezek az API-k lehetővé teszik a Time Series-példányok felderítését:

    • A javaslat engedélyezi az automatikus kiegészítési forgatókönyveket egy példány keresésekor.
    • A keresés segít azonosítani a példányokat a megadott kulcsszavak alapján.

    Tipp

    Olvassa el az alábbi keresési lekérdezési funkciókat .

Hierarchia API

A Hierarchies API lehetővé teszi a LÉTREHOZÁS, OLVASÁS, FRISSÍTÉS és TÖRLÉS használatát az idősorozat-hierarchiákban.

API Leírás
Hierarchiák API lekérése A kérésnek megfelelő összes idősorozat-hierarchiát adja vissza.
Hierarchiák API-k kezelése Engedélyezi a kötegműveleteket a hierarchiákon. Az API-val végzett összes művelet HTTP POST-műveletek . Minden művelet hasznos adatokat fogad el. A hasznos adat egy JSON-objektum. Ez az objektum egyetlen tulajdonságot határoz meg. A tulajdonságkulcs az API által engedélyezett művelet neve. A támogatott műveletek a PUT, AZ UPDATE és a DELETE.

Types API

A Types API lehetővé teszi a CREATE, READ, UPDATE és DELETE használatát az idősortípusokon és a hozzájuk tartozó változókon.

API Leírás
Típusok lekérése API Az összes idősortípust és a hozzájuk tartozó változókat adja vissza.
Post Types API Engedélyezi a kötegműveleteket a típusok esetében. Az API-val végzett összes művelet HTTP POST-műveletek . Minden művelet hasznos adatokat fogad el. A hasznos adat egy JSON-objektum. Ez az objektum egyetlen tulajdonságot határoz meg. A tulajdonságkulcs az API által engedélyezett művelet neve. A támogatott műveletek a PUT, AZ UPDATE és a DELETE.

Modellbeállítások API

A Modellbeállítások API a TimeSeriesIds által automatikusan létrehozott modelleken engedélyezi a CREATE, READ, UPDATE és DELETE parancsot.

API Leírás
Modellbeállítások API lekérése A TimeSeriesIds környezetében az automatikusan létrehozott modellt adja vissza.
Modellbeállítások API frissítése Frissítések a timeSeriesIds környezetbeli modelljét a kérelemben megadott új értékekkel.

Keresési funkciók

Helyettesítő karakterek keresése

Támogatjuk az egy- és több karakteres helyettesítő karakterek keresését egyetlen kifejezésen belül (nem a kifejezéskeresésekben).

Egyetlen karakter

Egyetlen karakteres helyettesítő karakterek kereséséhez használja a ? szimbólumot. Az egy karakteres helyettesítő karakteres keresés olyan kifejezéseket keres, amelyek megfelelnek a sztringnek a lecserélt karakterrel.

A vagy testa kifejezésre való text kereséshez keressen a következőre: te?t.

Több karakter

Több karakteres helyettesítő karakteres keresés végrehajtásához használja a * szimbólumot. Több karakteres helyettesítő karakterek keresése nulla vagy több karaktert keres.

A , vagy kifejezés kereséséhez testhasználja a következőt: test*.testertests

A kifejezés közepén található helyettesítő kereséseket is használhatja. A kereséshez dryerhasználja a következőt: dr*r.

Logikai operátorok

A logikai operátorok lehetővé teszik, hogy a kifejezések logikai operátorokkal kombinálhatók legyenek. Az AND, OR, , +-, és NEM logikai operátorokat támogatjuk.

Fontos

  • A logikai operátoroknak az ALL CAPS-ben kell lenniük.
  • A logikai operátorokat fehér szóközökkel kell elválasztani a keresési záradékoktól.
  • dryer AND washer érvényes, de nem dryer ANDwasher.

AND operátor

Az AND operátor megegyezik azokkal a dokumentumokkal, ahol mindkét kifejezés egyetlen dokumentum szövegében bárhol megtalálható.

A keresést tartalmazó dryer washer és foo bar azt használó dokumentumok keresése: dryer washer AND foo bar.

Megjegyzés

A szimbólum && az ÉS operátor helyett használható.

VAGY operátor

Az OR operátor két kifejezést csatol, és megkeresi a megfelelő dokumentumot, ha valamelyik kifejezés létezik egy dokumentumban. Az OR operátor az alapértelmezett kötőoperátor. Ez azt jelenti, hogy ha két kifejezés között nincs logikai operátor, akkor az OR operátort használja a rendszer.

Az alábbi keresések bármelyikét tartalmazó dryer washerdryer dokumentumok kereséséhez:

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

Megjegyzés

A szimbólum || a VAGY operátor helyett használható.

+ Operátor

A + vagy a kötelező operátornak azt kell megadnia, hogy a + szimbólum utáni kifejezés egy dokumentum egy mezőjében található valahol.

Ha olyan dokumentumokat szeretne keresni, amelyeknek tartalmazniuk dryer kell és tartalmazhatnak washer , használja a következő keresést: +dryer washer.

-Üzemeltető

A - vagy a tiltó operátor kizárja a szimbólum utáni - kifejezést tartalmazó dokumentumokat.

Olyan dokumentumok kereséséhez, amelyek tartalmazzák dryer washer , de nem foo bar használják a keresést: dryer washer -foo bar.

Tagadás

A NOT operátor kizárja a következő kifejezést NOTtartalmazó dokumentumokat: .

Olyan dokumentumok kereséséhez, amelyek tartalmazzák dryer washer , de nem foo bar használják a keresést: dryer washer NOT foo bar.

A NOT operátor nem használható egyetlen kifejezéssel.

A következő keresés nem ad vissza eredményt: NOT dryer washer.

Megjegyzés

A szimbólum ! a NEM operátor helyett használható.

  • Közvetlenül a kizárt keresési kifejezés előtt kell szerepelnie.
  • dryer !washer érvényes, de nem dryer ! washer.

Lásd még

  • További információ az alkalmazásregisztrációról és az Azure Active Directory programozási modellről: Azure Active Directory fejlesztőknek.

  • A kérelem és a hitelesítési paraméterek megismeréséhez olvassa el a Hitelesítés és engedélyezés című témakört.

  • A HTTP-kérések és -válaszok tesztelését segítő eszközök a következők:

  • Fiddler. Ez az ingyenes webes hibakeresési proxy elfoghatja a REST-kéréseket, így diagnosztizálhatja a HTTP-kéréseket és a válaszüzeneteket.

  • JWT.io. Ezzel az eszközzel gyorsan kiadhatja a jogcímeket a tulajdonosi jogkivonatban, majd ellenőrizheti azok tartalmát.

  • Postman. Ez egy ingyenes HTTP-kérés- és választesztelési eszköz a REST API-k hibakereséséhez.

  • A Gen2 Azure Time Series Insights a Gen2 dokumentációjában talál további információt.