Package google.longrunning

Dizin

İşlemler

API hizmetiyle uzun süreli işlemleri yönetir.

Normalde bir API yönteminin tamamlanması uzun sürdüğünde, istemciye Operation döndürecek şekilde tasarlanabilir. İstemci, işlem kaynağını sorgulayarak gerçek yanıtı eşzamansız olarak almak için bu arayüzü kullanabilir veya yanıtı almak için işlem kaynağını başka bir API'ye (ör. Pub/Sub API) iletebilir. Uzun süren işlemler döndüren tüm API hizmetleri, geliştiricilerin tutarlı bir istemci deneyimi yaşayabilmesi için Operations arayüzünü uygulamalıdır.

CancelOperation

rpc CancelOperation(CancelOperationRequest) returns (Empty)

(Şu anda desteklenmiyor) Uzun süreli bir işlemde eşzamansız iptal başlatır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc DeleteOperation(DeleteOperationRequest) returns (Empty)

(Şu anda desteklenmiyor) Uzun süreli bir işlemi siler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc GetOperation(GetOperationRequest) returns (Operation)

Uzun süreli bir işlemin en son durumunu bildirir. İstemciler bu yöntemi kullanarak API hizmetinin önerdiği aralıklarla işlem sonucunu sorgulayabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

name kaynağında aşağıdaki IAM iznini gerektirir:

  • routeoptimization.operations.get

Daha fazla bilgi için IAM belgelerini inceleyin.
ListOperations

rpc ListOperations(ListOperationsRequest) returns (ListOperationsResponse)

(Şu anda desteklenmiyor) İstekte belirtilen filtreyle eşleşen liste işlemlerini listeler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc WaitOperation(WaitOperationRequest) returns (Operation)

(Şu anda desteklenmiyor) Belirtilen uzun süreli işlem tamamlanana veya belirtilen zaman aşımı süresine ulaşana kadar bekler ve en son durumu döndürür.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

CancelOperationRequest

Operations.CancelOperation için istek mesajı.

Alanlar
name

string

İptal edilecek işlem kaynağının adı.

DeleteOperationRequest

Operations.DeleteOperation için istek mesajı.

Alanlar
name

string

Silinecek işlem kaynağının adı.

GetOperationRequest

Operations.GetOperation için istek mesajı.

Alanlar
name

string

İşlem kaynağının adı.

ListOperationsRequest

Operations.ListOperations için istek mesajı.

Alanlar
name

string

İşlemin üst kaynağının adı.
filter

string

Standart liste filtresi.
page_size

int32

Standart liste sayfa boyutu.
page_token

string

Standart liste sayfası jetonu.
return_partial_success

bool

true olarak ayarlandığında, erişilebilir işlemler normal şekilde döndürülür ve erişilemeyen işlemler ListOperationsResponse.unreachable alanında döndürülür.

Bu durum yalnızca koleksiyonlar arasında okuma yaparken true olabilir. Örneğin, parent, "projects/example/locations/-" olarak ayarlandığında.

Bu alan varsayılan olarak desteklenmez ve hizmete ya da ürüne özel dokümanlarda açıkça aksi belirtilmediği sürece ayarlanırsa UNIMPLEMENTED hatasına neden olur.

ListOperationsResponse

Operations.ListOperations için yanıt mesajı.

Alanlar
operations[]

Operation

İstekte belirtilen filtreyle eşleşen işlemlerin listesi.
next_page_token

string

Standart Liste sonraki sayfa jetonu.
unreachable[]

string

Sırasız liste. Ulaşılamayan kaynaklar. İstek, koleksiyonlar arasında ListOperationsRequest.return_partial_success ayarlandığında ve okunduğunda doldurulur. Örneğin, desteklenen tüm konumlardaki tüm kaynakları listelemeye çalışırken.

İşlem

Bu kaynak, bir ağ API çağrısının sonucu olan uzun süreli bir işlemi temsil eder.

Alanlar
name

string

Sunucu tarafından atanan ad. Yalnızca bu adı ilk kez sağlayan hizmet kapsamında benzersizdir. Varsayılan HTTP eşlemesini kullanıyorsanız name değeri, operations/{unique_id} ile biten bir kaynak adı olmalıdır.
metadata

Any

İşlemle ilişkilendirilen, hizmete özgü meta veriler. Genellikle ilerleme bilgilerini ve oluşturma zamanı gibi ortak meta verileri içerir. Bazı hizmetler bu tür meta verileri sağlamayabilir. Uzun süreli bir işlemi döndüren tüm yöntemler, varsa meta veri türünü belirtmelidir.
done

bool

Değer false olması işlemin devam ettiği anlamına gelir. Değer true olduğunda işlem tamamlanmış olup error veya response kullanılabilir.
result birleşik alanı. İşlem sonucu. error veya geçerli bir response olabilir. done == false ise error öğesi de response öğesi de ayarlanmaz. done == true ise error veya response öğelerinden yalnızca biri ayarlanabilir. Bazı hizmetler sonuç vermeyebilir. result aşağıdakilerden yalnızca biri olabilir:
error

Status

İşlem başarısız olduğunda veya iptal edildiğinde sistemin verdiği hata bilgisi.
response

Any

İşlem başarılı olduğunda sistemin verdiği normal yanıt. Orijinal yöntem başarılı olduğunda veri döndürmüyorsa (ör. Delete) yanıt google.protobuf.Empty olur. Orijinal yöntem standart Get/Create/Update ise yanıt kaynak olmalıdır. Diğer yöntemler için yanıtın türü XxxResponse olmalıdır. Burada Xxx, orijinal yöntem adıdır. Örneğin, orijinal yöntem adı TakeSnapshot() ise tahmin edilen yanıt türü TakeSnapshotResponse olur.

WaitOperationRequest

Operations.WaitOperation için istek mesajı.

Alanlar
name

string

Beklenecek işlem kaynağının adı.
timeout

Duration

Zaman aşımına uğramadan önce beklenecek maksimum süre. Boş bırakılırsa bekleme süresi, temel alınan HTTP/RPC protokolünün izin verdiği süre kadar olur. RPC bağlamı için son tarih de belirtilmişse daha kısa olan kullanılır.