Operations

Un'operazione monitora lo stato di tutte le richieste che modificano i dati. Viene restituita un'operazione per ogni richiesta che modifica le risorse.

Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.

Rappresentazioni delle risorse

Una risorsa Operation, utilizzata per gestire le richieste API asincrone.

{
  "kind": "deploymentmanager#operation",
  "id": unsigned long,
  "creationTimestamp": string,
  "name": string,
  "zone": string,
  "clientOperationId": string,
  "operationType": string,
  "targetLink": string,
  "targetId": unsigned long,
  "status": string,
  "statusMessage": string,
  "user": string,
  "progress": integer,
  "insertTime": string,
  "startTime": string,
  "endTime": string,
  "error": {
    "errors": [
      {
        "code": string,
        "location": string,
        "message": string
      }
    ]
  },
  "warnings": [
    {
      "code": string,
      "message": string,
      "data": [
        {
          "key": string,
          "value": string
        }
      ]
    }
  ],
  "httpErrorStatusCode": integer,
  "httpErrorMessage": string,
  "selfLink": string,
  "region": string,
  "description": string
}
Nome proprietà Valore Descrizione Note
clientOperationId string [Solo output] Il valore di "requestId", se lo hai fornito nella richiesta. Non presente negli altri casi.
creationTimestamp string [Ritiro] Questo campo è stato ritirato.
description string [Solo output] Una descrizione testuale dell'operazione, impostata al momento della creazione.
endTime string [Solo output] Data e ora del completamento dell'operazione. Questo valore è nel formato di testo RFC3339.
error object [Solo output] Se vengono generati errori durante l'elaborazione dell'operazione, questo campo verrà compilato.
error.errors[] list [Solo output] L'array di errori riscontrati durante l'elaborazione di questa operazione.
error.errors[].code string [Solo output] L'identificatore del tipo di errore per questo errore.
error.errors[].location string [Solo output] Indica il campo della richiesta che ha causato l'errore. Questa proprietà è facoltativa.
error.errors[].message string [Solo output] Un messaggio di errore facoltativo leggibile.
httpErrorMessage string [Solo output] Se l'operazione non va a buon fine, questo campo contiene il messaggio di errore HTTP restituito, ad esempio NOT FOUND.
httpErrorStatusCode integer [Solo output] Se l'operazione non va a buon fine, questo campo contiene il codice di stato di errore HTTP restituito. Ad esempio, un 404 indica che la risorsa non è stata trovata.
id unsigned long [Solo output] L'identificatore univoco della risorsa. Questo identificatore è definito dal server.
insertTime string [Solo output] La data e l'ora in cui è stata richiesta questa operazione. Questo valore è nel formato di testo RFC3339.
kind string [Solo output] Tipo di risorsa. Sempre compute#operation per le risorse Operation.
name string [Solo output] Nome della risorsa.
operationType string [Solo output] Il tipo di operazione, ad esempio insert, update o delete e così via.
progress integer [Solo output] Un indicatore di avanzamento facoltativo compreso tra 0 e 100. Non è necessario che sia lineare o supporti qualsiasi granularità delle operazioni. Questo valore non deve essere utilizzato per prevedere quando l'operazione sarà completata. Questo numero dovrebbe aumentare in modo monotono man mano che l'operazione procede.
region string [Solo output] L'URL della regione in cui si trova l'operazione. Disponibile solo quando vengono eseguite operazioni a livello di regione. Devi specificare questo campo nell'URL della richiesta HTTP. Non può essere impostato come campo nel corpo della richiesta.
startTime string [Solo output] L'ora in cui questa operazione è stata avviata dal server. Questo valore è nel formato di testo RFC3339.
status string [Solo output] Lo stato dell'operazione, che può essere uno dei seguenti: PENDING, RUNNING o DONE.
statusMessage string [Solo output] Una descrizione testuale facoltativa dello stato corrente dell'operazione.
targetId unsigned long [Solo output] L'ID target univoco, che identifica una specifica incarnazione della risorsa di destinazione.
user string [Solo output] Utente che ha richiesto l'operazione, ad esempio: user@example.com.
warnings[] list [Solo output] Se durante l'elaborazione dell'operazione vengono generati messaggi di avviso, questo campo verrà compilato.
warnings[].code string [Solo output] Un codice di avviso, se applicabile. Ad esempio, Compute Engine restituisce NO_RESULTS_ON_PAGE se non sono presenti risultati nella risposta.
warnings[].data[] list [Solo output] Metadati relativi a questo avviso in formato key: value. Ad esempio: 
"data": [ { "key": "scope", "value": "zones/us-east1-d" }
warnings[].data[].key string [Solo output] Una chiave che fornisce ulteriori dettagli sull'avviso restituito. Ad esempio, per gli avvisi in cui non sono presenti risultati in una richiesta di elenco per una determinata zona, questa chiave potrebbe essere scope e il valore della chiave potrebbe essere il nome della zona. Altri esempi potrebbero essere una chiave che indica una risorsa deprecata e una sostituzione suggerita oppure un avviso relativo a impostazioni di rete non valide (ad esempio, se un'istanza tenta di eseguire il forwarding IP, ma non è abilitata per questo).
warnings[].data[].value string [Solo output] Un valore di dati di avviso corrispondente alla chiave.
warnings[].message string [Solo output] Una descrizione leggibile del codice di avviso.
zone string [Solo output] L'URL della zona in cui si trova l'operazione. Disponibile solo quando vengono eseguite operazioni per zona. Devi specificare questo campo nell'URL della richiesta HTTP. Non può essere impostato come campo nel corpo della richiesta.

Metodi

get
Ottiene informazioni su un'operazione specifica.
list
Elenca tutte le operazioni per un progetto.