Çalışma zamanı hata kataloğu

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Apigee Edge'deki hatalar

Apigee Edge, Apigee Edge bileşenleri Yönlendiriciler ve Mesaj İşlemcileri üzerinden API isteklerinde bulunulduğunda veya arka uç istemci uygulamalarına hatalar döndürebilir.

Mesaj İşleyiciden Gelen Hatalar

Mesaj İşlemci, Apigee Edge'in politikaları ve arka uç sunucularıyla etkileşime girer. Aşağıdaki gibi sorunlar tespit ederse hata döndürebilir:

  • Ağ bağlantısı sorunları, TLS el sıkışma hataları, arka uç sunucusunun kullanılamıyor olması, arka uç sunucusuyla iletişim sırasında yanıt olmaması
  • Politikanın uygulanması sırasındaki hatalar
  • Geçersiz HTTP üstbilgileri, kodlama, yol, HTTP spesifikasyonlarına uyumsuzluk, sınırı aşıyor ürün sınırları vb.:
    • İstemci uygulamalar tarafından gönderilen HTTP isteğiyle

      • VEYA

    • Arka uç sunucusu tarafından gönderilen HTTP yanıtıyla
  • Ve daha fazlası

İleti İşleyici'den örnek hata

İleti İşleyici her zaman HTTP durum kodunu ve ardından aşağıda gösterildiği gibi JSON biçiminde bir hata kodu:

İstemci uygulaması aşağıdaki örnekteki gibi bir yanıt kodu alır: 

HTTP/1.1 414 Request-URI Too Long

İleti İşleyici'den gelen bir hata yanıtı aşağıdaki biçimde görünür: 

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

Hata yanıtındaki alanların açıklaması:

Alan Açıklama
faultstring Hatanın olası nedenini açıklayan hata mesajını içerir
errorcode Hata kodu olarak da bilinir), hatası

Çalışma zamanı hatası kataloğu

Bu hata kataloğu, çalışma zamanı hakkında bilmeniz gereken tüm bilgileri Apigee Edge Mesajı tarafından döndürülen hata kodları (politika dışı hatalar için) İşlemci bileşeni. Her bir hata kodu için aşağıdaki bilgileri içerir:

  • HTTP Durum kodu
  • Hata mesajı
  • Hatanın olası nedenleri
  • İlişkili tüm HTTP spesifikasyonları ve/veya ürün sınırları
  • Hatanın nedenini teşhis etmeye ve bununla ilgili talimatları içeren başucu kitapları ve videolar hatayı kendi başınıza çözmek için uygulayabileceğiniz etkili çözümler (mümkün olduğunda)
  • Hatayı kendi başınıza çözmek için uygulayabileceğiniz düzeltme

Aşağıdaki hata kodu kategorileri ele alınmıştır:

Tabloyu yukarıdaki bilgileri gösterecek şekilde filtrelemek için aşağıdaki Arama kutusunu kullanın bakın. Durum kodunu veya herhangi bir alandaki içeriği arayabilirsiniz seçin.

Hata kodu Açıklama Düzelt

flow.*

flow.APITimedOut
  • HTTP durum kodu:
 504 Gateway Timeout
  • Hata mesajı:
 API timed out
  • Olası neden:

Bu hata aşağıdaki durumlarda oluşur:

  • Arka uç sunucusu, yapılandırılan zaman aşımı süresi içinde yanıt vermiyor mülk tarafından İlgili API Proxy'si için api.timeout.
  • Bir politika, yoğun hesaplama gerektiren işlemler nedeniyle uzun bir zaman alıyor, veya performans kötü olabilir.

Not: Bu başucu kitabı, hata koduyla ilgili sorun giderme talimatlarını içerir messaging.adaptors.http.flow.GatewayTimeout; ancak isterseniz flow.APITimedOut hata kodundaki sorunları gidermek için aynı başucu kitabını kullanın.

BAŞUCU KİTABI

flow.SharedFlowNotFound
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 Shared Flow {shared_flow_name} Not Found
  • Olası neden:

Bu hata ilgili paylaşılan akış aşağıdaki durumlarda ortaya çıkar:

  • Mevcut değil

    • VEYA

  • Mevcut ancak dağıtılmıyor
BAŞUCU KİTABI

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • HTTP durum kodu:
 404 Not Found
  • Hata mesajı:
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • Olası neden:

Bu hata, aşağıdaki senaryolardan birinde ortaya çıkar:

  1. Özel API Proxy'si:
    1. İlgili Sanal Ana Makine
    2. Belirli yoldaki istekleri kabul edecek şekilde Yapılandırılmadı istekte kullanıldı
    3. kullandığınız belirli bir ortamda DAĞITILMAZ API isteklerinde bulunmaya
    4. Bir veya daha fazla Mesaj İşleyicisine DAĞITILMADI
  2. Oluşturmaya çalıştığınız ortam, API istekleri bir veya daha fazla Mesaj İşleyiciye yüklenmedi
 BAŞUCU KİTABI
Bu hata, birden fazla sanal ana makine aynı ana makineye sahip olduğunda da oluşabilir takma adı ve bağlantı noktası numarasıdır. BAŞUCU KİTABI

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Decompression failure at request
  • Olası neden:

Bu hata yalnızca aşağıdaki durumlarda oluşur:

  • HTTP istek başlığında belirtilen kodlama Content-Encoding geçerli ve Apigee Edge tarafından destekleniyor,

    • ANCAK

  • HTTP'nin parçası olarak istemci tarafından gönderilen yük biçimi isteği, Content-Encoding üst bilgisi
BAŞUCU KİTABI

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Decompression failure at response
  • Olası neden:

Bu hata yalnızca aşağıdaki durumlarda oluşur:

  • Arka uç/hedef sunucunun Content-Encoding HTTP yanıt başlığı geçerli ve Apigee Edge tarafından destekleniyor,

    • ANCAK

  • Arka uç/hedef sunucu tarafından şu şekilde gönderilen yük biçimi bölümü, Content-Encoding üst bilgisi
BAŞUCU KİTABI

messaging.adaptors.http.flow.ErrorResponseCode
  • HTTP durum kodu:
 500

BAŞUCU KİTABI

VİDEO

  • Hata mesajı:
 Hata Mesajı ve biçimi arka uç sunucuya göre değişiklik gösterebilir hakkında bilgi edindiniz.
  • Olası neden:
 Bu hata, arka uç sunucusu durumla yanıt verirse Apigee Edge'e 500 kodunu ekleyin.
  • HTTP durum kodu:
 503

BAŞUCU KİTABI

VİDEO

  • Hata mesajı:
 Hata Mesajı ve biçimi arka uç sunucuya göre değişiklik gösterebilir hakkında bilgi edindiniz.
  • Olası neden:
 Bu hata, arka uç sunucusu durumla yanıt verirse Apigee Edge'e 503 kodunu ekleyin.
  • HTTP durum kodu:
 504 BAŞUCU KİTABI
  • Hata mesajı:
 Hata Mesajı ve biçimi arka uç sunucuya göre değişiklik gösterebilir hakkında bilgi edindiniz.
  • Olası neden:
 Bu hata, arka uç sunucusu durumla yanıt verirse Apigee Edge'e 504 kodunu ekleyin.

Not: Hata kodu messaging.adaptors.http.flow.ErrorResponseCode iade edilmedi istemci uygulamalara gönderilen hata iletisinin bir parçası olarak. Bu Bunun nedeni, bu hata kodu Apigee Edge tarafından arka uç sunucusu kurulduğunda hata mesajı ve 4XX veya 5XX kullanabilirsiniz. Bu hata kodunu API Monitoring'de, NGINX erişim günlüklerinde, veya analitik veri tabanı.

messaging.adaptors.http.flow.GatewayTimeout
  • HTTP durum kodu:
 504 Gateway Timeout
  • Hata mesajı:
 Gateway Timeout
  • Olası neden:
 Bu hata, arka uç sunucusu yanıt vermezse ortaya çıkar Apigee Edge Mesaj İşlemcisi’ne İleti İşleyici'de yapılandırılan G/Ç zaman aşımı süresi.
BAŞUCU KİTABI

messaging.adaptors.http.flow.LengthRequired
  • HTTP durum kodu:
 411 Length Required
  • Hata mesajı:
 'Content-Length' is missing
  • Olası neden:

Bu hata, Content-Length üstbilgisi HTTP POST ve PUT'nin bir parçası olarak istemci uygulaması isteklerini Apigee Edge'e gönderir.

Not: Bu öğeyle başarısız olan istekler İzleme aracında bulunamadı. Bunun nedeni, İleti İşleyicinin erken bir aşamada, yani isteği işleme koymadan ve API Proxy'sinde herhangi bir politika yürütme
  • HTTP Spesifikasyonu:
 RFC Bölüm 3.3.2: Content-Length

Düzelt

Bu hatayı gidermek için aşağıdaki adımları uygulayın:

  1. İstemci uygulamasının her zaman üstbilgiyi ilettiğinden emin olun Content-Length, HTTP POST ve PUT isteği Apigee Edge'e gönderildi. Örneğin:

    curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"

  2. POST ile boş bir yük aktarsanız bile PUT istekleri için üst bilginin Content-Length: 0 geçti. Örneğin:

    curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"

messaging.adaptors.http.flow.NoActiveTargets
  • HTTP durum kodu:
 503 Service Unavailable
  • Hata mesajı:
 The Service is temporarily unavailable
  • Olası neden:

Bu hata aşağıdaki senaryolardan birinde ortaya çıkar: CANNOT TRANSLATE Apigee Edge'de TargetServer:

  1. Arka uç sunucusu ana makinesinin yanlış DNS çözümlemesi kötü IP adresleriyle sonuçlandığı için e-posta adresi, özel yetkilendirme sunucusu tarafından bağlantı hataları.
  2. Aşağıdaki nedenlerle bağlantı zaman aşımı hataları var:
    1. Arka uç sunucusundaki güvenlik duvarı kısıtlaması, Apigee Edge'in arka uç sunucusuna bağlanmasını engelleyebilirsiniz.
    2. Apigee Edge arasındaki ağ bağlantısı sorunları arka uç sunucusuna gidin.
  3. TargetServer'da belirtilen ana makine yanlış veya istenmeyen karakterler (ör. boşluk) içeriyorsa.

BAŞUCU KİTABI

VİDEO
Bu hata, başarısız olup olmadığını kontrol edin.

BAŞUCU KİTABI

VİDEO

messaging.adaptors.http.flow.RequestTimeOut
  • HTTP durum kodu:
 408 Request Timeout
  • Hata mesajı:
 Request timed out
  • Olası neden:
 Bu hata, Apigee Edge Mesaj İşlemcisinin istemci uygulamasından İleti İşleyici bileşeninde yapılandırılmış G/Ç zaman aşımı süresi.

messaging.adaptors.http.flow.ServiceUnavailable
  • HTTP durum kodu:
 503 Service Unavailable
  • Hata mesajı:
 The Service is temporarily unavailable
  • Olası neden:

Bu hata, aşağıdaki senaryolardan birinde ortaya çıkar:

  1. Arka uç sunucusunun yanlış DNS çözümlemesi ana makine adı, örneğin, özel yetkilendirme sunucusu tarafından yönlendirilen kötü IP adreslerine neden oldu neden olabilir.
  2. Aşağıdaki nedenlerle bağlantı zaman aşımı hataları var:
    1. Arka uç sunucusundaki güvenlik duvarı kısıtlaması, Apigee Edge'in arka uç sunucusuna bağlanmasını engelleyebilirsiniz.
    2. Apigee Edge ile arasındaki ağ bağlantısı sorunları arka uç sunucusuna gidin.
  3. Hedef Uç Nokta'da belirtilen hedef sunucu ana makinesi: yanlış veya istenmeyen karakterler (ör. boşluk) içeriyor.

BAŞUCU KİTABI

DNS hatası:

VİDEO

Ağ bağlantısı:

VİDEO
Bu hata, arka uç sunucusu sayfayı zamanından önce kapatırsa da bağlantı; Mesaj İşleyici istek yükünü arka uç sunucusuna gidin. BAŞUCU KİTABI

messaging.adaptors.http.flow.SslHandshakeFailed
  • HTTP durum kodu:
 503 Service Unavailable
  • Hata mesajı:
 SSL Handshake failed {error_message}
  • Olası neden:

Bu hata Apigee Edge’in Aşağıdaki durumlarda Mesaj İşleyici ve arka uç sunucusu:

  1. Apigee Edge'in Mesaj İşlemcisi'nin güven deposu:
    • Arka uç sunucusununkiyle eşleşmeyen bir sertifika zinciri içeriyor tam sertifika zinciri

      • VEYA

    • Arka uç sunucusunun tam sertifika zincirini içermiyor
  2. Arka uç sunucusu tarafından sunulan sertifika zinciri:
    • Şununla eşleşmeyen bir Tam Nitelikli Alan Adı (FQDN) içeriyor: hedef uç noktasında belirtilen ana makine adı

      • VEYA

    • Yanlış/eksik bir sertifika zinciri içeriyor

BAŞUCU KİTABI

VİDEO

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Unexpected EOF at target
  • Olası neden:

Bu hata, aşağıdaki senaryolardan birinde ortaya çıkar:

  1. TargetServer, TLS/SSL bağlantılarını destekleyecek şekilde düzgün yapılandırılmamış. kullanıma sunduk.
  2. Arka uç sunucusu bağlantıyı aniden kapatabilir. hazırlanırken Apigee Edge arka uç sunucusundan yanıt bekler.
  3. Apigee'de yanlış yapılandırılmış alive zaman aşımlarını koruyun ve arka uç sunucusuna gidin.
BAŞUCU KİTABI

messaging.runtime.*

messaging.runtime.RouteFailed
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 Unable to route the message to a TargetEndpoint
  • Olası neden:

Bu hata, Apigee Edge'in isteği TargetEndpoints neden:

  • Şu koşullara uygun bir rota kuralı (<RouteRule>) koşulu yok: proxy'deki istekle eşleşir

    • VE

  • ProxyEndpoint'te tanımlı varsayılan bir rota kuralı yok (ör. Herhangi bir koşul olmadan <RouteRule>)

Düzelt

Bu hatayı gidermek için aşağıdaki talimatları uygulayın:

  1. ProxyEndpoint'inizde tanımlanan rota kurallarını gözden geçirin ve şunu değiştirin: isteğinizle eşleşen en az bir rota kuralı koşulu var.
  2. Koşulsuz bir varsayılan rota kuralı tanımlamak iyi bir uygulamadır bu adımları uygulamanız gerekir.
  3. Varsayılan rota kuralının her zaman koşullu Rotalar'ı seçmeye devam ediyoruz.

Şurada <RouteRule> koşullarını tanımlama hakkında daha fazla bilgi edinin: ProxyEndpoint, bkz. Koşullu Hedefler.

messaging.runtime.SenseRaiseFault
  • HTTP durum kodu:
 403 Forbidden
  • Hata mesajı:
 Sense Fault
  • Olası neden:
 Bu hata, belirli bir istemci IP adresinden API isteği yapılırsa ortaya çıkar Bu izin, Apigee Sense kuralları kapsamında engellenmiştir.

Düzelt

Bu hatayı gidermek için aşağıdaki talimatları uygulayın:

  1. Belirli istemci IP adresini şu şekilde engellediğinizi doğrulayın: Apigee Sense'te yapılandırılan kuralları kontrol etmeniz gerekir. Engellenirse şekilde çalıştığını gösterir.
  2. İlgili istemci IP adresi engellenmez ancak hâlâ engellenmişse Böyle bir hata alıyorsanız Apigee Edge Destek Ekibi ile iletişime geçin.

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 Bad Form Data
  • Olası neden:

Bu hata yalnızca aşağıdaki koşulların tamamı karşılandığında ortaya çıkar:

  1. İstemci tarafından Apigee Edge'e gönderilen HTTP isteği şunu içerir:
    • Content-Type: application/x-www-form-urlencoded, ve
    • Yüzde işareti (%) veya yüzde işareti olan form verileri işareti (%) ve ardından izin verilmeyen geçersiz onaltılık karakterler gelir şuna göre: Formlar - Bölüm 17.13.4.1.
  2. Apigee Edge'deki API proxy'si özel formu okur İstek akışındaki ExtractVariables veyaassignMessage politikası.
BAŞUCU KİTABI

protocol.http.DuplicateHeader
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Duplicate Header "{header_name}"
  • Olası neden:
 Bu hata, yinelemeye izin verilmeyen belirli bir HTTP üstbilgisinde ortaya çıkar bir parçası olarak aynı veya farklı değerlerle birden fazla kez İstemci uygulaması tarafından Apigee Edge'e gönderilen HTTP isteği.
  • HTTP Spesifikasyonu:
 RFC 7230, bölüm 3.2.2: Alan Sırası
BAŞUCU KİTABI

protocol.http.EmptyHeaderName
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Header name cannot be empty
  • Olası neden:
 Bu hata, üstbilgi adı HTTP'nin bir parçası olarak gönderilirse isteği boş bırakılmış.
  • HTTP Spesifikasyonu:
 RFC 7230, bölüm 3.2: Üstbilgi Alanları

Düzelt

İstemci uygulama tarafından gönderilen HTTP isteğinin olduğundan emin olun uyarınca her zaman geçerli bir başlık adı içerir. RFC 7230, bölüm 3.2: Üstbilgi Alanları.

protocol.http.HeaderNameWithNonAsciiChar
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Header {header_name} contains non ascii character {character}
  • Olası neden:
 Bu hata, başlık adı HTTP isteğinin bir parçası olarak gönderilirse ortaya çıkar tarafından Apigee Edge'e otomatik olarak gönderilir.
  • HTTP Spesifikasyonu:

RFC 7230, bölüm 3.2: Üstbilgi Alanları ve RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

Düzelt

İstemcinin HTTP isteğinin Apigee Edge, RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

protocol.http.HeaderWithInvalidChar
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Header {header_name} contains invalid character {character}
  • Olası neden:
 Bu hata, başlık adı HTTP isteğinin bir parçası olarak gönderilirse ortaya çıkar tarafından Apigee Edge'e gönderilmesi, eşittir (=), virgül (,), noktalı virgül (;), sekme, CRLF ve yeni satır karakteri.
  • HTTP Spesifikasyonu:

RFC 7230, bölüm 3.2: Üstbilgi Alanları ve RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

Düzelt

İstemci uygulama tarafından Apigee Edge'e gönderilen HTTP isteğinin şulanmadığından emin olun: başlık adlarında, belirtildiği gibi, geçersiz karakterler içermemelidir RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

protocol.http.InvalidPath
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Invalid path {path}
  • Olası neden:
 Bu hata, istemci uygulaması tarafından gönderilen HTTP istek URL'sindeki yol yeni Apigee Edge'e, spesifikasyon uyarınca izin verilmeyen karakterler bulunuyor RFC 3986, bölüm 3.3: Yol.
  • HTTP Spesifikasyonu:

RFC 3986, bölüm 3: Söz Dizimi Bileşenleri ve RFC 3986, bölüm 3.3: Yol

Düzelt

İstemci tarafından gönderilen HTTP istek URL'sindeki yolun uygulama Apigee Edge, başlıklı makaleyi inceleyin.

protocol.http.TooBigBody
  • HTTP durum kodu:
 413 Request Entity Too Large
  • Hata mesajı:
 Body buffer overflow
  • Olası neden:
 Bu hata, istemci uygulama tarafından Apigee Edge'e yapılan HTTP isteği, Apigee Edge'de izin verilen sınırın üzerinde.
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.TooBigHeaders
  • HTTP durum kodu:
 431 Request Header Fields Too Large
  • Hata mesajı:
 request headers size exceeding {limit}
  • Olası neden:
 İstemci tarafından gönderilen tüm istek başlıklarının toplam boyutu bir parçası olarak Apigee Edge'e gönderilen HTTP isteği izin verilenden daha yüksek sınırı var.
  • HTTP Spesifikasyonu:
 RFC 6585, bölüm 5: 431 İstek Üstbilgisi Alanları Çok Büyük
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.TooBigLine
  • HTTP durum kodu:
 414 Request-URI Too Long
  • Hata mesajı:
 request line size exceeding {limit}
  • Olası neden:
 Bu hata, istemci uygulaması tarafından gönderilen istek satırının boyutu bir parçası olarak, Apigee Edge.
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.UnsupportedEncoding
  • HTTP durum kodu:
 415 Unsupported Media
  • Hata mesajı:
 Unsupported Encoding "{encoding}"
  • Olası neden:
 Bu hata, istemci tarafından gönderilen Content-Encoding üstbilgisi HTTP yanıtının parçası olarak Apigee Edge tarafından destekleniyor.
  • HTTP Spesifikasyonu:
 RFC 7231, bölüm 6.5.13: 415 Desteklenmeyen Medya Türü
BAŞUCU KİTABI

protocol.http.* - Caused by target

protocol.http.BadPath
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 Invalid request path
  • Olası neden:
 Bu hata, arka uç sunucusunun istek URL'si target.url akış değişkeni, soru işaretiyle başlayan bir yol içeriyor (?) karakterini kullanmanız gerekir. Bu, geçersizdir.
  • HTTP Spesifikasyonu:

RFC 3986, bölüm 3: Söz Dizimi Bileşenleri ve RFC 3986, bölüm 3.3: Yol
BAŞUCU KİTABI

protocol.http.DuplicateHeader
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Duplicate Header "{header_name}"
  • Olası neden:
 Bu hata, yinelenen HTTP üstbilgileri olmasına izin verilmeyen durumlarda ortaya çıkar bir parçası olarak aynı veya farklı değerlerle birden fazla kez görünür. arka uç sunucusu tarafından Apigee Edge'e gönderilen HTTP yanıtı.
  • HTTP Spesifikasyonu:
 RFC 7230, bölüm 3.2.2: Alan Sırası
BAŞUCU KİTABI

protocol.http.EmptyHeaderName
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Header name cannot be empty
  • Olası neden:
 Bu hata, arka uç sunucusu tarafından HTTP'nin bir parçası olarak gönderilen üstbilgi adı Apigee Edge'e verilen yanıt boş.
  • HTTP Spesifikasyonu:
 RFC 7230, bölüm 3.2: Üstbilgi Alanları

Düzelt

Arka uç tarafından gönderilen HTTP yanıtının sunucuyu Apigee Edge'e göndermek için her zaman RFC 7230, bölüm 3.2: Üstbilgi Alanları.

protocol.http.EmptyPath
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 Request path cannot be empty
  • Olası neden:
 Bu hata, arka uç sunucusunun HTTP istek URL'si target.url akış değişkeni boş bir yol içeriyor.
  • HTTP Spesifikasyonu:

RFC 3986, bölüm 3: Söz Dizimi Bileşenleri ve RFC 3986, bölüm 3.3: Yol
BAŞUCU KİTABI

protocol.http.HeaderNameWithNonAsciiChar
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Header {header_name} contains non ascii character {character}
  • Olası neden:
 Bu hata, arka uç sunucusu tarafından Apigee'ye HTTP yanıtı Kenar, ASCII olmayan karakterler içeriyor.
  • HTTP Spesifikasyonu:

RFC 7230, bölüm 3.2: Üstbilgi Alanları ve RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

Düzelt

Arka uç sunucusunun HTTP yanıtının Apigee Edge, RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

protocol.http.HeaderWithInvalidChar
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Header {header_name} contains invalid character {character}
  • Olası neden:
 Bu hata, arka uç sunucusu tarafından HTTP yanıtının bir parçası olarak gönderilen üstbilgi adının eşittir (=), virgül (,), noktalı virgül (;), sekme, CRLF ve yeni satır karakteridir.
  • HTTP Spesifikasyonu:

RFC 7230, bölüm 3.2: Üstbilgi Alanları ve RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

Düzelt

Arka uç sunucusunun Apigee Edge'e gönderilen HTTP yanıtında herhangi bir başlık adlarında şuna göre geçersiz karakterler bulunuyor: RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

protocol.http.ProxyTunnelCreationFailed
  • HTTP durum kodu:
 503 Service Unavailable
  • Hata mesajı:
 Proxy refused to create tunnel with response status {status code}
  • Olası neden:

Bu hata, Apigee Edge ile web sitesi arasında tünel oluşturulurken proxy sunucu tarafından arka uç sunucusu, güvenlik duvarı, EKL (Erişim Kontrol Listesi), DNS sorunları, arka uç sunucusunun kullanılabilirliği vb.

Not: Hata mesajındaki durum kodu (faultstring) simgesi, sorunun üst düzey nedenini belirtir.
BAŞUCU KİTABI

protocol.http.Response306Reserved
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Response Status code 306 is reserved, so can't be used.
  • Olası neden:

Bu hata, arka uç sunucusu 306 durum kodunu Apigee Edge'e ekleyin.

306 durum kodu HTTP spesifikasyonu. Geçerli HTTP spesifikasyonuna göre bu kod ayrılmıştır ve kullanılmamalıdır.
  • HTTP Spesifikasyonu:
 RFC 7231, bölüm 6.3.5: 306 Ayrılmış

Düzelt

306 durum kodu ayrılmış olduğundan, arka uç sunucunuz bir yanıt verelim.

protocol.http.Response405WithoutAllowHeader
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Received 405 Response without Allow Header
  • Olası neden:
 Arka uç sunucusu "Allow" başlığı olmadan 405 Method Not Allowed durum kodu.
  • HTTP Spesifikasyonu:

RFC 7231, bölüm 6.5.5: 405 Yönteme İzin Verilmiyor ve RFC 7231, bölüm 7.4.1: İzin ver
BAŞUCU KİTABI

protocol.http.ResponseWithBody
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Received {status_code} Response with message body
  • Olası neden:

Bu hata, arka uç sunucusundan Apigee Edge'e verilen HTTP yanıtı 204 No Content veya 205 Reset Content ancak şunu içeriyor: yanıt gövdesi ve/veya aşağıdaki başlıklardan biri veya daha fazlası:

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • HTTP Spesifikasyonu:

RFC 7231, bölüm 6.3.5: 204 İçerik Yok ve RFC 7231, bölüm 6.3.6: 205 İçeriği Sıfırlama
BAŞUCU KİTABI

protocol.http.TooBigBody
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Body buffer overflow
  • Olası neden:
 Bu hata, istemci uygulama tarafından Apigee Edge'e yapılan HTTP isteği, Apigee Edge'de izin verilen sınırın üzerinde.
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.TooBigHeaders
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 response headers size exceeding {limit}
  • Olası neden:
 Bu hata, olarak, Apigee Edge'e HTTP yanıtının bir parçası olarak arka uç sunucusundaki Apigee Edge'de izin verilen sınır.
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.TooBigLine
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 response line size exceeding {limit}
  • Olası neden:
 Bu hata, arka uç sunucusu tarafından yanıt satırının boyutu Apigee Edge'e verilen HTTP yanıtının bir bölümü Apigee'de izin verilen sınırdan daha fazla Kenar.
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.UnsupportedEncoding
  • HTTP durum kodu:
 415 Unsupported Media
  • Hata mesajı:
 Unsupported Encoding "{encoding}"
  • Olası neden:
 Bu hata, Content-Encoding üstbilgisi HTTP yanıtının bir parçası olarak arka uç sunucusunda kodlama/yüklü başka bir biçim Apigee Edge tarafından destekleniyor.
  • HTTP Spesifikasyonu:
 RFC 7231, bölüm 6.5.13: 415 Desteklenmeyen Medya Türü
BAŞUCU KİTABI

security.util.*

security.util.KeyAliasNotFound
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • Olası neden:

Bu hata, TargetEndpoint dosyasında başvurulan belirli KeyAlias'ın veya TargetServer ilgili Anahtar Deposu'nda bulunamadı.

Düzelt

TargetEndpoint veya TargetServer'da belirtilen KeyAlias'ın bulunduğundan emin olun. mevcut ve belirli bir Anahtar Deposu'nun parçası.

security.util.TrustStoreWithNoCertificates
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 TrustStore {truststore_name} has no certificates
  • Olası neden:

Bu hata, TargetEndpoint öğesinde başvurulan belirli Truststore veya TargetServer herhangi bir sertifika içermiyor.

Düzelt

Arka uç sunucusunun sertifikasını doğrulamak ve sertifikanın Truststore'u bir TargetEndpoint veya TargetServer'da kullanmak istiyorsanız Truststore'un arka uç sunucusunun geçerli sertifikalarını içerdiğinden emin olun.