Code

gTB API'leri için standart hata kodları.

Bazen birden fazla hata kodu geçerli olabilir. Hizmetler, geçerli olan en belirgin hata kodunu döndürmelidir. Örneğin, her iki kod geçerliyse FAILED_PRECONDITION yerine OUT_OF_RANGE kullanın. Benzer şekilde, FAILED_PRECONDITION yerine NOT_FOUND veya ALREADY_EXISTS tercih edin.

Sıralamalar
OK

Bir hata değil. Başarıya ulaştı.

HTTP Eşleme: 200 Tamam
CANCELLED

İşlem, genellikle arayan tarafından iptal edildi.

HTTP Eşleme: 499 İstemci İsteği Kapatıldı
UNKNOWN

Bilinmeyen hata. Örneğin, başka bir adres alanından alınan Status değeri, bu adres alanında bilinmeyen bir hata alanına aitse bu hata döndürülebilir. Ayrıca, yeterli hata bilgisi döndürmeyen API'ler tarafından oluşturulan hatalar da bu hataya dönüştürülebilir.

HTTP Eşleme: 500 Dahili Sunucu Hatası
INVALID_ARGUMENT

İstemci geçersiz bir bağımsız değişken belirtti. Bunun, FAILED_PRECONDITION ürününden farklı olduğunu unutmayın. INVALID_ARGUMENT, sistemin durumuna bakılmaksızın sorunlu bağımsız değişkenleri belirtir (ör. bozuk dosya adı).

HTTP Eşleme: 400 Hatalı İstek
DEADLINE_EXCEEDED

İşlem tamamlanmadan önce süresi doldu. Sistemin durumunu değiştiren işlemlerde, işlem başarıyla tamamlanmış olsa bile bu hata döndürülebilir. Örneğin, sunucudan verilen başarılı bir yanıt, son tarihin sona ermesine yetecek kadar gecikmiş olabilir.

HTTP Eşleme: 504 Ağ Geçidi Zaman Aşımı
NOT_FOUND

İstenen bazı varlıklar (ör. dosya veya dizin) bulunamadı.

Sunucu geliştiricilere not: Kademeli özellik kullanıma sunma veya belgelenmemiş izin verilenler listesi gibi bir kullanıcı sınıfının tümü için istek reddedilirse NOT_FOUND kullanılabilir. Bir sınıftaki kullanıcılar (ör. kullanıcı tabanlı erişim denetimi) için bazı istekler reddedilirse PERMISSION_DENIED kullanılmalıdır.

HTTP Eşleme: 404 Bulunamadı
ALREADY_EXISTS

Bir istemcinin oluşturmaya çalıştığı varlık (ör. dosya veya dizin) zaten var.

HTTP Eşleme: 409 Çakışması
PERMISSION_DENIED

Arayan kullanıcının belirtilen işlemi yürütme izni yok. PERMISSION_DENIED, bazı kaynakların tükenmesiyle sonuçlanan retler için kullanılmamalıdır (bu hatalar için bunun yerine RESOURCE_EXHAUSTED kullanın). Arayan kişi belirlenemiyorsa PERMISSION_DENIED kullanılmamalıdır (bu hatalar için bunun yerine UNAUTHENTICATED kullanın). Bu hata kodu, isteğin geçerli olduğu veya istenen varlığın mevcut olduğu ya da diğer ön koşulları karşıladığı anlamına gelmez.

HTTP Eşleme: 403 Yasak
UNAUTHENTICATED

İstekte işlemle ilgili geçerli kimlik doğrulama bilgileri bulunmuyor.

HTTP Eşleme: 401 Yetkisiz
RESOURCE_EXHAUSTED

Bazı kaynaklar tükendi, belki kullanıcı başına kota uygulanmadı veya dosya sisteminin tamamında yer kalmadı.

HTTP Eşleme: 429 Çok Fazla İstek Var
FAILED_PRECONDITION

Sistem, işlemin yürütülmesi için gerekli bir durumda olmadığından işlem reddedildi. Örneğin, silinecek dizin boş değildir, dizin olmayan bir öğeye rmdir işlemi uygulanır vb.

Hizmet sağlayıcıları FAILED_PRECONDITION, ABORTED ve UNAVAILABLE arasında karar vermek için aşağıdaki yönergeleri kullanabilir: (a) Müşteri yalnızca başarısız olan aramayı yeniden deneyebilirse UNAVAILABLE kullanın. (b) Müşterinin daha yüksek düzeyde yeniden denemesi gerekiyorsa ABORTED kullanın. Örneğin, istemci tarafından belirtilen bir test ve set başarısız olduğunda, istemcinin okuma-değiştirme-yazma sırasını yeniden başlatması gerektiğini belirtin. (c) Sistem durumu açıkça düzeltilene kadar istemcinin işlemi yeniden denememesi gerekiyorsa FAILED_PRECONDITION kullanın. Örneğin, dizin boş olmadığı için &&t;rmdir" işlemi başarısız olursa, dosyalar dizinden silinmediği sürece istemcinin işlemi yeniden denememesi gerektiğinden FAILED_PRECONDITION döndürülmelidir.

HTTP Eşleme: 400 Hatalı İstek
ABORTED

Genellikle bir sıralı kontrol hatası veya işlem iptali gibi eş zamanlılık sorunu nedeniyle işlem iptal edildi.

FAILED_PRECONDITION, ABORTED ve UNAVAILABLE arasında karar verirken yukarıdaki kuralları inceleyin.

HTTP Eşleme: 409 Çakışması
OUT_OF_RANGE

İşlem, geçerli aralığı geçtikten sonra yapılmaya çalışıldı. Örneğin, dosya sonundaki geçmiş bilgileri aramak veya okumak.

INVALID_ARGUMENT etiketinin aksine bu hata, sistem durumu değişirse düzeltilebilecek bir sorunu belirtir. Örneğin, 32 bit dosya sistemi, [0,2^32-1] aralığında olmayan bir ofsette okunması istenirse INVALID_ARGUMENT oluşturur, ancak geçerli dosya boyutundan sonraki bir ofsetten okunması istenirse OUT_OF_RANGE oluşturur.

FAILED_PRECONDITION ile OUT_OF_RANGE arasında oldukça fazla çakışma var. Geçerli olduğunda OUT_OF_RANGE (daha kesin bir hata) kullanmanızı öneririz. Böylece, bir alandan giden arayanlar işlerin ne zaman tamamlandığını tespit etmek için kolayca OUT_OF_RANGE hatası arayabilir.

HTTP Eşleme: 400 Hatalı İstek
UNIMPLEMENTED

İşlem uygulanmadı veya bu hizmette desteklenmiyor/etkinleştirilmemiş.

HTTP Eşleme: 501 Uygulanmadı
INTERNAL

Dahili hatalar. Bu, temel sistem tarafından beklenen bazı sabitlerin bozuk olduğu anlamına gelir. Bu hata kodu ciddi hatalar için ayrılmıştır.

HTTP Eşleme: 500 Dahili Sunucu Hatası
UNAVAILABLE

Hizmet şu anda kullanılamıyor. Bu geçici bir durum olup büyük olasılıkla geri yükleme ile yeniden düzeltilerek düzeltilebilir. Münhasır olmayan işlemleri yeniden denemenin her zaman güvenli olmadığını unutmayın.

FAILED_PRECONDITION, ABORTED ve UNAVAILABLE arasında karar verirken yukarıdaki kuralları inceleyin.

HTTP Eşleme: 503 Hizmeti Kullanılamıyor
DATA_LOSS

Kurtarılamayan veri kaybı veya bozulma.

HTTP Eşleme: 500 Dahili Sunucu Hatası