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 HTTP Eşleme: 500 Dahili Sunucu Hatası |
INVALID_ARGUMENT |
İstemci geçersiz bir bağımsız değişken belirtti. Bunun, 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 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. 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ı 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.
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.
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.
HTTP Eşleme: 503 Hizmeti Kullanılamıyor |
DATA_LOSS |
Kurtarılamayan veri kaybı veya bozulma. HTTP Eşleme: 500 Dahili Sunucu Hatası |