Operations

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

Rappresentazioni delle risorse

Rappresenta una risorsa Operation.

Google Compute Engine dispone di tre risorse Operation:


Puoi utilizzare una risorsa di operazione per gestire le richieste API asincrone. Per ulteriori informazioni, consulta la sezione Gestione delle risposte dell'API.

Le operazioni possono essere globali, regionali o zonali.
  • Per le operazioni globali, utilizza la risorsa "globalOperations".
  • Per le operazioni a livello di regione, utilizza la risorsa "regionOperations".
  • Per le operazioni zonali, utilizza la risorsa "zonalOperations".


Per ulteriori informazioni, leggi Risorse globali, regionali e a livello di zona.

{
  "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 "NON TROVATO".
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 codice "404" indica che la risorsa non è stata trovata.
id unsigned long [Solo output] L'identificatore univoco dell'operazione. 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 dell'operazione.
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. Applicabile solo quando vengono eseguite operazioni a livello di regione.
startTime string [Solo output] Data e ora di inizio dell'operazione da parte del 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] L'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 ci sono 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 possono 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 il forwarding IP).
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. Applicabile solo quando vengono eseguite operazioni per zona.

Metodi

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