Memahami kesalahan sementara

  • 3 menit

Di bagian ini, kita akan mendiagnosis dan memecahkan masalah pengecualian layanan Azure Cosmos DB tidak tersedia. Kami biasanya dapat mengidentifikasi pengecualian ini ketika permintaan kami mengembalikan kode status 503. Ini berarti bahwa operasi tidak dapat diselesaikan karena layanan tidak tersedia. Ada beberapa alasan mengapa pengecualian ini dapat muncul. Kode status dapat ditampilkan karena masalah konektivitas jaringan atau ketersediaan layanan. Dalam kebanyakan kasus, operasi dapat dicoba lagi dengan aman dan masalah mungkin telah dipecahkan. Jika masalah berlanjut, Anda harus menghubungi dukungan Azure. Mari kita evaluasi tiga kasus utama saat kode status ini ditampilkan.

Port yang diperlukan diblokir

Verifikasi bahwa port berikut diaktifkan untuk SQL API.

mode Koneksi ion Protokol yang didukung SDK yang didukung Port API/Layanan
Gateway HTTPS Semua SDK SQL (443)
Langsung TCP .NET SDK, Java SDK Saat menggunakan titik akhir publik/layanan: port dalam rentang 10000 hingga 20000. Saat menggunakan titik akhir privat: port dalam rentang 0 hingga 65535

Masalah konektivitas sementara di pihak klien

Pengecualian ini bisa terjadi saat terjadi masalah konektivitas sementara yang menyebabkan waktu habis. Jejak tumpukan yang terkait dengan skenario ini akan berisi kesalahan TransportException. Kesalahan ini bisa terlihat seperti:

TransportException: A client transport error occurred: The request timed out while waiting for a server response. 
(Time: xxx, activity ID: xxx, error code: ReceiveTimeout [0x0010], base error: HRESULT 0x80131500

Kesalahan ini harus dipecahkan seperti kesalahan batas waktu permintaan (kode status 408).

Gangguan Layanan

Periksa halaman Status Azure untuk melihat apakah terdapat masalah yang sedang terjadi.