Operations

Para obtener una lista de los métodos de este recurso, consulta el final de esta página.

Representaciones de recursos

Representa un recurso de operación.

Google Compute Engine tiene tres recursos de operación:


Puedes usar un recurso de operación para administrar solicitudes a la API asíncronas. Para obtener más información, consulta Cómo controlar las respuestas de la API.

Las operaciones pueden ser globales, regionales o zonales.
  • Para operaciones globales, usa el recurso "globalOperations".
  • Para las operaciones regionales, usa el recurso "regionOperations".
  • Para las operaciones zonales, usa el recurso "zonalOperations".


Para obtener más información, consulta Recursos globales, regionales y zonales.

{
  "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
}
Nombre de la propiedad Valor Descripción Notas
clientOperationId string [Solo salida] Es el valor de "requestId" si lo proporcionaste en la solicitud. De lo contrario, no está presente.
creationTimestamp string [Obsoleto] Este campo dejó de estar disponible.
description string [Solo salida] Es una descripción textual de la operación, que se establece cuando se crea.
endTime string [Solo salida] La hora en que se completó esta operación. Este valor está en formato de texto RFC3339.
error object [Solo salida] Si se generan errores durante el procesamiento de la operación, se completará este campo.
error.errors[] list [Solo salida] Es el array de errores que se encontraron durante el procesamiento de esta operación.
error.errors[].code string [Solo salida] Es el identificador de tipo de error de este error.
error.errors[].location string [Solo salida] Indica el campo de la solicitud que causó el error. Esta propiedad es opcional.
error.errors[].message string [Solo salida] Es un mensaje de error opcional legible por humanos.
httpErrorMessage string [Solo salida] Si la operación falla, este campo contiene el mensaje de error HTTP que se muestra, como “NO ENCONTRADO”.
httpErrorStatusCode integer [Solo salida] Si la operación falla, este campo contiene el código de estado de error HTTP que se muestra. Por ejemplo, un "404" significa que no se encontró el recurso.
id unsigned long [Solo salida] Es el identificador único de la operación. El servidor define este identificador.
insertTime string [Solo salida] La hora en que se solicitó esta operación. Este valor está en formato de texto RFC3339.
kind string [Solo salida] Tipo de recurso. Siempre "compute#operation" para los recursos de operación.
name string [Solo salida] Nombre de la operación.
operationType string [Solo salida] Es el tipo de operación, como "insert", "update" o "delete", etcétera.
progress integer [Solo salida] Es un indicador de progreso opcional que varía de 0 a 100. No es necesario que sea lineal ni que admita ningún nivel de detalle de las operaciones. No se debe usar para adivinar cuándo se completará la operación. Esta cantidad debe aumentar de forma monótona a medida que avanza la operación.
region string [Solo salida] La URL de la región en la que reside la operación. Solo se aplica cuando se realizan operaciones regionales.
startTime string [Solo salida] Es la hora en que el servidor inició esta operación. Este valor está en formato de texto RFC3339.
status string [Solo salida] Es el estado de la operación, que puede ser uno de los siguientes: "PENDING", "RUNNING" o "DONE".
statusMessage string [Solo salida] Es una descripción textual opcional del estado actual de la operación.
targetId unsigned long [Solo salida] El ID de destino único, que identifica una encarnación específica del recurso de destino.
user string [Solo salida] Es el usuario que solicitó la operación, por ejemplo, "user@example.com".
warnings[] list [Solo salida] Si se generan mensajes de advertencia durante el procesamiento de la operación, se completará este campo.
warnings[].code string [Solo salida] Un código de advertencia, si corresponde. Por ejemplo, Compute Engine muestra NO_RESULTS_ON_PAGE si no hay resultados en la respuesta.
warnings[].data[] list [Solo salida] Metadatos sobre esta advertencia en formato key: value. Por ejemplo: 
"data": [ { "key": "scope", "value": "zones/us-east1-d" }
warnings[].data[].key string [Solo salida] Es una clave que proporciona más detalles sobre la advertencia que se muestra. Por ejemplo, en el caso de las advertencias en las que no hay resultados en una solicitud de lista para una zona en particular, esta clave podría ser scope y el valor de la clave podría ser el nombre de la zona. Otros ejemplos pueden ser una clave que indica un recurso obsoleto y un reemplazo sugerido, o una advertencia sobre una configuración de red no válida (por ejemplo, si una instancia intenta realizar el reenvío de IP, pero no está habilitado para ello).
warnings[].data[].value string [Solo salida] Un valor de datos de advertencia que corresponde a la clave.
warnings[].message string [Solo salida] Es una descripción legible por humanos del código de advertencia.
zone string [Solo salida] La URL de la zona en la que reside la operación. Solo se aplica cuando se realizan operaciones por zona.

Métodos

get
Obtiene información sobre una operación específica.
lista
Enumera todas las operaciones de un proyecto.