Package google.longrunning

Índice

Operações

Operações de longa duração são gerenciadas com um serviço de API.

Quando um método de API leva muito tempo para ser concluído, ele pode ser configurado para retornar Operation ao cliente, que poderá usar essa interface para receber a resposta real de maneira assíncrona. Para fazer isso, o cliente precisará pesquisar o recurso de operação ou transmiti-lo para outra API, como a API Google Cloud Pub/Sub. Qualquer serviço de API que retorne operações de longa duração precisa implementar a interface de Operations para que os desenvolvedores possam ter uma experiência consistente como clientes.

GetOperation

rpc GetOperation(GetOperationRequest) returns (Operation)

Recebe o estado mais recente de uma operação de longa duração. Os clientes usam este método para pesquisar o resultado da operação em intervalos, conforme recomendado pelo serviço da API.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Para saber mais, consulte a Visão geral da autenticação.

GetOperationRequest

A mensagem de solicitação para Operations.GetOperation.

Campos
name

string

Nome do recurso de operação.

Operação

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

Campos
name

string

O nome atribuído pelo servidor, que é exclusivo somente no mesmo serviço que o retorna originalmente. Se você usar o mapeamento padrão de HTTP, name precisa ser um nome de recurso que termine com operations/{unique_id}.

metadata

Any

Metadados específicos do serviço associados à operação. Eles geralmente contêm informações sobre o progresso e metadados comuns, como a hora da criação. Em alguns serviços, esses metadados talvez não sejam fornecidos. Em qualquer método que retorne uma operação de longa duração, o tipo de metadados será documentado, se houver.

done

bool

Se o valor for false, significa que a operação ainda está em andamento. Se for true, a operação será concluída e error ou response estarã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 ou response estão definidos. Se done == true, apenas um entre error ou response está definido. result pode ser apenas de um dos tipos a seguir:
error

Status

Resultado do erro da operação em caso de falha ou cancelamento.
response

Any

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