@azure/core-lro package

Motore LRO, classe che esegue il polling.

Classe che rappresenta la definizione di un programma che esegue il polling tramite richieste consecutive fino a quando non raggiunge uno stato di completamento.

Un poller può essere eseguito manualmente, eseguendo il polling della richiesta tramite richiesta chiamando ripetutamente il metodo, fino al completamento dell'operazione poll() . Fornisce anche un modo per attendere il completamento dell'operazione, chiamando pollUntilDone() e aspettando il completamento dell'operazione. I poller possono anche richiedere l'annullamento del processo in corso a cui viene fornito l'operazione a esecuzione prolungata sottostante.

const poller = new MyPoller();

// Polling just once:
await poller.poll();

// We can try to cancel the request here, by calling:
//
//     await poller.cancelOperation();
//

// Getting the final result:
const result = await poller.pollUntilDone();

Il poller è definito da due tipi, un tipo che rappresenta lo stato del poller, che deve includere un set di proprietà di base da PollOperationState<TResult>e un tipo restituito definito da TResult, che può essere qualsiasi elemento.

La classe Poller implementa l'interfaccia PollerLike , che consente l'implementazione del poller per evitare di dover esportare direttamente la classe di Poller ed esportare solo il poller già creato con il tipo PollerLike.

class Client {
  public async makePoller: PollerLike<MyOperationState, MyResult> {
    const poller = new MyPoller({});
    // It might be preferred to return the poller after the first request is made,
    // so that some information can be obtained right away.
    await poller.poll();
    return poller;
  }
}

const poller: PollerLike<MyOperationState, MyResult> = myClient.makePoller();

Un poller può essere creato tramite il relativo costruttore, quindi può essere eseguito il polling fino al completamento. In qualsiasi momento, lo stato del poller può essere ottenuto senza ritardo tramite il metodo getOperationState. In qualsiasi momento, le forme intermedie del tipo di risultato possono essere richieste senza ritardo. Una volta completata l'operazione sottostante, il poller si arresterà e il valore finale verrà restituito.

const poller = myClient.makePoller();
const state: MyOperationState = poller.getOperationState();

// The intermediate result can be obtained at any time.
const result: MyResult | undefined = poller.getResult();

// The final result can only be obtained after the poller finishes.
const result: MyResult = await poller.pollUntilDone();

Quando l'operazione viene annullata, il poller verrà rifiutato con un'istanza del PollerCancelledError.

Quando un poller viene arrestato manualmente tramite il stopPolling metodo, il poller verrà rifiutato con un'istanza di PollerStoppedError.

Opzioni per createPoller.

Descrizione di un'operazione a esecuzione prolungata.

Opzioni per il poller LRO.

Tipo della risposta di un LRO.

Mentre il poller funziona come meccanismo di controllo locale per avviare l'attivazione e attendere un'operazione a esecuzione prolungata, OperationState documenta lo stato dell'operazione a esecuzione prolungata remota. Viene aggiornato dopo ogni polling.

PollOperation è un'interfaccia che definisce come aggiornare il riferimento locale dello stato dell'operazione a esecuzione prolungata remota, oltre a come richiedere l'annullamento della stessa operazione.

Ha anche un metodo per serializzare l'operazione in modo che possa essere archiviato e ripreso in qualsiasi momento.

PollOperationState contiene un elenco di opinioni del set più piccolo di proprietà necessarie per definire qualsiasi poller di operazione a esecuzione prolungata.

Mentre la classe Poller funziona come meccanismo di controllo locale per avviare l'attivazione, attendere e annullare potenzialmente un'operazione a esecuzione prolungata, pollOperationState documenta lo stato dell'operazione a esecuzione prolungata remota.

Deve essere aggiornato almeno all'avvio dell'operazione, al termine dell'operazione e al momento dell'annullamento. Tuttavia, le implementazioni possono avere qualsiasi altro numero di proprietà che possono essere aggiornate da altri motivi.

Rappresentazione astratta di un poller, destinata a esporre solo l'API minima con cui l'utente deve lavorare.

Tipo semplice della risposta non elaborata.

Interfaccia semplice del poller.

CancelOnProgress viene usato come valore restituito del metodo onProgress di Un Poller. Quando un utente richiama onProgress, è necessario passare una funzione che verrà chiamata come callback con i nuovi dati ricevuti ogni volta che l'operazione di polling viene aggiornata. onProgress restituisce una funzione che impedirà un ulteriore aggiornamento per raggiungere il callback originale.

Posizione potenziale del risultato dell'LRO se specificata dall'estensione LRO nel swagger.

Il set di possibili stati un'operazione può trovarsi in qualsiasi momento.

PollProgressCallback è il tipo delle funzioni di callback inviate a onProgress. Queste funzioni riceveranno un TState definito dall'implementazione della classe Poller.

Crea un poller che può essere usato per eseguire il polling di un'operazione a esecuzione prolungata.