Code

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

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

Sıralamalar
OK

Hata değil. Başarıyla sonuçlandı.

HTTP Eşleme: 200 Tamam
CANCELLED

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

HTTP Eşleme: 499 İstemci Tarafından Kapatılan İstek
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 ait olduğunda 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 (ör. bozuk bir dosya adı) sorunlu bağımsız değişkenleri belirtir.

HTTP Eşleme: 400 Bozuk İstek
DEADLINE_EXCEEDED

İşlem tamamlanmadan önce geçerlilik 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, bir sunucudan alınan başarılı 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ştiriciler için not: Aşamalı özellik kullanıma sunma veya doküman dışı izin verilenler listesi gibi bir kullanıcı sınıfının tamamı için istek reddedilirse NOT_FOUND kullanılabilir. Bir kullanıcı sınıfındaki bazı kullanıcılar için istek reddedilirse (ör. kullanıcı tabanlı erişim denetimi) PERMISSION_DENIED kullanılmalıdır.

HTTP Eşleme: 404 Bulunamadı
ALREADY_EXISTS

Bir istemcinin oluşturmaya çalıştığı öğe (ör. dosya veya dizin) zaten mevcut.

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

Arayanın, belirtilen işlemi yürütme izni yok. PERMISSION_DENIED, bazı kaynakların tükenmesinden kaynaklanan retler için kullanılmamalıdır (bu hatalar için bunun yerine RESOURCE_EXHAUSTED kullanın). Arayan tanımlanamıyorsa 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 diğer ön koşulları karşıladığı ya da karşıladığı anlamına gelmez.

HTTP Eşlemesi: 403 Yasaklandı
UNAUTHENTICATED

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

HTTP Eşleme: 401 Yetkilendirilmedi
RESOURCE_EXHAUSTED

Kullanıcı başına kota nedeniyle bazı kaynaklar tükenmiş veya dosya sisteminin tamamı kullanılmamış olabilir.

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

Sistem, işlemin yürütülmesi için gerekli durumda olmadığından işlem reddedildi. Örneğin, silinecek dizin boş değildir, dizin dışı 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 kurallardan yararlanabilir: (a) İstemci başarısız olan aramayı yeniden deneyebiliyorsa UNAVAILABLE kullanın. (b) Müşteri daha yüksek düzeyde yeniden denemek istiyorsa ABORTED kullanın. Örneğin, istemci tarafından belirtilen bir test etme ve ayarlama işlemi 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 "rmdir" başarısız olursa FAILED_PRECONDITION, dosyalar dizinden silinmediği sürece istemcinin tekrar denememesi gerektiği için döndürülür.

HTTP Eşleme: 400 Bozuk İstek
ABORTED

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

FAILED_PRECONDITION, ABORTED ve UNAVAILABLE arasında karar verirken yukarıdaki yönergelere bakın.

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

İşlem, geçerli aralığı aşmaya çalıştı. Örneğin, dosya sonunda arama yapmak veya dosya sonundan okumak.

INVALID_ARGUMENT hatasının aksine, bu hata sistem durumu değişirse düzeltilebilecek bir sorunu belirtir. Örneğin, 32 bit dosya sistemi, [0,2^32-1] aralığındaki bir ofsette okunması istendiğinde INVALID_ARGUMENT, mevcut dosya boyutundan sonraki bir ofsetten okuması istenirse OUT_OF_RANGE oluşturur.

FAILED_PRECONDITION ile OUT_OF_RANGE arasında oldukça fazla çakışma var. Geçerli olduğunda, daha spesifik olan OUT_OF_RANGE hatasını kullanmanızı öneririz. Böylece, bir alan adı içinde arama yapan arayanların tamamlandıkları zaman kolayca OUT_OF_RANGE hatası arayabilirler.

HTTP Eşleme: 400 Bozuk İ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ı değişmez değerlerin 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 durum muhtemelen geçici bir koşuldur ve düzeltilerek yeniden deneme işlemiyle düzeltilebilir. Etkisi olmayan işlemleri yeniden denemek her zaman güvenli olmayabilir.

FAILED_PRECONDITION, ABORTED ve UNAVAILABLE arasında karar verirken yukarıdaki yönergelere bakın.

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

Kurtarılamayan veri kaybı veya bozulması.

HTTP Eşleme: 500 Dahili Sunucu Hatası