Jika Anda mengalami error saat memanggil operasi API, salin pesan error tersebut ke halaman OpenAPI Troubleshoot untuk menemukan solusi.
Memperoleh pesan error
Dari halaman debugging OpenAPI Explorer
Dari pemanggilan SDK
Dari CLI
Dari Terraform
Dari Alibaba Cloud Developer Toolkit
Mendiagnosis error API
Untuk melakukan kueri pesan error lintas akun Alibaba Cloud yang berbeda atau untuk Pengguna RAM yang berbeda dalam akun yang sama, Anda harus terlebih dahulu mendapatkan izin yang diperlukan. Untuk informasi selengkapnya, lihat Memberikan izin untuk diagnosis error API cross-account.
Setelah memperoleh pesan error, Anda dapat menyalin respons error JSON lengkap atau cukup menyalin nilai parameter RequestId, Code, atau Message ke halaman untuk menemukan solusi.
Sebagai contoh, hasil berikut dikembalikan ketika Anda memanggil operasi RunInstances dari Elastic Compute Service (ECS):
{
"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"
}Daftar berikut menjelaskan parameter-parameter tersebut:
RequestId: ID permintaan. Anda dapat menyalin ID permintaan ini ke halaman untuk memperoleh solusi.
HostId: ID host server.
Code: kode kesalahan.
Message: pesan error detail. Gunakan pesan ini untuk memecahkan masalah pada parameter permintaan. Dalam contoh ini, pesan tersebut menunjukkan bahwa ImageId yang diberikan tidak valid. Untuk mengatasi error ini, gunakan ID image yang valid.
Recommend: tautan langsung ke halaman diagnostik error untuk masalah spesifik ini.
Dalam beberapa skenario, seperti saat menggunakan SDK, Anda mungkin tidak mendapatkan respons error JSON lengkap. Anda tetap dapat mendiagnosis masalah tersebut dengan hanya menyalin nilai parameter RequestId, Code, atau Message ke halaman . Penggunaan RequestId direkomendasikan untuk hasil yang paling akurat.
Gambar berikut menunjukkan cara menggunakan ID permintaan untuk memperoleh solusi diagnostik.
Menampilkan solusi diagnostik
Halaman OpenAPI Troubleshoot berisi tab Diagnostic Solution dan Log Information. Tab Diagnostic Solution menampilkan solusi yang sesuai untuk suatu error. Dalam contoh ini, solusi berikut diberikan untuk pesan error The specified ImageId does not exist.:
The specified image does not exist under this user account. Check whether the image ID is correct.
Berdasarkan solusi ini, Anda harus memastikan bahwa parameter `ImageId` dalam permintaan Anda benar.
Meninjau log dan detail permintaan
Jika Anda tidak menyimpan badan permintaan asli, Anda dapat mengambil parameter permintaan, respons, dan informasi lainnya dari halaman OpenAPI Troubleshoot.
Dengan menggunakan request ID "6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581" sebagai contoh, buka tab Log Information. Tab ini menyediakan analisis visual jejak pemanggilan API, respons error lengkap, serta konten permintaan asli. Informasi ini membantu Anda mengidentifikasi dan menyelesaikan masalah tersebut.
