Operations

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] O valor de "requestId", se você o forneceu na solicitação. Caso contrário, não está presente.
creationTimestamp string [Descontinuado] Este campo foi descontinuado.
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á no 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, esse campo vai conter a mensagem de erro HTTP que foi 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á no 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] O 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. É necessário especificar esse campo como parte do URL da solicitação HTTP. Ele não pode ser definido como um campo no corpo da solicitação.
startTime string [Somente saída] Hora em que a operação foi iniciada pelo servidor. Esse valor está no 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. 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, para avisos em que não há resultados em uma solicitação de lista para uma zona específica, essa chave pode ser scope e o valor da chave pode ser 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. É necessário especificar esse campo como parte do URL da solicitação HTTP. Ele não pode ser definido como um campo no corpo da solicitação.

Métodos

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