Hatalar

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Aşağıdaki bölümler v2 ve v1 kaynak yöntemleri için hata modelini açıklar, respect.

v2 Kaynak Hata Modeli

Varsayılan olarak, kaynak metodları 200 OK durumuyla yanıt verir. İstekler başarısız olduğunda, Open Cloud standart hata kodlarını döndürür. Tüm hata yanıtları aynı biçimde sağlar, bunlar:

  • code - HTTP durum kodunu temsil eder.
  • message - Hata anlatımını açıklayan bir mesaj.
  • details - Hata ile ilgili daha fazla bilgi içeren bir nesne.
Hata Örneği

{
"code": "INVALID_ARGUMENT",
"message": "The provided filter is invalid.",
"details": [
{
...
}
]
}

Kodlar

Aşağıdaki tabloda code için olası değerler açıklanmıştır.

KodHTTP DurumuAçıklama
INVALID_ARGUMENT400Geçersiz bir universeId ile argüman geçersiz. Ayrıca, Content-Length ve Content-Type gibi gözaltı eksik veya geçersiz olabilir.
PERMISSION_DENIED403İstek işleme izinleriniz veya kapsayanız yeterli değil.
NOT_FOUND404Sistem, veri depoları gibi belirli kaynakları bulamıyor, bunun yerine bir girişi bulur.
ABORTED409Operasyon durduruldu.
RESOURCE_EXHAUSTED429Operasyonu yerine getirmek için yeterli kotağınız yok, genellikle çok fazla istek göndermenizden kaynaklanıyor.
CANCELLED499Sistem, genellikle bir client tarafından zamanlanmış olarak sona erdirme talepiptal eder.
INTERNAL500Dahili sunucu hata, genellikle bir sunucu hata yüzünden.
NOT_IMPLEMENTED501Sunucu API yöntemini uygulamıyor.
UNAVAILABLE503Hizmet mevcut değil, genellikle sunucu kapalı olduğunda geri döndürülür.

v1 Kaynak Hata Modeli

Tüm hata yanıtları aynı, standart formatına sahiptir, bu da şunları içerir:

  • Tüm Open Cloud uç noktalara uygulanabilen yüksek seviyeli bir nedendir. Bir error alanı, her Open Cloud uç noktası için uygulanabilir yüksek seviyeli bir nedendir.
  • Hata açıklayıcı bir hata message , bu da hatayı açıklar.
  • errorDetails bir objektir, her API'ye özgü olan hata hakkında daha fazla bilgi içerir.

Bir hatin kök nedenini analiz etmek için, error alanın değerini ve errorDetails alanını referans alın. Hata işleme için kullan message alanını bir eklent olarak kullanın, çünkü bazen aynı seviyede ayrıntıları kapsayabilir.

Örnek Standart Veri Depoları Hata Yanıtı

{
"error": "INVALID_ARGUMENT",
"message": "Invalid cursor.",
"errorDetails": [
{
"errorDetailType": "DatastoreErrorInfo",
"datastoreErrorCode": "InvalidCursor"
}
]
}

Örnek hata yanıtı, yanılır error ile gösterilen yüksek

Tüm sipariş edilen veri depolarının hata yanıtları aynı biçimdeki hata yanıtlarını içerir:

Örnek DataStores Error Talebi

{
"code": "INVALID_ARGUMENT",
"message": "Invalid cursor."
}

The code içerir hata seviyesi yüksek bir dizi içerirken, the message içerir hata ile ilgili özellikleri içerir

Kodlar

Tüm yüksek seviyeli Open Cloud hatalarının bir özet için aşağıdaki tabloyu referans alın.

HTTP Durum KoduHataAçıklamalar
400GEÇERSİZ_ARGÜMANGeçersiz bir universeId ile argüman geçersiz. Ayrıca, Content-Length ve Content-Type gibi gözaltı eksik veya geçersiz olabilir.
403YETERLİ OLMAZ_SCOPEİstek, erişim jetonu tarafından sağlanan daha yüksek ayrıcalıklara ihtiyaç duyar.
403İZİN_REDDETTİİşlemin yapılması için yeterli alanınız yok.
404NOT_FOUNDSistem, veri mağazagibi belirttiğiniz kaynakları bulamıyor.
409İPTAL EDİLDİOperasyon, evrenin bir parçası olmayan bir yeri yayınlamak gibi bir çatışma nedeniyle aborte edildi.
429KAYNAKLAR_HAZIROperasyonu yerine getirmek için yeterli kotağınız yok, genellikle çok fazla istek göndermenizden kaynaklanıyor.
499İPTAL EDİLDİSistem, genellikle bir client tarafından zamanlanmış olarak sona erdirme talepiptal eder.
500İÇERİKDahili sunucu hata. Genellikle bir sunucu hata.
501NOT_IMPLEMENTEDSunucu API yöntemini uygulamıyor.
503MEVCUT DEĞİLHizmet mevcut değil. Genellikle sunucu kapalı.