Bu konuda API Gateway hata kodları açıklanmaktadır.
1. VPC türündeki API Gateway örnekleri için hata kodları
Bu bölümde açıklanan hata kodları, VPC türündeki shared or serverless instances ve VPC türündeki dedicated instances için geçerlidir.
Bir istemci tarafından alınan yanıtta
X-Ca-Error-Codebaşlığı boş değilse hata kodu API Gateway tarafından oluşturulur. Bu tür bir hata kodu altı karakterlik bir dizedir. Aşağıdaki tabloda API Gateway tarafından oluşturulabilecek tüm olası hata kodları listelenmiştir. Ayrıntılı hata iletisi içinX-Ca-Error-Messagebaşlığına bakın.X-Ca-Error-Codebaşlığı boşsa HTTP durum kodu bir arka uç hizmeti tarafından oluşturulur. API Gateway, arka uç hizmetinden gelen hata bilgilerini doğrudan iletir.
Hata kodu | HTTP durum kodu | İleti | Açıklama |
I400HD | 400 | Invalid Header | HTTP isteği başlığı geçersiz olduğu için döndürülen hata iletisi. |
I400MH | 400 | Header | HTTP isteği başlığı eksik olduğu için döndürülen hata iletisi. |
I400BD | 400 | Invalid Body: ${Reason} | HTTP isteği gövdesi geçersiz olduğu için döndürülen hata iletisi. |
I400PA | 400 | Invalid Request Path | HTTP isteği yolu geçersiz olduğu için döndürülen hata iletisi. |
I405UM | 405 | Unsupported Method | HTTP isteği yöntemi desteklenmediği için döndürülen hata iletisi. |
I400RU | 400 | Invalid Request Uri | HTTP isteği URL'si geçersiz olduğu için döndürülen hata iletisi. |
I403PT | 403 | Invalid protocol ${Protocol} unsupported | API yapılandırmasına göre protokol desteklenmediği için döndürülen hata iletisi. API yapılandırmasını kontrol edin. |
I413RL | 413 | Request body too Large | İstek gövdesi çok büyük olduğu için döndürülen hata iletisi. Daha fazla bilgi için bkz. Sınırlar. |
I413UL | 413 | Request URL too Large | İstek URL'si çok uzun olduğu için döndürülen hata iletisi. Daha fazla bilgi için bkz. Sınırlar. |
I400CT | 400 | Invalid Content-Type: | Content-Type değeri geçersiz olduğu için döndürülen hata iletisi. |
I404DO | 404 | Invalid Domain | Bilinmeyen bir alan adı istendiği için döndürülen hata iletisi. Çağrı için bağlı bir alan adı kullanın. |
I410GG | 410 | Group's instance invalid | Geçersiz bir örnek istendiği için döndürülen hata iletisi. API grubu mevcut örneğe ait olmayabilir. |
I400SG | 400 | Invalid Stage | Bilinmeyen bir ortam istendiği için döndürülen hata iletisi. |
I404NF | 404 | API not found ${Reason} | İstekteki yol ve yöntem parametrelerine göre mevcut ortamda API bulunamadığı için döndürülen hata iletisi. Daha fazla bilgi için bkz. I404NF hatası bildirilirse ne yapmalıyım? |
X400PM | 400 | Invalid plugin meta ${PluginName} ${Reason} | Eklenti meta verileri geçersiz olduğu için döndürülen hata iletisi. |
X500ED | 500 | Expired api definition | Eski sürümlerin süresi dolmuş meta verileri artık yeni API Gateway sürümü tarafından desteklenmediği için döndürülen hata iletisi. Eski bir sürümün meta verilerini değiştirmek için destek talebi oluşturun. |
X500AM | 500 | Invalid Api Meta, try deploy again or contact us via ticket | Kaydedilen meta veri biçimi geçersiz olduğu için döndürülen hata iletisi. Bu sorunu çözmek için destek talebi oluşturun. |
X403DG | 403 | Bad Domain or Group: ${Reason} | API grubunun verileri geçersiz olduğu için döndürülen hata iletisi. |
B451DO | 451 | Unavailable Domain for Legal Reasons | Alan adı ilgili yasa veya düzenlemelerin gereksinimlerini karşılamadığı için döndürülen hata iletisi. |
B451GO | 451 | Unavailable Group for Legal Reasons | API grubu ilgili yasa veya düzenlemelerin gereksinimlerini karşılamadığı için döndürülen hata iletisi. |
B403OD | 403 | Provider Account Overdue | API sağlayıcısının ödemesi geciktiği için döndürülen hata iletisi. API Alibaba Cloud Marketplace üzerinden satın alındıysa hizmet sağlayıcısıyla iletişime geçin. |
A401AC | 401 | Invalid AppCode ${Reason} | AppCode kimlik doğrulaması kullanılıyor ancak AppCode bulunamadığı için döndürülen hata iletisi. Uygulamanın yetkilendirilip yetkilendirilmediğini ve AppCode'un doğru olup olmadığını kontrol edin. |
A400IK | 400 | Invalid AppKey | Anahtar-parola çifti kullanarak yetkilendirme yaparken AppKey bulunamadığı için döndürülen hata iletisi. |
A403IS | 403 | Invalid Signature, Server StringToSign: | İmza geçersiz olduğu için döndürülen hata iletisi. Daha fazla bilgi için bkz. Geçersiz imza. |
A403EP | 403 | App authorization expired | Yetkilendirme süresi dolduğu için döndürülen hata iletisi. İzinleri yeniden verin. |
A403PR | 403 | Plugin Authorization Needed | Eklenti yetkilendirmesi gerektiği için döndürülen hata iletisi. |
A400MA | 400 | Need authorization, | AppCode modunda veya anahtar-parola çifti kullanarak yetkilendirme gerektiği için döndürülen hata iletisi. |
I400I5 | 400 | Invalid Content-MD5 ${Reason} | Content-MD5 değeri geçersiz olduğu için döndürülen hata iletisi. |
I400NC | 400 | X-Ca-Nonce is required | Zorla Nonce Kontrolü (Anti Replay by X-Ca-Nonce) seçildikten sonra X-Ca-Nonce başlığı sağlanmadığı için döndürülen hata iletisi. |
S403NU | 403 | Nonce Used | Yineleme saldırısı algılandığı için döndürülen hata iletisi. İstekteki X-Ca-Nonce başlığı daha önce kullanılmıştır. |
S403TE | 403 | X-Ca-Timestamp is expired | X-Ca-Timestamp başlığında sağlanan zaman damgasının süresi dolduğu için döndürülen hata iletisi. Zaman damgası 15 dakika boyunca geçerlidir. |
I400MP | 400 | Parameter | API yapılandırmasındaki bir veya daha fazla zorunlu parametre boş bırakıldığı için döndürülen hata iletisi. |
I400IP | 400 | Invalid parameter | API yapılandırmasındaki bir parametrenin değeri geçersiz olduğu için döndürülen hata iletisi. |
I400JR | 400 | JWT required | JSON Web Token (JWT) ile ilgili parametreler bulunamadığı için döndürülen hata iletisi. |
S403JI | 403 | Claim | JWT kimlik doğrulama eklentisinde preventJtiReplay parametresi true olarak ayarlandığında istekte geçerli bir jti claim içermemediği için döndürülen hata iletisi. |
A403SV | 403 | Claim | JWT kimlik doğrulama eklentisinde preventJtiReplay parametresi true olarak ayarlandığında istekte yer alan jti claim daha önce kullanıldığı için döndürülen hata iletisi. |
I400JD | 400 | JWT Deserialize Failed: | İstekteki JWT çözümlenemediği için döndürülen hata iletisi. |
A403JT | 403 | Invalid JWT: ${Reason} | İstekteki JWT geçersiz olduğu için döndürülen hata iletisi. |
A403JK | 403 | No matching JWK, | İstekteki JWT'de yapılandırılan kid ile eşleşen bir JWK bulunamadığı için döndürülen hata iletisi. |
A403JE | 403 | JWT is expired at | İstekteki JWT'nin süresi dolduğu için döndürülen hata iletisi. |
I400JP | 400 | Invalid JWT plugin config: ${JWT} | JWT kimlik doğrulama eklentisi yanlış yapılandırıldığı için döndürülen hata iletisi. |
A403OL | 403 | OAuth2 Login failed: ${Reason} | |
A403OU | 403 | OAuth2 Get User Info failed: ${Reason} | |
A401OT | 401 | Invalid OAuth2 Access Token | |
A401OM | 401 | OAuth2 Access Token is required | |
T429ID | 429 | Throttled by INNER DOMAIN Flow Control, ${Domain} is a test domain, only 1000 requests per day | API çağrı limiti aşıldığı için döndürülen hata iletisi. Varsayılan ikinci düzey alan adını kullanıyorsanız limit Çin anakarasındaki bölgeler için günde 1.000 çağrı, Çin anakarası dışındaki bölgeler için günde 100 çağrıdır. |
T429IN | 429 | Throttled by INSTANCE Flow Control | Mevcut örnek için kısıtlama tetiklendiği için döndürülen hata iletisi. Örneğin teknik özelliklerini yükseltin. |
T429GR | 429 | Throttled by GROUP Flow Control | Mevcut API grubu için kısıtlama tetiklendiği için döndürülen hata iletisi. Örneğin teknik özelliklerini yükseltin. |
T429PA | 429 | Throttled by API Flow Control | Kısıtlama eklentisinde tanımlanan varsayılan API düzeyindeki kısıtlama ilkesi tetiklendiği için döndürülen hata iletisi. |
T429PR | 429 | Throttled by PLUGIN Flow Control | Kısıtlama eklentisinde tanımlanan özel kısıtlama ilkesi tetiklendiği için döndürülen hata iletisi. |
T429SR | 429 | Throttled by SERVER Flow Control | |
T429MR | 429 | Too Many Requests, throttle by | |
A403IP | 403 | Access denied by IP Control Policy | IP adresi tabanlı erişim kontrolü eklentisi tarafından erişim reddedildiği için döndürülen hata iletisi. |
A403IN | 403 | Access from internet is disabled ${Reason} | API'ler ve API grupları Internet üzerinden çağrılamaz. Bunları özel ağ üzerinden çağırabilirsiniz. Daha fazla bilgi için bkz. VPC Tabanlı API Çağrıları. |
A403VN | 403 | Access from invalid VPC is disabled | Belirtilen VPC üzerinden erişim reddedildiği için döndürülen hata iletisi. |
A403AC | 403 | Access Control Forbidden by ${RuleName} | Erişim kontrolü eklentisi tarafından erişim reddedildiği için döndürülen hata iletisi. |
A403CO | 403 | Cross origin resource forbidden ${Domain} | Çapraz kaynak paylaşımı (CORS) eklentisi tarafından erişim reddedildiği için döndürülen hata iletisi. |
I404CO | 404 | Cross origin resource not found ${Method} - ${Path} | CORS eklentisi tarafından ön denetim yapılan istek yolu ve istek yöntemine göre API tanımı bulunamadığı için döndürülen hata iletisi. |
I404CH | 404 | Content not cached, with | |
I404NR | 404 | ${Resource} not found | |
I404SR | 404 | Stage route missing: ${Reason} | |
B403MO | 403 | Api Market Subscription overdue | API sağlayıcısının ödemesi geciktiği için döndürülen hata iletisi. Hizmet sağlayıcısıyla iletişime geçin. |
B403MQ | 403 | Api Market Subscription quota exhausted | Alibaba Cloud Marketplace'ten satın alınan API'lerin kotası tükendiği için döndürülen hata iletisi. Kotayı yenileyin. |
B403ME | 403 | Api Market Subscription expired | API aboneliğinin süresi dolduğu için döndürülen hata iletisi. Başka bir abonelik oluşturun. |
B403MI | 403 | Api Market Subscription invalid | Abone olunan API hizmeti geçersiz olduğu için döndürülen hata iletisi. |
D504RE | 504 | Backend domain | Arka uç alan adı çözümlenemediği için döndürülen hata iletisi. Arka uç alan adını doğrulayın. |
D504IL | 504 | Backend domain | Arka uç hizmetinin alan adı çözümleme sonucu geçersiz olduğu için döndürülen hata iletisi. |
D504CO | 504 | Backend service connect failed | API Gateway arka uç hizmetine erişemediği için döndürülen hata iletisi. Bu durumda güvenlik grubu ve güvenlik duvarı ayarlarını veya arka uç sunucusunun durumunu kontrol etmeniz gerekir. Daha fazla bilgi için bkz. D504CO hatalarını giderme. |
504 | Backend service connect failed | Arka uç hizmetine bağlantı havuzu kuruluğundan dolayı bağlanılamadığı için döndürülen hata iletisi. Örneğin teknik özelliklerini yükseltin. | |
D504CS | 504 | Backend http ssl connect failed | Arka uç hizmetine HTTPS üzerinden bağlanılamadığı için döndürülen hata iletisi. Arka uç hizmeti için yapılandırılan protokolün bağlantı noktasıyla eşleşip eşleşmediğini kontrol edin. |
D504TO | 504 | Backend service request timeout | Arka uç hizmetine yapılan isteğin zaman aşımına uğradığı için döndürülen hata iletisi. Arka uç zaman aşımı süresini artırın veya arka uç hizmetinin işleme kapasitesini iyileştirin. |
X504VE | 504 | Backend service vpc mapped failed | Arka uç hizmetinin VPC eşlemesi başarısız olduğu için döndürülen hata iletisi. |
D503BB | 503 | Backend circuit breaker busy | API devre kesici tarafından korunduğu için döndürülen hata iletisi. |
D503CB | 503 | Backend circuit breaker open, ${Reason} | API için devre kesici açık olduğu için döndürülen hata iletisi. Arka uç hizmetinin performansını kontrol edin. |
I508LD | 508 | Loop Detected | Geri döngü çağrısı algılandığı için döndürülen hata iletisi. |
I404DD | 404 | Device id ${DeviceId} not found | WebSocket üzerinden API'leri çağırırken cihaz kimliği bulunamadığı için döndürülen hata iletisi. |
A403FC | 403 | Function Compute AssumeRole failed ${RequestId}:${Reason} | Arka uç hizmeti olarak Function Compute kullanılırken bir yetkilendirme hatası oluştuğu için döndürülen hata iletisi. |
D502FC | 502 | Function Compute response invalid: ${Reason} | Arka uç hizmeti olarak Function Compute kullanılırken arka uç hizmetinden gelen yanıt geçersiz olduğu için döndürülen hata iletisi. |
N502RE | 502 | Send Response IO Exception: ${Reason} | Sunucu istemciye yanıt gönderirken bir özel durum oluştuğu için döndürülen hata iletisi. İstemcinin bağlantıyı önceden kapatıp kapatmadığını veya bir ağ hatası olup olmadığını kontrol edin. |
X500ER | 500 | Service Internal Error | Dahili sunucuda bir hata oluştuğu için döndürülen hata iletisi. Bu sorunu çözmek için API Gateway teknik desteğiyle iletişime geçmek üzere destek talebi oluşturun. |
X503BZ | 503 | Service Busy | API Gateway hizmeti meşgul olduğu için döndürülen hata iletisi. Daha sonra tekrar deneyin. |
X504TO | 504 | Service timeout | API Gateway'de zaman aşımı hatası oluştuğu için döndürülen hata iletisi. Teknik destekle iletişime geçmek için destek talebi oluşturun. |
Hizmet güncellendiğinde veya yeni özellikler eklendiğinde belirli hata kodları değişebilir.
2. API işlem yönetimi için hata kodları
CreateAPI, ModifyAPI ve DeleteAPI gibi API Gateway tarafından sağlanan API işlemlerini çağırdığınızda aşağıdaki bölümlerde listelenen hata kodları bildirilebilir.
2,1 Sunucular için hata kodları
Bildirilen HTTP durum kodu 5XX'dir ve bu durum hizmetlerin kullanılamadığını gösterir. Bu durumda daha sonra tekrar denemenizi öneririz.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2,2 İstemciler için hata kodları
Bildirilen HTTP durum kodu 4XX'tir ve bu durum bir iş hatasını gösterir. İş hatası; bir parametre hatası, erişim kontrolünden kaynaklanan bir hata veya iş mantığı hatası olabilir. Sorunları gidermeden önce hata bilgilerini dikkatlice inceleyin.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2,3 İstemciler için ortak hata kodları
Bildirilen HTTP durum kodu 4XX'tir ve bu durum bir iş hatasını gösterir. Alibaba Cloud hizmetlerinin API'lerini çağırdığınızda bildirilebilir. İş hatası; geçersiz bir istek biçimi, yanlış bir istek yöntemi, eksik zorunlu parametreler, geçersiz bir parametre değeri biçimi, geçersiz bir imza veya kısıtlamadan kaynaklanan bir hata olabilir. Sorunları gidermeden önce hata bilgilerini dikkatlice inceleyin.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|