Risorsa: Operazione
Questa risorsa rappresenta un'operazione a lunga esecuzione che è il risultato di una chiamata all'API di rete.
Rappresentazione JSON |
---|
{ "name": string, "metadata": { "@type": string, field1: ..., ... }, "done": boolean, // Union field |
Campi | |
---|---|
name |
Il nome assegnato dal server, che è univoco solo all'interno dello stesso servizio che lo restituisce originariamente. Se utilizzi la mappatura HTTP predefinita, |
metadata |
Metadati specifici del servizio associati all'operazione. In genere contiene informazioni sull'avanzamento e metadati comuni come l'ora di creazione. Alcuni servizi potrebbero non fornire questi metadati. Qualsiasi metodo che restituisce un'operazione di lunga durata deve documentare il tipo di metadati, se presente. Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo |
done |
Se il valore è |
Campo unione result . Il risultato dell'operazione, che può essere un error o un response valido. Se done == false , non sono impostati né error né response . Se done == true , può essere impostato esattamente un valore tra error o response . Alcuni servizi potrebbero non fornire il risultato. result può essere solo uno dei seguenti: |
|
error |
Il risultato dell'errore dell'operazione in caso di errore o di annullamento. |
response |
La risposta normale e positiva dell'operazione. Se il metodo originale non restituisce dati in caso di esito positivo, ad esempio Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo |
Stato
Il tipo Status
definisce un modello di errore logico adatto a diversi ambienti di programmazione, tra cui API REST e API RPC. È utilizzato da gRPC. Ogni messaggio Status
contiene tre dati: codice, messaggio di errore e dettagli dell'errore.
Per scoprire di più su questo modello di errore e su come utilizzarlo, consulta la guida alla progettazione delle API.
Rappresentazione JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
Campi | |
---|---|
code |
Il codice di stato, che deve essere un valore enum pari a |
message |
Un messaggio di errore rivolto agli sviluppatori, che deve essere in inglese. Qualsiasi messaggio di errore rivolto agli utenti deve essere localizzato e inviato nel campo |
details[] |
Un elenco di messaggi che contengono i dettagli dell'errore. Esiste un insieme comune di tipi di messaggi che le API possono utilizzare. Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo |
Metodi |
|
---|---|
|
Avvia l'annullamento asincrono di un'operazione a lunga esecuzione. |
|
Elimina un'operazione a lunga esecuzione. |
|
Recupera lo stato più recente di un'operazione a lunga esecuzione. |
|
Elenca le operazioni corrispondenti al filtro specificato nella richiesta. |