Azure Time Series Insights Gen2-model-API's

Overzicht

Elk van de drie onderdelen die een Time Series-model maken (exemplaren, hiërarchieën en typen) hebben bijbehorende REST API's die ondersteuning bieden voor CREATE-, READ-, UPDATE- en DELETE-, gepagineerde en/of batchbewerkingen.

• De exemplaar-API ondersteunt gepagineerde GET-bewerkingen , batch-CREATE-, READ-, UPDATE- en DELETE-bewerkingen , zoek- en trefwoordsuggesties voor zoekbewerkingen.
• De Hierarchy-API ondersteunt gepagineerde GET-bewerkingen en batchbewerkingen maken, lezen, bijwerken en verwijderen .
• De Type-API ondersteunt gepagineerde GET-bewerkingen en batchbewerkingen maken, lezen, bijwerken en verwijderen .

Een vierde API biedt REST-ondersteuning voor Time Series Model-instellingen:

• De API voor modelinstellingen ondersteunt HTTP GET - en UPDATE-bewerkingen voor de configuratie-instellingen van het Time Series-model. Lees Time Series Model voor gedetailleerde informatie over Time Series Model en exemplaar, hiërarchie en typedefinities .

Api voor instanties

Met de INSTANCES-API kunnen CREATE-, READ-, UPDATE- en DELETE-bewerkingen worden uitgevoerd op Time Series-exemplaren:

• De API Instanties ophalen retourneert alle Time Series-exemplaren die overeenkomen met de aanvraag.

• De API Exemplaren beheren maakt batchbewerkingen op exemplaren mogelijk. Alle bewerkingen voor deze API zijn HTTP POST-bewerkingen. Elke bewerking accepteert een nettolading. De nettolading is een JSON-object. Dit object definieert één eigenschap. De eigenschapssleutel is de naam van een bewerking die is toegestaan door de API. Ondersteunde bewerkingen zijn PUT, UPDATE en DELETE.

• Met deze API's kunt u Time Series-exemplaren detecteren:

  • Met Suggestie worden scenario's voor automatisch aanvullen ingeschakeld tijdens het zoeken naar een exemplaar.
  • Zoeken helpt bij het identificeren van de exemplaren op basis van de opgegeven trefwoorden.

  Tip

  Meer informatie over functies voor zoekquery's hieronder.

Api voor hiërarchieën

Met de hiërarchie-API kunt u CREATE, READ, UPDATE en DELETE gebruiken voor Time Series-hiërarchieën.

API	Beschrijving
Api voor hiërarchieën ophalen	Retourneert alle Time Series-hiërarchieën die overeenkomen met de aanvraag.
Hiërarchie-API's beheren	Hiermee worden batchbewerkingen op hiërarchieën ingeschakeld. Alle bewerkingen voor deze API zijn HTTP POST-bewerkingen. Elke bewerking accepteert een nettolading. De nettolading is een JSON-object. Dit object definieert één eigenschap. De eigenschapssleutel is de naam van een bewerking die de API toestaat. Ondersteunde bewerkingen zijn PUT, UPDATE en DELETE.

Api voor typen

De TYPEN-API maakt CREATE, READ, UPDATE en DELETE mogelijk voor Time Series-typen en de bijbehorende variabelen.

API	Beschrijving
API voor typen ophalen	Retourneert alle Time Series-typen en de bijbehorende variabelen.
API voor posttypen	Hiermee worden batchbewerkingen voor typen ingeschakeld. Alle bewerkingen voor deze API zijn HTTP POST-bewerkingen. Elke bewerking accepteert een nettolading. De nettolading is een JSON-object. Dit object definieert één eigenschap. De eigenschapssleutel is de naam van een bewerking die de API toestaat. Ondersteunde bewerkingen zijn PUT, UPDATE en DELETE.

API voor modelinstellingen

Met de API voor modelinstellingen kunnen CREATE, READ, UPDATE en DELETE worden ingeschakeld voor automatisch gemaakte modellen in de omgeving door TimeSeriesIds.

API	Beschrijving
API voor modelinstellingen ophalen	Retourneert het automatisch gemaakte model in de omgeving voor TimeSeriesIds.
API voor modelinstellingen bijwerken	Updates het model in de omgeving voor TimeSeriesIds met de nieuwe waarden in de aanvraag.

Zoekfuncties

Zoekopdrachten met jokertekens

We ondersteunen zoekopdrachten met jokertekens met één en meerdere tekens binnen enkele termen (niet binnen zoekopdrachten met woordgroepen).

Eén teken

Als u een zoekactie met één teken met jokertekens wilt uitvoeren, gebruikt u het ? symbool. Met een jokerteken wordt gezocht naar termen die overeenkomen met de tekenreeks en het vervangen teken.

Als u wilt zoeken naar text of test, zoekt u: te?t.

Meerdere tekens

Als u een zoekactie met jokertekens met meerdere tekens wilt uitvoeren, gebruikt u het * symbool. Zoekopdrachten met meerdere jokertekens zoeken naar nul of meer tekens.

Als u wilt zoeken naar test, testsof tester, gebruikt u de zoekopdracht: test*.

U kunt ook de zoekopdrachten met jokertekens gebruiken in het midden van een term. Als u wilt zoeken naar dryer, kunt u de zoekopdracht gebruiken: dr*r.

Booleaanse operatoren

Met Booleaanse operators kunnen termen worden gecombineerd via logische operators. We ondersteunen AND, OR, +, -en NOT als Booleaanse operators.

Belangrijk

• Booleaanse operatoren moeten alle hoofdletters hebben.
• Booleaanse operatoren moeten worden gescheiden van zoekcomponenten met behulp van spaties.
• dryer AND washer is geldig, maar niet dryer ANDwasher.

AND-operator

De operator AND komt overeen met documenten waarbij beide termen overal in de tekst van één document voorkomen.

Als u wilt zoeken naar documenten die de zoekopdracht bevatten dryer washer en foo bar gebruiken: dryer washer AND foo bar.

Notitie

Het symbool && kan worden gebruikt in plaats van de operator AND.

OR-operator

De operator OR koppelt twee termen en zoekt een overeenkomend document als een van de termen in een document bestaat. De operator OR is de standaardoperator voor combinaties. Dit betekent dat als er geen Booleaanse operator tussen twee termen is, de operator OR wordt gebruikt.

Als u wilt zoeken naar documenten die een van de volgende zoekopdrachten dryer washer bevatten of gewoon dryer een van de volgende zoekopdrachten gebruiken:

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

Notitie

Het symbool || kan worden gebruikt in plaats van de operator OF.

+ Operator

De + vereiste operator of vereist dat de term na het + symbool ergens in een veld van één document voorkomt.

Als u wilt zoeken naar documenten die moeten en dryer kunnen bevatten washer , gebruikt u de zoekopdracht: +dryer washer.

-Operator

De - operator or prohibit sluit documenten uit die de term na het - symbool bevatten.

Als u wilt zoeken naar documenten die dryer washer wel bevatten, maar niet foo bar , gebruikt u de zoekfunctie: dryer washer -foo bar.

NOT

De operator NOT sluit documenten uit die de term na NOTbevatten.

Als u wilt zoeken naar documenten die dryer washer wel bevatten, maar deze niet foo bar gebruiken: dryer washer NOT foo bar.

De not-operator kan niet met slechts één term worden gebruikt.

De volgende zoekopdracht retourneert geen resultaten: NOT dryer washer.

Notitie

Het symbool ! kan worden gebruikt in plaats van de operator NOT.

• Deze moet onmiddellijk voorafgaan aan de uitgesloten zoekterm.
• dryer !washer is geldig, maar niet dryer ! washer.

Zie ook

• Zie Azure Active Directory voor ontwikkelaars voor meer informatie over toepassingsregistratie en het Azure Active Directory-programmeermodel.

• Lees Verificatie en autorisatie voor meer informatie over aanvraag - en verificatieparameters.

• Hulpprogramma's die helpen bij het testen van HTTP-aanvragen en -antwoorden zijn onder andere:

• Fiddler. Met deze gratis webopsporingsproxy kunt u uw REST-aanvragen onderscheppen, zodat u de HTTP-aanvraag- en antwoordberichten kunt diagnosticeren.

• JWT.io. U kunt dit hulpprogramma gebruiken om snel de claims in uw Bearer-token te dumpen en vervolgens de inhoud ervan te valideren.

• Postman. Dit is een gratis hulpprogramma voor het testen van HTTP-aanvragen en -antwoorden voor het opsporen van fouten in REST API's.

• Meer informatie over Azure Time Series Insights Gen2 vindt u in de Gen2-documentatie.