Package google.longrunning

Indeks

Operacje

Zarządza długo trwającymi operacjami za pomocą usługi interfejsu API.

Jeśli wykonanie metody interfejsu API zazwyczaj trwa długo, można ją tak skonfigurować, aby zwracała kod Operation do klienta, a klient może użyć tego interfejsu do asynchronicznego odpytywania zasobu operacji lub przekazać go do innego interfejsu API (takiego jak interfejs Pub/Sub API) w celu otrzymania odpowiedzi. Każda usługa interfejsu API, która zwraca długotrwałe operacje, powinna implementować interfejs Operations, aby zapewnić klientom spójne wrażenia.

CancelOperation

rpc CancelOperation(CancelOperationRequest) returns (Empty)

Rozpoczyna asynchroniczne anulowanie długotrwałej operacji. Serwer stara się anulować operację, ale nie jest to gwarantowane. Jeśli serwer nie obsługuje tej metody, zwraca wartość google.rpc.Code.UNIMPLEMENTED. Klienci mogą użyć Operations.GetOperation lub innych metod, aby sprawdzić, czy anulowanie się powiodło lub czy operacja została zakończona pomimo anulowania. Po anulowaniu operacji nie jest ona usuwana. Zamiast tego staje się operacją z wartością Operation.error i wartością google.rpc.Status.code = 1 odpowiadającą operacji Code.CANCELLED.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc DeleteOperation(DeleteOperationRequest) returns (Empty)

Usuwa długo działającą operację. Ta metoda wskazuje, że klient nie jest już zainteresowany wynikiem operacji. Nie anuluje to operacji. Jeśli serwer nie obsługuje tej metody, zwraca wartość google.rpc.Code.UNIMPLEMENTED.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc GetOperation(GetOperationRequest) returns (Operation)

Pobiera najnowszy stan długo trwającej operacji. Klienci mogą używać tej metody do sondowania wyniku operacji w odstępach czasowych zgodnie z zaleceniami usługi API.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Wymaga tych uprawnień IAM do zasobu name:

  • routeoptimization.operations.get

Więcej informacji znajdziesz w dokumentacji usługi IAM.
ListOperations

rpc ListOperations(ListOperationsRequest) returns (ListOperationsResponse)

Wypisuje operacje pasujące do określonego w żądaniu filtra. Jeśli serwer nie obsługuje tej metody, zwraca wartość UNIMPLEMENTED.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc WaitOperation(WaitOperationRequest) returns (Operation)

Czeka, aż określona długotrwała operacja zostanie zakończona lub osiągnie maksymalny określony czas oczekiwania, zwracając najnowszy stan. Jeśli operacja została już wykonana, natychmiast zwracany jest najnowszy stan. Jeśli podany limit czasu jest dłuższy niż domyślny limit czasu HTTP/RPC, używany jest limit czasu HTTP/RPC. Jeśli serwer nie obsługuje tej metody, zwraca wartość google.rpc.Code.UNIMPLEMENTED. Pamiętaj, że ta metoda działa zgodnie z zasadą możliwie najlepszej obsługi. Może zwrócić najnowszy stan przed określonym czasem oczekiwania (w tym natychmiast), co oznacza, że nawet natychmiastowa odpowiedź nie gwarantuje, że operacja została wykonana.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

CancelOperationRequest

Wiadomość z prośbą o Operations.CancelOperation.

Pola
name

string

Nazwa zasobu operacji, który ma zostać anulowany.

DeleteOperationRequest

Wiadomość z prośbą o Operations.DeleteOperation.

Pola
name

string

Nazwa zasobu operacji, który ma zostać usunięty.

GetOperationRequest

Wiadomość z prośbą o Operations.GetOperation.

Pola
name

string

Nazwa zasobu operacji.

ListOperationsRequest

Wiadomość z prośbą o Operations.ListOperations.

Pola
name

string

Nazwa zasobu nadrzędnego operacji.
filter

string

Standardowy filtr listy.
page_size

int32

Standardowy rozmiar strony listy.
page_token

string

Standardowy token strony listy.

ListOperationsResponse

Wiadomość z odpowiedzią dotyczącą Operations.ListOperations.

Pola
operations[]

Operation

Lista operacji pasujących do określonego w żądaniu filtra.
next_page_token

string

Standardowy token następnej strony listy.

Operacja

Ten zasób reprezentuje długotrwałą operację, która jest wynikiem wywołania interfejsu API sieci.

Pola
name

string

Nazwa przypisana przez serwer, która jest unikalna tylko w obrębie tej samej usługi, która pierwotnie została zwrócona. Jeśli używasz domyślnego mapowania HTTP, pole name powinno być nazwą zasobu kończącą się na operations/{unique_id}.
metadata

Any

Metadane specyficzne dla usługi powiązane z operacją. Zwykle zawiera informacje o postępach i powszechnie używane metadane, takie jak czas utworzenia. Niektóre usługi mogą nie udostępniać takich metadanych. Każda metoda zwracająca długotrwałą operację powinna dokumentować typ metadanych (jeśli występuje).
done

bool

Jeśli wartość to false, oznacza to, że operacja jest nadal w toku. Jeśli true, operacja została zakończona, a dostępne jest pole error lub response.
Pole unii result. Wynik operacji, którym może być error lub prawidłowy response. Jeśli done = false, ani error, ani response nie są ustawione. Jeśli done = true, można ustawić dokładnie jedną wartość error lub response. Niektóre usługi mogą nie dawać oczekiwanych rezultatów. result może mieć tylko jedną z tych wartości:
error

Status

Wynik błędu operacji w przypadku niepowodzenia lub anulowania.
response

Any

Normalna, udana odpowiedź operacji. Jeśli pierwotna metoda nie zwraca żadnych danych o sukcesie, np. Delete, odpowiedź to google.protobuf.Empty. Jeśli oryginalna metoda to standardowa Get/Create/Update, odpowiedzią powinna być dana usługa. W przypadku innych metod odpowiedź powinna mieć typ XxxResponse, gdzie Xxx to nazwa pierwotnej metody. Jeśli np. pierwotna nazwa metody to TakeSnapshot(), wywnioskowany typ odpowiedzi to TakeSnapshotResponse.

WaitOperationRequest

Wiadomość z prośbą o Operations.WaitOperation.

Pola
name

string

Nazwa zasobu operacji, na którym zostanie prowadzona operacja.
timeout

Duration

Maksymalny czas oczekiwania przed przekroczeniem limitu czasu. Jeśli pozostawisz to pole puste, czas oczekiwania będzie wynosił maksymalnie tyle, ile zezwala na to podstawowy protokół HTTP/RPC. Jeśli określony jest też termin RPC context, zostanie użyty krótszy termin.