Saat mengakses Layanan Alibaba Cloud, setiap permintaan akan diberi RequestId unik oleh Alibaba Cloud. Anda dapat menggunakan RequestId tersebut untuk melihat informasi permintaan melalui diagnostik OpenAPI atau ActionTrail. RequestId umumnya digunakan untuk mendiagnosis kesalahan. Jika panggilan OpenAPI gagal, Anda dapat memasukkan RequestId ke platform diagnostik OpenAPI guna mengidentifikasi penyebab dan solusi kesalahan tersebut. Topik ini menggunakan contoh umum kesalahan izin untuk menunjukkan cara memperoleh RequestId dalam berbagai skenario.
Topik ini hanya berlaku untuk API yang tersedia di Portal OpenAPI.
Metode
RequestId dapat diperoleh dengan metode berikut. Jika suatu permintaan mengembalikan kesalahan, Anda dapat menggunakan RequestId tersebut di platform diagnostik OpenAPI untuk mencari solusi. Untuk kesalahan izin, pesan kesalahan juga mencakup parameter AccessDeniedDetail, yang menyediakan operasi tidak sah secara spesifik (AuthAction) serta pesan diagnostik terenkripsi (EncodedDiagnosticMessage).
Menggunakan alat pengembang browser di Konsol
Saat melakukan operasi di Konsol, buka alat pengembang browser Anda, lalu filter permintaan yang mengandung "api.json?" untuk menemukan RequestId dari permintaan tersebut.
Menggunakan Portal OpenAPI
Saat melakukan panggilan uji dari OpenAPI Portal, nilai RequestId akan muncul di respons.
Menggunakan SDK
Saat menggunakan SDK Alibaba Cloud, Anda biasanya dapat mengambil RequestId langsung dari tanggapan API. Jika terjadi kesalahan, Anda dapat menangkap pengecualian untuk mendapatkan pesan kesalahan tersebut.
Menggunakan Alibaba Cloud CLI
Saat melakukan panggilan API menggunakan Alibaba Cloud CLI, nilai RequestId akan ditampilkan di output standar.
Menggunakan Terraform
Karena Terraform mengoordinasikan beberapa panggilan API untuk mengelola sumber daya, ID permintaan tunggal biasanya tidak ditampilkan dalam operasi Terraform apply yang berhasil. Namun, jika terjadi kegagalan pada salah satu panggilan API selama proses tersebut, output kesalahan akan mencantumkan ID permintaan yang relevan untuk keperluan debugging.
Klien API Lainnya
Jika Anda menggunakan klien API yang berbeda, seperti cURL atau Postman, ID permintaan akan disertakan dalam header respons setiap panggilan API. Sebagai contoh, jika panggilan API yang menggunakan Signature V3 gagal, ID permintaan dikembalikan dalam tanggapan eror.
Gunakan request ID untuk diagnostik
Pemecahan Masalah OpenAPI
Di halaman , Anda dapat memasukkan RequestId untuk menelusuri rantai panggilan lengkap, informasi dasar, detail otentikasi, dan konten dari permintaan terkait. Jika permintaan menghasilkan error, Anda juga dapat menemukan solusinya.
Jika permintaan ditolak karena izin RAM yang tidak mencukupi, Anda dapat memperoleh parameter EncodedDiagnosticMessage dari pesan kesalahan, lalu memanggil operasi DecodeDiagnosticMessage untuk mendekode informasi izin tersebut.
ActionTrail
Anda dapat memanggil operasi LookupEvents dan meneruskan RequestId untuk mengkueri detail event. Saat memanggil operasi ini, teruskan nilai-nilai berikut untuk parameter LookupAttribute:
Parameter | Deskripsi |
Key | Tetapkan nilai ini ke EventId. |
Value | Masukkan RequestId yang sebenarnya. |
