Recurso da REST: projects.locations.operations

Recurso: operação

Este recurso representa uma operação de longa duração resultante de uma chamada à API de rede.

Representação JSON 

{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object(Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field result.
}
Campos
name

string

O nome atribuído pelo servidor, que é exclusivo somente no mesmo serviço que o retorna originalmente. Quando você usa o mapeamento HTTP padrão, o name tem o formato operations/some/unique/name.

metadata

object

{

createTime: hora em que a operação foi criada.

endTime: hora em que a operação terminou de ser executada.

target: caminho do recurso definido pelo servidor para o destino da operação.

verb: nome do verbo executado pela operação.

statusDetail: status legível da operação, caso haja um.

cancelRequested: identifica se o usuário solicitou o cancelamento da operação. As operações que foram canceladas com sucesso têm o valor Operation.error com um google.rpc.Status.code de 1, correspondente a Code.CANCELLED.

apiVersion: versão da API usada para iniciar a operação.

}
done

boolean

Se o valor for false é porque a operação continua em andamento. Se for true, a operação já foi concluída, e error ou response estão disponíveis.

Campo de união result. O resultado da operação, que pode ser um error ou uma response válida. Se done == false, nem error nem response é definido. Se done == true, exatamente um error ou response é definido. O result será somente um dos seguintes:
error

object(Status)

O resultado do erro da operação em caso de falha ou cancelamento.

response

object

A resposta normal da operação, em caso de êxito. Se o método original não retornar dados de êxito, como Delete, a resposta será google.protobuf.Empty. Quando esse método é um Get/Create/Update padrão, a resposta é o recurso. Em outros métodos, ela é do tipo XxxResponse, onde Xxx é o nome do método original. Por exemplo, se o nome do método for TakeSnapshot(), o tipo de resposta deduzido será TakeSnapshotResponse.

Métodos

cancel

 Inicia o cancelamento assíncrono de uma operação de longa duração.

delete

 Exclui uma operação de longa duração.

get

 Recebe o estado mais recente de uma operação de longa duração.

list

 Lista as operações correspondentes ao filtro especificado na solicitação.