Kode Status HTTP untuk Azure Cosmos DB

  • Artikel

Artikel ini menyediakan kode status HTTP yang dikembalikan oleh operasi REST.

Kode Deskripsi
200 OK Salah satu operasi REST berikut berhasil:

- GET pada sumber daya.
- PUT pada sumber daya.
- POST pada sumber daya.
- POST pada sumber daya prosedur tersimpan untuk menjalankan prosedur tersimpan.
201 Dibuat Operasi POST untuk membuat sumber daya berhasil.
204 Tidak ada konten Operasi DELETE berhasil.
400 Permintaan buruk JSON, SQL, atau JavaScript dalam isi permintaan tidak valid.

Selain itu, 400 juga dapat dikembalikan ketika properti sumber daya yang diperlukan tidak ada atau diatur dalam isi POST atau PUT pada sumber daya.

400 juga dikembalikan ketika tingkat konsisten untuk operasi GET ditimpa oleh konsistensi yang lebih kuat dari yang ditetapkan untuk akun.

400 juga dikembalikan ketika permintaan yang memerlukan x-ms-documentdb-partitionkey tidak menyertakannya.
401 Tidak Sah 401 dikembalikan ketika Authorization header tidak valid untuk sumber daya yang diminta.
403 Dilarang Token otorisasi kedaluwarsa.

Kode 403 juga dikembalikan selama POST operasi untuk membuat sumber daya ketika kuota sumber daya telah tercapai. Contoh skenario ini adalah ketika Anda mencoba menambahkan dokumen ke koleksi yang telah mencapai penyimpanan yang disediakan.

403 juga dapat dihasilkan saat prosedur, pemicu, atau UDF yang disimpan telah ditandai untuk penggunaan sumber daya tinggi dan diblokir dari eksekusi.

403 kesalahan terlarang dihasilkan ketika aturan firewall yang dikonfigurasi di akun Azure Cosmos DB Anda memblokir permintaan Anda. Setiap permintaan yang berasal dari mesin di luar daftar yang diizinkan akan menerima respons 403.

403.3 – Kode status ini dikembalikan untuk permintaan tulis selama operasi failover manual. Kode status ini digunakan sebagai kode pengalihan oleh driver untuk meneruskan permintaan tulis ke wilayah tulis baru. Klien REST langsung harus melakukan GET di DatabaseAccount untuk mengidentifikasi wilayah tulis saat ini dan meneruskan permintaan tulis ke titik akhir tersebut.
404 Tidak ditemukan Operasi ini mencoba untuk bertindak pada sumber daya yang tidak ada lagi. Misalnya, sumber daya mungkin telah dihapus.
408 Waktu tunggu permintaan habis Operasi tidak selesai dalam jumlah waktu yang ditentukan. Kode ini ditampilkan saat prosedur tersimpan, pemicu, atau UDF (dalam kueri) tidak menyelesaikan eksekusi dalam waktu eksekusi maksimum.
409 Konflik ID yang disediakan untuk sumber daya pada operasi PUT atau POST telah diambil oleh sumber daya yang sudah ada. Gunakan ID lain untuk sumber daya untuk mengatasi masalah ini. Untuk koleksi yang dipartisi, ID harus unik dalam semua dokumen dengan nilai kunci partisi yang sama.
Kegagalan prasyarat 412 Operasi menentukan eTag yang berbeda dari versi yang tersedia di server, yaitu kesalahan konkurensi optimis. Coba lagi permintaan setelah membaca versi terbaru sumber daya dan memperbarui eTag pada permintaan.
413 Entitas terlalu besar Ukuran dokumen dalam permintaan melebihi ukuran dokumen yang diizinkan untuk sebuah permintaan. Ukuran dokumen maksimum yang diizinkan adalah 2 MB.
423 Terkunci Operasi skala throughput tidak dapat dilakukan karena operasi skala lain sedang berlangsung.
424 Dependensi gagal Ketika operasi dokumen gagal dalam cakupan transaksional operasi TransactionalBatch, semua operasi lain dalam batch dianggap sebagai dependensi yang gagal. Kode status ini menunjukkan bahwa operasi saat ini dianggap gagal karena kegagalan lain dalam cakupan transaksi yang sama.
429 Terlalu banyak permintaan Kumpulan telah melebihi batas throughput yang disediakan. Coba lagi permintaan setelah server menentukan coba lagi setelah durasi. Untuk informasi selengkapnya, lihat unit permintaan.
449 Coba Lagi Dengan Operasi mengalami kesalahan sementara. Kode ini hanya terjadi pada operasi tulis. Aman untuk mencoba kembali operasi.
500 Kesalahan Server Internal Operasi gagal karena kesalahan layanan yang tak terduga. Hubungi dukungan. Lihat Mengajukan masalah dukungan Azure.
503 Layanan Tidak Tersedia Operasi tidak dapat diselesaikan karena layanan tidak tersedia. Situasi ini dapat terjadi karena masalah konektivitas jaringan atau ketersediaan layanan. Aman untuk mencoba kembali operasi. Hubungi dukungan jika masalah berlanjut.

Kode substatus HTTP

Saat menggunakan Customer-Managed Keys (CMK) di Azure Cosmos DB, jika ada kesalahan, Azure Cosmos DB mengembalikan detail kesalahan bersama dengan kode substatus HTTP dalam respons. Anda dapat menggunakan kode substatus ini untuk men-debug akar penyebab masalah. Saat ini Azure Cosmos DB mendukung kode substatus berikut:

Kode substatus untuk masalah sisi server

Kode substatus berikut didukung oleh Azure Cosmos DB untuk masalah sisi server:

Kode substatus Deskripsi
4000 (Gagal mendapatkan/mengakses token Azure AD) Kesalahan ini terjadi jika Azure Cosmos DB tidak bisa mendapatkan token akses Azure Active Directory (Azure AD). Token ini diperlukan agar Azure Cosmos DB dapat mengakses Key Vault. Kesalahan dapat terjadi karena masalah jaringan atau masalah pusat data dan itu bukan sesuatu yang dapat dilakukan pengguna. Buat permintaan dukungan untuk menjangkau tim Azure Cosmos DB untuk mengatasi masalah tersebut.
4001 (layanan Azure AD tidak tersedia) Kesalahan ini terjadi jika layanan Azure AD tidak berfungsi atau mengalami masalah. Anda dapat memeriksa dasbor pemadaman Azure untuk memverifikasi apakah ada pemadaman yang ada. Pemadaman ini biasanya diselesaikan dalam beberapa jam. Yang terbaik adalah menghubungi tim Azure AD dan memberi tahu mereka masalah yang Anda lihat. Jika tim Azure AD menemukan bahwa tidak ada masalah, buat permintaan dukungan untuk menjangkau tim Azure Cosmos DB untuk resolusi.
4004 (layanan Key Vault tidak tersedia) Kesalahan ini terjadi jika Azure Cosmos DB mencoba mengakses Key Vault, tetapi layanan tidak tersedia. Ini bisa disebabkan oleh masalah jaringan untuk mencapai Key Vault atau layanan itu sendiri mungkin tidak berfungsi. Anda dapat memeriksa dasbor pemadaman Azure untuk memverifikasi apakah ada pemadaman yang ada. Pemadaman ini biasanya diselesaikan dalam beberapa jam. Yang terbaik adalah menghubungi tim Key Vault dan memberi tahu mereka masalah yang Anda lihat. Jika tim Key Vault menemukan bahwa tidak ada masalah, buat permintaan dukungan untuk menjangkau tim Azure Cosmos DB untuk resolusi.
4007 (Kesalahan server internal) Ini adalah kesalahan server internal dan terjadi jika byte input tidak dalam format base64.
4008 (Key Vault kesalahan layanan internal) Kesalahan ini terjadi jika Azure Cosmos DB tidak dapat mengakses Key Vault. Ini bisa disebabkan oleh masalah jaringan atau jika layanan Key Vault itu sendiri tidak berfungsi. Anda dapat memeriksa dasbor pemadaman Azure untuk memverifikasi apakah ada pemadaman yang ada. Pemadaman ini biasanya diselesaikan dalam beberapa jam. Yang terbaik adalah menghubungi tim Key Vault dan memberi tahu mereka masalah yang Anda lihat. Jika tim Key Vault menemukan bahwa tidak ada masalah, hubungi tim Azure Cosmos DB untuk resolusi.
1013 (Operasi pembuatan koleksi sedang berlangsung) Jika Anda menemukan pengecualian waktu habis saat membuat koleksi, lakukan operasi baca untuk memvalidasi apakah koleksi berhasil dibuat. Operasi baca melontarkan pengecualian hingga operasi pembuatan koleksi berhasil. Jika operasi baca melempar pengecualian dengan kode status 404, dan kode sub status 1013, itu berarti bahwa operasi pembuatan koleksi masih berlangsung. Coba lagi operasi baca hingga Anda mendapatkan kode status 200 atau 201, kode ini memberi tahu Anda bahwa koleksi telah berhasil dibuat.

Kode substatus untuk masalah pengguna akhir

Kode substatus berikut didukung oleh Azure Cosmos DB untuk masalah yang disebabkan oleh pengguna akhir:

Kode substatus Deskripsi
4002 (Key Vault tidak memberikan izin ke Azure AD, atau kunci dinonaktifkan) Masalah ini terjadi jika Anda telah menghapus identitas Azure Cosmos DB dari kebijakan akses Key Vault atau jika Anda telah menonaktifkan kunci. Masalah ini biasanya disebabkan oleh pengguna akhir. Jika kesalahan ini terjadi, pastikan Bahwa Azure Cosmos DB memiliki akses ke Key Vault dan kunci diaktifkan.
4003 (Kunci tidak ditemukan) Masalah ini terjadi jika kunci dihapus dari Key Vault. Masalah ini biasanya disebabkan oleh pengguna akhir. Salah satu prasyarat untuk menggunakan Azure Cosmos DB dengan kunci yang dikelola pelanggan adalah bahwa Key Vault mengaktifkan penghapusan sementara dan perlindungan penghapusan menyeluruh. Ini berarti Anda dapat memulihkan kunci yang dihapus dan memulihkan akses ke Azure Cosmos DB.
4005 (Tidak dapat membungkus atau membongkar kunci) Kesalahan ini terjadi jika Key Vault tidak dapat membungkus atau membongkar kunci. Masalah ini biasanya disebabkan oleh pengguna akhir. Salah satu kemungkinan penyebab kesalahan ini adalah bahwa Key Vault gagal mendekode blob terenkripsi dengan menggunakan kunci terbaru karena Anda telah memutar kunci. Untuk mengatasi kesalahan ini, aktifkan kunci yang baru dinonaktifkan dan akan diselesaikan dalam waktu sekitar satu jam. Jika masalah tidak diselesaikan setelah lebih dari 2 jam, teruskan masalah ke Azure Cosmos DB.
4006 (URL Kunci tidak valid) Kesalahan ini terjadi selama provisi jika Anda telah menyertakan versi kunci dalam URL Key Vault. Kesalahan ini sering disebabkan oleh pengguna akhir. Untuk mengatasi kesalahan ini, hapus versi dan coba lagi. Misalnya, jika Anda telah menggunakan URL dalam format https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/<KeyVersion>, perbarui ke https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/
4009 (nama DNS Key Vault tidak dapat diatasi) Kesalahan ini terjadi jika nama DNS Key Vault tidak dapat diselesaikan, karena Anda telah menggunakan nama Key Vault yang salah. Kesalahan ini disebabkan oleh pengguna akhir. Untuk mengatasinya, koreksi nama Key Vault dan coba lagi.

Lihat juga