Operações

Uma operação rastreia o status de todas as solicitações que modificam os dados e retorna para cada solicitação que altera quaisquer recursos.

Para ver uma lista dos métodos desse recurso, consulte o final desta página.

Representações de recursos

Um recurso de operação usado para gerenciar solicitações de API assíncronas.

{
  "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 da propriedade Valor Descrição Observações
clientOperationId string [Somente saída] Reservado para uso futuro.
creationTimestamp string [Somente saída] Timestamp de criação no formato de texto RFC3339.
description string [Somente saída] Uma descrição textual da operação, configurada quando a operação foi criada.
endTime string [Somente saída] Hora em que a operação foi concluída. Esse valor está em formato de texto RFC3339.
error object [Somente saída] Se forem gerados erros durante o processamento da operação, este campo será preenchido.
error.errors[] list [Somente saída] A matriz de erros encontrados durante o processamento dessa operação.
error.errors[].code string [Somente saída] O código do tipo desse erro.
error.errors[].location string [Somente saída] Indica o campo na solicitação que causou o erro. Esta propriedade é opcional.
error.errors[].message string [Somente saída] Uma mensagem de erro opcional, legível.
httpErrorMessage string [Somente saída] Se a operação falhar, este campo conterá a mensagem de erro HTTP retornada como NOT FOUND.
httpErrorStatusCode integer [Somente saída] Se a operação falhar, este campo conterá o código de status de erro HTTP retornado. Por exemplo, um 404 significa que o recurso não foi encontrado.
id unsigned long [Somente saída] Código único do recurso. Definido pelo servidor.
insertTime string [Somente saída] Hora em que a operação foi solicitada. Esse valor está em formato de texto RFC3339.
kind string [Somente saída] Tipo do recurso. Sempre compute#operation para recursos de operação.
name string [Somente saída] Nome do recurso.
operationType string [Somente saída] Tipo de operação, como insert, update ou delete, e assim por diante.
progress integer [Somente saída] Um indicador de progresso opcional que varia de 0 a 100. Não há nenhuma exigência de que seja linear nem tenha compatibilidade com qualquer granularidade de operações. Não use este indicador para adivinhar quando a operação será concluída. O número precisa aumentar uniformemente à medida que a operação progride.
region string [Somente saída] URL da região onde reside a operação. Somente disponível na execução de operações regionais.
startTime string [Somente saída] Hora em que a operação foi iniciada pelo servidor. Esse valor está em formato de texto RFC3339.
status string [Somente saída] Status da operação, que pode ser um dos seguintes: PENDING, RUNNING ou DONE.
statusMessage string [Somente saída] Uma descrição textual opcional do status atual da operação.
targetId unsigned long [Somente saída] Código único de destino, que identifica uma concretização específica do recurso de destino.
user string [Somente saída] Usuário que solicitou a operação, por exemplo: user@example.com.
warnings[] list [Somente saída] Se forem geradas mensagens de aviso durante o processamento da operação, este campo será preenchido.
warnings[].code string [Somente saída] Um código de aviso, se aplicável. Por exemplo, o código NO_RESULTS_ON_PAGE é retornado no Compute Engine quando não há resultados na resposta.
warnings[].data[] list [Somente saída] Metadados sobre esse aviso no formato key: value. Por exemplo:

"data": [ { "key": "scope", "value": "zones/us-east1-d" }
warnings[].data[].key string [Somente saída] Uma chave que fornece mais detalhes sobre o aviso retornado. Por exemplo, no caso de avisos de que não há resultados em uma solicitação de lista de uma determinada zona, essa chave corresponde ao scope e o valor dessa chave é o nome da zona. Outros exemplos podem ser uma chave indicando um recurso com uso suspenso e uma substituição sugerida, ou um aviso sobre configurações de rede inválidas. Por exemplo, se uma instância tenta executar o encaminhamento de IP, mas não é ativada pelo encaminhamento.
warnings[].data[].value string [Somente saída] Um valor de dados do aviso correspondente à chave.
warnings[].message string [Somente saída] Uma descrição legível do código de advertência.
zone string [Somente saída] URL da zona onde reside a operação. Só disponível durante a execução de operações por zona.

Métodos

get
Recebe informações sobre uma operação específica.
list
Lista todas as operações de um projeto.