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
`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.
`selfLink`	`string`	[Somente saída] URL definido pelo servidor para o recurso.
`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.
`targetLink`	`string`	[Somente saída] URL do recurso modificado pela operação. Em operações relacionadas à criação de um instantâneo, isso aponta para o disco permanente do qual o instantâneo foi criado.
`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.