Hata durumu

*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, birbirine göre.

v2 kaynak hatası modeli

Varsayılan olarak, kaynak yöntemleri 200 OK durumuyla yanıt verir.İstekler başarısız olduğunda, Open Cloud standart hata kodlarını iade eder.Tüm hata yanıtları aynı biçime sahiptir, içinde şunlar bulunur:

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

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

Kodlar

Aşağıdaki tablo, code için olası değerleri tanımlar.

KodHTTP DurumuAçıklama
INVALID_ARGUMENT400Geçersiz bir argüman geçirdiniz, örneğin geçersiz bir universeId . Ayrıca eksik veya geçersiz başlıklar da olabilir, örneğin Content-Length ve Content-Type .
PERMISSION_DENIED403Talebinizin işlemi gerçekleştirmek için yeterli izin veya alanı yok.
NOT_FOUND404Sistem belirtilen kaynaklarınızı bulamıyor, örneğin bir veri depolama girişi.
ABORTED409Operasyon iptal edildi.
RESOURCE_EXHAUSTED429Operasyonu gerçekleştirmek için yeterli kota yok, genellikle çok fazla istek göndermekten dolayı.
CANCELLED499Sistem talepsonlandırır, genellikle bir müşteri tarafı süresi dolduğundan.
INTERNAL500Genellikle bir sunucu hatası nedeniyle iç sunucu hata, hata.
NOT_IMPLEMENTED501Sunucu API yöntemini uygulamıyor.
UNAVAILABLE503Hizmet mevcut değil, genellikle sunucu kapalı olduğunda döndürülür.

v1 kaynak hatası modeli

Tüm hata yanıtları aynı, standart biçime sahiptir, içinde şunlar bulunur:

  • Tüm Açık Bulut uç noktalarına uygulanabilen yüksek düzey bir sebep olan bir error alanı.
  • Hata açıklayıcı bir hata message , hataları daha da açıklar
  • Her API'ye özel olan hata bilgilerini kapsayan bir errorDetails nesne, daha fazla bilgiyi kapsar

Bir hataların kök nedenini analiz etmek için, error alanının değerine ve errorDetails alanının değerine bakın.message alanını hata işleme için ek olarak kullanın, çünkü bazen errorDetails alanındaki ayrıntı seviyesini kapsamayabilir.

Örnek Standart Veri Depolama Hata Yanıtı

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

Örnek hata yanıtı, yüksek düzeyde Açık Bulut 'ı gösterir, hata 'ı gösterir ve 'deki özel <23 Yanıtın error ve datastoreErrorCode alanlarından, hatalara neden olan geçersiz bir kursor parametresini geçtiğinizi anlayabilirsiniz.Ardından işlevini düzeltmek için imleç parametrenizi sorunu çözmek için düzeltin.

Tüm sipariş edilen veri depolama hatalarının yanıt formatı aynıdır ve şunları içerir:

Örnek Sıralanmış Veri Depoları Hata Yanıtı

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

The code yüksek seviye hata içerecek bir dize içerecekken, message hata ile ilgili özel detaylar içerecek

Kodlar

Tüm yüksek düzey Açık Bulut hatalarının özeti için aşağıdaki tabloya bakın.

HTTP Durum Kodu

Error İngilizce: Error

Açıklamalar
400Geçersiz_ArgümanlarGeçersiz bir argüman geçirdiniz, örneğin geçersiz bir universeId . Ayrıca eksik veya geçersiz başlıklar da olabilir, örneğin Content-Length ve Content-Type .
403Yetersiz_SCOPEİstek, erişim jetonu tarafından sağlananlardan daha yüksek yetkilere ihtiyaç duyar.
403İZİN_REDDETİLDİTalebinizin işlemi gerçekleştirmek için yeterli ölçüsü yok.
404NOT_FOUND DeğilSistem belirtilen kaynaklarınızı bulamıyor, örneğin bir veri mağaza.
409IPTAL EDİLDİOperasyon, evrenin bir parçası olmayan bir yeri yayınlamak gibi bir çatışma nedeniyle iptal edildi.
429KAYNAK_TÜKENDİOperasyonu gerçekleştirmek için yeterli kota yok, genellikle çok fazla istek göndermekten dolayı.
499IPTAL EDİLDİSistem talepsonlandırır, genellikle bir müşteri tarafı süresi dolduğundan.
500İÇİDahili sunucu hatası. Genellikle bir sunucu hatası.
501Uygulanmadı NOT_IMPLEMENTEDSunucu API yöntemini uygulamıyor.
503MEVCUT DEĞILHizmet kullanılamıyor. Genellikle sunucu kapalıdır.