Hatalar

Bir istek başarısız olduğunda API, bir HTTP hata durumu ve hatayı açıklayan bir JSON gövdesi döndürür. Bu referans; biçimi, kodları ve bunların nasıl ele alınacağını listeler.

Hata biçimiBağlantıyı kopyalayın

{
  "code": "VALIDATION_FAILED",
  "message": "2 fields failed validation: name, sizeGb",
  "field": "name",
  "details": {
    "errors": [
      { "field": "name", "code": "string_too_short", "message": "String should have at least 1 character" },
      { "field": "sizeGb", "code": "missing", "message": "Field required" }
    ]
  }
}

API 400 Bad Request kullanmaz: işlemin şemasına uymayan bir istek 422 Unprocessable Entity döndürür.

Durum kodları ve hata kodlarıBağlantıyı kopyalayın

Bazı istekler, bölgenin sunmadığı bir özellik için de 404 Not Found döndürür; örneğin bölgenin sağlayamadığı bir yerde duraktaki veri şifrelemesi istediğinizde. Mesaj özelliği ve bölgeyi belirtir. Yeniden denemek bu yanıtı değiştiremez.

İçe aktarılan projelerBağlantıyı kopyalayın

Bu kodlar yalnızca platform operatörünün, mevcut kaynaklarıyla birlikte sizin için içe aktardığı projelerde görünür:

Doğrulama hatalarıBağlantıyı kopyalayın

Geçersiz bir istek için verilen 422 Unprocessable Entity yanıtı, tüm sorunları tek seferde details.errors içinde listeler. Her girdide şunlar bulunur:

• field: alanın istekteki yolu (düzeyler arasında noktalarla) ya da sorun gövdenin tamamıyla ilgiliyse null.
• code: sorunun türü; örneğin missing veya string_too_short.
• message: İngilizce bir açıklama.

Üst düzeydeki field ilk girdiyi açıklar; message ise tüm alanları adlandırır. İsteği yeniden göndermeden önce listelenen tüm alanları düzeltin.

Hız sınırlamaBağlantıyı kopyalayın

API ağ geçidi, her kimlik bilgisinin ne kadar hızlı istek gönderebileceğini sınırlar. Her API belirtecinin, servis hesabı anahtarının ve konsol oturumunun kendi limiti vardır; kimlik bilgisi olmayan istekler ise kaynak IP adresine göre sınırlanır. Limit, sürekli hızın üzerinde kısa ani artışlara izin verir.

Bir API belirteci veya servis hesabı anahtarı için limit, kimlik bilgisi başına ve ayrıca kuruluş başına, kuruluşun tüm kimlik bilgileri için toplu olarak uygulanır. Bu tür bir isteğin her yanıtı şu başlıkları taşır:

Limiti aştığınızda ağ geçidi; RATE_LIMITED kodu, "retryable": true ve beklenecek saniye sayısını (en az 1) içeren bir Retry-After başlığıyla 429 Too Many Requests yanıtını verir. Bir sonraki isteği göndermeden önce en az bu süre kadar bekleyin.

Bu limit REST API’ye yapılan istekler için geçerlidir. Uygulama kimlik bilgilerinin limitleri için bkz. OpenStack API limitleri.

Eşzamansız işlemlerdeki hatalarBağlantıyı kopyalayın

Bir 202 Accepted isteğinin işi başarısız olduğunda işlemin state değeri FAILED olur ve error alanı yukarıdaki biçimde bir hata içerir. Başarılı olan bir işlem, istediğiniz bir şey karşılanamadığında aynı biçimde bir warning taşıyabilir. Bkz. Eşzamanlı ve eşzamansız istekler.

API’nin önündeki ağdan gelen yanıtlarBağlantıyı kopyalayın

Bir dağıtım sırasında API’nin önündeki bir ara sunucu (proxy), yukarıdaki hata biçiminde olmayan, örneğin düz metin bir gövdeyle 500, 502, 503 veya 504 yanıtı verebilir. Böyle bir yanıt, isteğinizin API’ye ulaşmadığı anlamına gelir. İsteği artan bekleme süreleriyle ve aynı Idempotency-Key ile yeniden deneyin.

Hataları yeniden denemeBağlantıyı kopyalayın

• Yanıtta "retryable": true olduğunda ve hata biçiminde olmayan bir 500, 502, 503 veya 504 yanıtından sonra yeniden deneyin. Aynı Idempotency-Key değerini yeniden gönderin. Bkz. Idempotent istekler.
• Her yeniden denemeden önce daha uzun bekleyin; örneğin 1, 2, 4 ve ardından 8 saniye. 429 yanıtından sonra en az Retry-After süresi kadar bekleyin.
• Diğer 4xx hatalarını değiştirmeden yeniden denemeyin. Önce isteği, kimlik bilgisini veya kaynağın durumunu düzeltin.

İlgili içerikBağlantıyı kopyalayın

• REST API’ye genel bakış
• API belirteçleriyle kimlik doğrulama
• Idempotent istekler