REST Resource: projects.locations.operations

Risorsa: Operazione

Questa risorsa rappresenta un'operazione a lunga esecuzione che è il risultato di una chiamata API di rete.

Rappresentazione JSON 
{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field result.
}
Campi
name

string

Il nome assegnato dal server, che è univoco solo all'interno dello stesso servizio che lo restituisce originariamente. Se utilizzi la mappatura HTTP predefinita, name deve essere un nome di risorsa che termina con operations/{uniqueId}.
metadata

object

{

createTime: l'ora in cui è stata creata l'operazione.

endTime: l'ora in cui è terminata l'esecuzione dell'operazione.

target: percorso della risorsa definita dal server per la destinazione dell'operazione.

verb: il nome del verbo eseguito dall'operazione.

statusDetail: lo stato dell'operazione leggibile da una persona, se presente.

cancelRequested: indica se l'utente ha richiesto l'annullamento dell'operazione. Le operazioni annullate correttamente hanno il valore Operation.error con un google.rpc.Status.code pari a 1, corrispondente a Code.CANCELLED.

apiVersion: versione dell'API utilizzata per avviare l'operazione.

}
done

boolean

Se il valore è false, significa che l'operazione è ancora in corso. Se true, l'operazione viene completata ed è disponibile error o response.
Campo unione result. Il risultato dell'operazione, che può essere un error o un response valido. Se done == false, non è impostato né error né response. Se done == true, è possibile impostare esattamente uno dei valori error o response. Alcuni servizi potrebbero non fornire il risultato. result può essere solo uno dei seguenti:
error

object (Status)

Il risultato dell'errore dell'operazione in caso di errore o annullamento.
response

object

La risposta normale e riuscita dell'operazione. Se il metodo originale non restituisce dati in caso di esito positivo, ad esempio Delete, la risposta è google.protobuf.Empty. Se il metodo originale è standard Get/Create/Update, la risposta deve essere la risorsa. Per gli altri metodi, la risposta deve avere il tipo XxxResponse, dove Xxx è il nome del metodo originale. Ad esempio, se il nome del metodo originale è TakeSnapshot(), il tipo di risposta dedotto è TakeSnapshotResponse.

Metodi

cancel

 Avvia l'annullamento asincrono di un'operazione a lunga esecuzione.

delete

 Elimina un'operazione a lunga esecuzione.

get

 Recupera lo stato più recente di un'operazione a lunga esecuzione.

list

 Elenca le operazioni che corrispondono al filtro specificato nella richiesta.