Bir API çağrısı başarısız olursa sunucu bir hata iletisi döndürür. Bu konu, hata kodlarını ve çözüm yollarını açıklar.
Genel Bakış
Bir API isteği başarısız olduğunda sunucu bir hata iletisi döndürür. Bu ileti, bir HTTP durum kodu ve belirli hata ayrıntılarını içeren bir yanıt gövdesi barındırır. Yanıt gövdesindeki hata ayrıntıları aşağıdaki biçimdedir:
{
"errorCode" : <ErrorCode>,
"errorMessage" : <ErrorMessage>
}
Bu konu, hataları nasıl ele alacağınız konusunda rehberlik sunar. Hata kodlarına ilişkin ayrıntılı bilgiyi API Error Center üzerinden de bulabilirsiniz. Daha fazla bilgi için bkz. Simple Log Service API Error Center.
İşleme özel hata kodları
İşleme özel hata kodları her API işlemine özgüdür. Bu kodlar için ilgili API işleminin belgelerine bakın.
Ortak hata kodları
Ortak hata kodları çoğu API işlemi için geçerlidir. Aşağıdaki tabloda, API hata yanıtlarında dönebilecek ortak hata kodları açıklanmaktadır.
Simple Log Service, sorun gidermenize yardımcı olmak amacıyla günlük sorgulama ve analizi için ortak hatalar sağlar. Daha fazla bilgi için bkz. Günlük sorgulama ve analizi için ortak hatalar.
HTTP durum kodu | Hata kodu | Hata iletisi | Açıklama | Önerilen eylemler |
400 | RequestTimeExpired | İstek zamanı requestTime süresi dolmuşken sunucu saati server time. | İstek ile sunucu arasındaki saat farkı 15 dakikayı aşıyor. | İstemcideki saati kontrol edin ve isteği daha sonra yeniden gönderin. |
400 | InvalidRequestTime | İstek zamanı requestTime RFC 822 standardına uymuyor. | İstekteki Date üstbilgisinin değeri RFC 822 standardına uygun değil. | İstek üstbilgisini kontrol edin ve Date üstbilgisi değerinin RFC 822 standardına uyduğundan emin olun. |
400 | InvalidHost | Host üstbilgisi Host geçersiz. | İstekteki Host üstbilgisi geçersiz. | İstek üstbilgisini kontrol edin ve Host üstbilgisi biçiminin doğru olduğundan emin olun. |
400 | ProjectAlreadyExist | Proje ProjectName zaten var. | Proje adı zaten mevcut. | Proje adları bir Alibaba Cloud bölgesi içinde genel olarak benzersiz olmalıdır. Proje adını değiştirin ve isteği yeniden gönderin. |
400 | PostBodyInvalid | İstek gövdesi geçerli bir JSON nesnesi değil. | İstek gövdesi JSON biçiminde değil. | İstek gövdesini düzeltin ve isteği tekrar gönderin. |
400 | InvalidContentType | Content-Type type desteklenmiyor. | Content-Type desteklenmiyor. | Content-Type tanımının doğru yapıldığından emin olun. |
400 | ParameterInvalid | Http extend authorization : authorization çifti geçersiz. | Authorization istek üstbilgisi geçersiz. | Authorization istek üstbilgisinin doğru tanımlandığından emin olun. |
Http extend x-log-bodyrawsize : x-log-bodyrawsize çifti geçersiz. | X-log-bodyrawsize istek üstbilgisi geçersiz. | X-log-bodyrawsize istek üstbilgisinin doğru tanımlandığından emin olun. | ||
Http extend x-log-compresstype : x-log-compresstype çifti geçersiz. | X-log-compresstype istek üstbilgisi geçersiz. | X-log-compresstype istek üstbilgisinin doğru tanımlandığından emin olun. | ||
x-log-signaturemethod: x-log-signaturemethod çifti geçersiz. | X-log-signaturemethod geçersiz. | X-log-signaturemethod istek üstbilgisinin doğru olduğundan emin olun. | ||
400 | MissingParameter | Eksik sorgu anahtarı: parameter. | Gerekli bir istek parametresi eksik. | Eksik istek parametresini ekleyin ve isteği yeniden gönderin. İstek imzasının yapısı ve oluşturma süreci hakkında daha fazla bilgi için bkz. İstek imzası. |
Eksik http extend header key: authorization. | Authorization istek üstbilgisi eksik. | Authorization istek üstbilgisini ekleyin ve isteği yeniden gönderin. İstek imzasının yapısı ve oluşturma süreci hakkında daha fazla bilgi için bkz. İstek imzası. | ||
Eksik http extend header key: x-log-bodyrawsize. | X-log-bodyrawsize istek üstbilgisi eksik. | X-log-bodyrawsize istek üstbilgisini ekleyin ve isteği yeniden gönderin. İstek imzasının yapısı ve oluşturma süreci hakkında daha fazla bilgi için bkz. İstek imzası. | ||
Eksik http extend header key: x-log-date. | X-log-date istek üstbilgisi eksik. | X-log-date istek üstbilgisini ekleyin ve isteği yeniden gönderin. İstek imzasının yapısı ve oluşturma süreci hakkında daha fazla bilgi için bkz. İstek imzası. | ||
Eksik http extend header key: x-log-signaturemethod. | X-log-signaturemethod istek üstbilgisi eksik. | X-log-signaturemethod istek üstbilgisini ekleyin ve isteği yeniden gönderin. İstek imzasının yapısı ve oluşturma süreci hakkında daha fazla bilgi için bkz. İstek imzası. | ||
401 | SignatureNotMatch | İmza signature eşleşmiyor. | İsteğin dijital imzası eşleşmiyor. | İsteği yeniden gönderin. Hata devam ederse AccessKey'i değiştirip tekrar deneyin. Olası nedenler şunlardır:
İstek imzasının yapısı ve oluşturma süreci hakkında daha fazla bilgi için bkz. İstek imzası. |
401 | Unauthorized | AccessKeyId yetkilendirilmemiş. | Sağlanan AccessKey ID yetkilendirilmemiş. | AccessKey ID'nizin Simple Log Service erişim iznine sahip olduğunu doğrulayın. Bir Resource Access Management (RAM) kullanıcısına Simple Log Service üzerinde işlem yapma izni vermek için bkz. RAM kullanıcısı oluşturma ve izin verme. |
Sağladığınız güvenlik belirteci geçersiz. | STS belirteci geçersiz. | STS API isteğinizi kontrol edin ve STS belirtecinin geçerli olduğundan emin olun. | ||
Sağladığınız güvenlik belirtecinin süresi dolmuş. | STS belirtecinin süresi dolmuş. | Yeni bir STS belirteci isteyin ve isteği tekrar gönderin. | ||
AccessKeyId bulunamadı: AccessKey ID | AccessKey ID mevcut değil. | AccessKey ID'nizi kontrol edin. Doğru AccessKey ID'yi bulun ve isteği tekrar gönderin. | ||
AccessKeyId devre dışı bırakıldı: AccessKey ID | AccessKey ID devre dışı bırakılmış. | AccessKey ID'nizi kontrol edin, etkin olduğundan emin olun ve ardından isteği tekrar gönderin. | ||
SLS hizmetiniz engellendi. | Simple Log Service devre dışı bırakıldı. | Simple Log Service durumunu kontrol edin. Örneğin, hesabınızda gecikmiş ödeme olup olmadığını denetleyin. | ||
Proje size ait değil. | Proje geçerli kullanıcıya ait değil. |
| ||
401 | InvalidAccessKeyId | Sağladığınız access key id geçersiz: AccessKey ID. | AccessKey ID geçersiz. | AccessKey ID'nizi kontrol edin ve geçerli olduğundan emin olun. |
SLS hizmetiniz etkinleştirilmedi. | Simple Log Service etkinleştirilmedi. | Simple Log Service konsoluna giriş yaparak veya bir API işlemi çağırarak Simple Log Service'i etkinleştirin. Ardından isteği tekrar gönderin. Daha fazla bilgi için bkz. Simple Log Service nedir?. | ||
403 | WriteQuotaExceed | Yazma kotası aşıldı. | Günlük yazma kotası aşıldı. | Yazılacak günlük sayısını azaltmak için günlük yazma isteğini optimize edin. Daha fazla bilgi için bkz. Sınırlar. |
403 | ReadQuotaExceed | Okuma kotası aşıldı. | Günlük okuma kotası aşıldı. | Okunacak günlük sayısını azaltmak için günlük okuma isteğini optimize edin. Daha fazla bilgi için bkz. Sınırlar. |
403 | MetaOperationQpsLimitExceeded | Meta işlem için QPS sınırı aşıldı. | Varsayılan saniye başına sorgu (QPS) eşiği aşıldı. | İşlem sayısını azaltmak için kaynak işlemi isteğini optimize edin. Birkaç saniye sonra isteği yeniden göndermenizi öneririz. Simple Log Service, aşağıdaki yönetim API işlemleri için QPS sınırlaması uygular:
Daha fazla bilgi için bkz. Sınırlar. |
403 | ProjectForbidden | Proje ProjectName engellendi. | Proje devre dışı bırakıldı. | Proje durumunu kontrol edin. Projeniz gecikmiş ödeme nedeniyle askıya alınmış olabilir. |
404 | ProjectNotExist | Proje mevcut değil: name | Proje mevcut değil. | Proje adını kontrol edin; projenin var olduğundan ve bölgenin doğru olduğundan emin olun. |
405 | InvalidMethod | Geçersiz istek yöntemi: request URI | İstenen kaynak için istek yöntemi desteklenmiyor. | Method değerlerini kontrol edin ve tekrar deneyin. |
413 | PostBodyTooLarge | Gövde boyutu bodysize 10485760'dan küçük olmalıdır. | İstek gövdesi 10 MB'ı aşamaz. | İstek gövdesinin boyutunu ayarlayın ve isteği yeniden gönderin. |
500 | InternalServerError | Dahili sunucu hata iletisi. | Dahili bir sunucu hatası oluştu. | İsteği daha sonra yeniden gönderin. |
500 | RequestTimeout | İstek zaman aşımına uğradı. Lütfen daha sonra tekrar deneyin. | İstek zaman aşımına uğradı. | İsteği daha sonra yeniden gönderin. |
503 | ServerBusy | Sunucu meşgul, lütfen daha sonra tekrar deneyin. | Sunucu meşgul. | İsteği daha sonra yeniden gönderin. |
Hata iletisindeki italik metin, hataya ilişkin belirli bilgileri gösterir. Örneğin, ProjectNotExist hata iletisinde name yerine gerçek proje adı yer alır.