API modello Azure Time Series Insights Gen2

Panoramica

Ognuno dei tre componenti che rendono un modello Time Series (istanze, gerarchie e tipi) hanno API REST corrispondenti che supportano le operazioni CREATE, READ, UPDATE e DELETE, impaginate e/o batch.

• L'API istanza supporta operazioni GET impaginate, batch CREATE, READ, UPDATE e DELETE operazioni, ricerca e suggerimenti per le parole chiave per le operazioni di ricerca.
• L'API Hierarchy supporta operazioni GET impaginate e operazioni CREATE, READ, UPDATE e DELETE.
• L'API Type supporta operazioni GET impaginate e operazioni CREATE, READ, UPDATE e DELETE.

Una quarta API offre il supporto REST per le impostazioni del modello Time Series:

• L'API Impostazioni modello supporta le operazioni HTTP GET e UPDATE per le impostazioni di configurazione del modello Time Series. Per informazioni dettagliate sul modello e sull'istanza, la gerarchia e le definizioni dei tipi, leggere Modello serie temporali.

API istanze

L'API Istanze consente di eseguire operazioni CREATE, READ, UPDATE e DELETE nelle istanze di Time Series:

• L'API Recupera istanze restituisce tutte le istanze di Time Series che corrispondono alla richiesta.

• L'API Gestisci istanze abilita le operazioni batch nelle istanze. Tutte le operazioni relative a questa API sono operazioni HTTP POST . Ogni operazione accetta un payload. Il payload è un oggetto JSON. Questo oggetto definisce una singola proprietà. La chiave della proprietà è il nome di un'operazione consentita dall'API. Le operazioni supportate sono PUT, UPDATE e DELETE.

• Queste API consentono l'individuazione delle istanze di Time Series:

  • Suggerisci di abilitare scenari di completamento automatico durante la ricerca di un'istanza.
  • La ricerca consente di identificare le istanze in base alle parole chiave fornite.

  Suggerimento

  Informazioni sulle funzionalità di query di ricerca riportate di seguito.

API gerarchie

L'API gerarchie abilita CREATE, READ, UPDATE e DELETE nelle gerarchie di Time Series.

API	Descrizione
Ottenere l'API gerarchie	Restituisce tutte le gerarchie time series che corrispondono alla richiesta.
Gestire le API gerarchie	Abilita le operazioni batch sulle gerarchie. Tutte le operazioni relative a questa API sono operazioni HTTP POST . Ogni operazione accetta un payload. Il payload è un oggetto JSON. Questo oggetto definisce una singola proprietà. La chiave della proprietà è il nome di un'operazione consentita dall'API. Le operazioni supportate sono PUT, UPDATE e DELETE.

API tipi

L'API Tipi abilita CREATE, READ, UPDATE e DELETE nei tipi di serie temporali e le variabili associate.

API	Descrizione
Ottenere l'API Tipi	Restituisce tutti i tipi di serie temporali e le variabili associate.
Post Types API	Abilita le operazioni batch sui tipi. Tutte le operazioni relative a questa API sono operazioni HTTP POST . Ogni operazione accetta un payload. Il payload è un oggetto JSON. Questo oggetto definisce una singola proprietà. La chiave della proprietà è il nome di un'operazione consentita dall'API. Le operazioni supportate sono PUT, UPDATE e DELETE.

API Impostazioni modello

L'API Impostazioni modello abilita CREATE, READ, UPDATE e DELETE nei modelli creati automaticamente dall'ambiente timeSeriesIds.

API	Descrizione
Ottenere l'API Impostazioni modello	Restituisce il modello creato automaticamente nell'ambiente per TimeSeriesIds.
Aggiornare l'API Impostazioni modello	Aggiornamenti il modello nell'ambiente per TimeSeriesIds con i nuovi valori forniti nella richiesta.

Funzionalità di ricerca

Ricerche con caratteri jolly

Sono supportate ricerche con caratteri jolly singoli e multipli all'interno di singoli termini (non all'interno delle ricerche di frasi).

Carattere singolo

Per eseguire una singola ricerca caratteri jolly, usare il ? simbolo. La ricerca carattere jolly singolo cerca i termini che corrispondono alla stringa con il singolo carattere sostituito.

Per cercare o test, cercare text : te?t.

Più caratteri

Per eseguire una ricerca con caratteri jolly multipli, usare il * simbolo. Più caratteri jolly cerca zero o più caratteri.

Per cercare test, testso tester, usare la ricerca: test*.

È anche possibile usare le ricerche con caratteri jolly al centro di un termine. Per cercare dryer, è possibile usare la ricerca: dr*r.

Operatori booleani

Gli operatori booleani consentono di combinare i termini tramite operatori logici. Supportiamo AND, OR, +, -e NOT come operatori booleani.

Importante

• Gli operatori booleani devono trovarsi in TUTTI I CAPS.
• Gli operatori booleani devono essere separati dalle clausole di ricerca usando spazi vuoti.
• dryer AND washer è valido ma non dryer ANDwasher.

Operatore AND

L'operatore AND corrisponde ai documenti in cui entrambi i termini esistono ovunque nel testo di un singolo documento.

Per cercare documenti contenenti dryer washer e foo bar usare la ricerca: dryer washer AND foo bar.

Nota

Il simbolo && può essere usato al posto dell'operatore AND.

Operatore OR

L'operatore OR collega due termini e trova un documento corrispondente se esistono uno dei termini in un documento. L'operatore OR è l'operatore di combinazione predefinito. Ciò significa che se non è presente alcun operatore booleano tra due termini, viene usato l'operatore OR .

Per cercare documenti che contengono dryer washer o usare solo dryer una delle ricerche seguenti:

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

Nota

Il simbolo || può essere usato al posto dell'operatore OR.

Operatore +

L'operatore + o obbligatorio richiede che il termine dopo che il + simbolo esista in un campo di un singolo documento.

Per cercare documenti che devono contenere e possono contenere dryerwasher la ricerca: +dryer washer.

Operatore -

L'operatore - o vietato esclude i documenti che contengono il termine dopo il - simbolo.

Per cercare documenti contenenti dryer washer ma non foo bar usare la ricerca: dryer washer -foo bar.

NOT

L'operatore NOT esclude i documenti che contengono il termine dopo NOT.

Per cercare documenti che contengono dryer washer ma non foo bar usare la ricerca: dryer washer NOT foo bar.

L'operatore NOT non può essere utilizzato con un solo termine.

La ricerca seguente non restituirà alcun risultato: NOT dryer washer.

Nota

Il simbolo ! può essere usato al posto dell'operatore NOT.

• Deve precedere immediatamente il termine di ricerca escluso.
• dryer !washer è valido ma non dryer ! washer.

Vedi anche

• Per altre informazioni sulla registrazione dell'applicazione e sul modello di programmazione di Azure Active Directory, vedere Azure Active Directory per sviluppatori.

• Per informazioni sui parametri di richiesta e autenticazione, vedere Autenticazione e autorizzazione.

• Gli strumenti che consentono di testare richieste e risposte HTTP includono:

• Fiddler. Questo proxy di debug Web gratuito può intercettare le richieste REST, in modo da poter diagnosticare i messaggi di richiesta e risposta HTTP.

• JWT.io. È possibile usare questo strumento per eseguire rapidamente il dump delle attestazioni nel token di connessione e quindi convalidarne il contenuto.

• Postman. Si tratta di uno strumento gratuito di test delle richieste HTTP e delle risposte per il debug delle API REST.

• Per altre informazioni su Azure Time Series Insights Gen2, vedere la documentazione di Gen2.