Bir OpenAPI çağrısı sırasında bir hatayla karşılaştığınızda, hata iletisini OpenAPI Sorun Giderme sayfasına kopyalayarak çözüm önerisini otomatik olarak alabilirsiniz.
Hata iletisini alma
API çevrimiçi hata ayıklama sayfası
SDK çağrısı
CLI çağrısı
Terraform çağrısı
Alibaba Cloud Developer Toolkit
OpenAPI sorunlarını tanılama
Farklı Alibaba Cloud hesaplarında veya aynı hesap altındaki farklı Resource Access Management (RAM) kullanıcıları arasında hata iletilerini sorgulamak için önce yetkilendirme yapın, ardından tekrar deneyin.
Hata iletisini aldıktan sonra, tam JSON içeriğini veya yalnızca RequestId, Code ya da Message alanını sayfasına kopyalayarak çözüm önerisini otomatik olarak alabilirsiniz.
Örneğin, Elastic Compute Service'in RunInstances API'sini çağırırken bir hata aldığınızda hata iletisi şu şekilde görünür:
{
"RequestId": "6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581",
"HostId": "ecs.ap-southeast-3.aliyuncs.com",
"Code": "InvalidImageId.NotFound",
"Message": "The specified ImageId does not exist.",
"Recommend": "https://api.alibabacloud.com/troubleshoot?intl_lang=EN_US&q=InvalidImageId.NotFound&product=Ecs&requestId=6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581"
}Parametrelerin anlamları şöyledir:
RequestId: İstek için benzersiz bir tanımlayıcıdır. Bu değeri sayfasına kopyalayarak çözüm önerisini otomatik olarak alabilirsiniz.
HostId: API isteği için hizmet uç noktasıdır.
Code: Hata kodudur.
Message: Ayrıntılı hata bilgilerini içerir. İstek parametrelerinizi kontrol etmek için bu alanı kullanabilirsiniz. Bu örnekte hata, ImageId parametresine geçersiz bir görüntü kimliği girildiği için oluşmuştur. Sorunu geçerli bir görüntü kimliği kullanarak çözün.
Recommend: Hata tanılama sayfasına doğrudan bağlantı sağlar. Sorun giderme çözümüne doğrudan gitmek için bu alanı kopyalayın.
Gerçek dünya senaryolarında—örneğin bir SDK kullanırken—tam JSON hata yanıtını alamayabilirsiniz. Bu durumda, yalnızca RequestId, Code veya Message değerlerini sayfasına kopyalayarak çözüm önerisini alabilirsiniz. En doğru sonucu elde etmek için RequestId kullanmanız önerilir.
RequestId kullanılarak alınan çözüm önerisi aşağıda gösterildiği gibi görünür:
Tanılama çözümünü görüntüleme
Yukarıda gösterildiği gibi, sayfanın altında Tanılama Çözümü ve Günlük Bilgileri olmak üzere iki sekme bulunur. Tanılama Çözümü sekmesi eşleşen çözüm önerisini gösterir. Örneğin, hata iletisi The specified ImageId does not exist. ise sağlanan çözüm şudur:
The specified image does not exist under this account. Check whether the image ID is correct.ImageId parametre değerinin doğru olduğunu doğrulamak için çözümdeki talimatları izleyin.
İstek parametrelerini kontrol etme
Gerçek dünya senaryolarında, hata oluştuğunda orijinal istek gövdesini kaydetmemiş olabilirsiniz. Yine de OpenAPI Troubleshooting aracını kullanarak istek parametrelerini, yanıtı ve diğer ayrıntıları alabilirsiniz.
RequestId değeri 6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581 olan hatayı örnek alalım. Günlük Bilgileri sekmesine tıklayın. Aşağıda gösterildiği gibi, çağrı zincirinin görsel analizini, tam hata iletisini ve orijinal istek içeriğini görüntüleyebilirsiniz. Sorunu daha hassas bir şekilde tespit etmek ve çözmek için bu günlükleri kullanın.
