Meninjau kode respons umum
Operasi permintaan yang paling umum menggunakan Azure Cosmos DB for NoSQL, adalah membuat, mengkueri, atau mengelola dokumen kontainer. Setiap permintaan akan menampilkan kode status HTTP pada status operasi. Kode ini mungkin memberi tahu apakah operasi berhasil. Atau kode akan memberi tahu kami bahwa permintaan tidak berhasil dan memberi kami beberapa wawasan tentang apa yang mungkin salah. Di bagian ini kami akan meninjau beberapa kode status HTTP paling umum yang ditampilkan oleh jenis permintaan berikut:
- Buat Dokumen
- Cantumkan Dokumen
- Mendapatkan Dokumen
- Mengganti Dokumen
- Patch Dokumen
- Menghapus Dokumen
- Mengkueri Dokumen
Kode Status Umum untuk semua jenis operasi
Sementara beberapa kode status seperti 400, 403, dan 404 dibagikan di antara berbagai jenis operasi, deskripsinya sedikit berbeda dan tidak akan dicantumkan dalam tabel ini.
| Kode status | Nama | Jenis operasi | Keterangan |
|---|---|---|---|
| 200 | OK | Cantumkan, Dapatkan, Ganti, Patch, Minta Kueri | Operasi berhasil. |
Buat Dokumen
Operasi Buat Dokumen membuat dokumen baru dalam koleksi. Kode statusnya adalah:
| Kode status | Jenis operasi | Keterangan |
|---|---|---|
| 201 | Dibuat | Operasi berhasil. |
| 400 | Permintaan Buruk | Isi JSON tidak valid. |
| 403 | Terlarang | Operasi ini tidak dapat diselesaikan karena batas penyimpanan partisi telah tercapai. |
| 409 | Konflik | id yang dimasukkan untuk dokumen baru telah digunakan oleh dokumen yang sudah ada. |
| 413 | Entitas Terlalu Besar | Ukuran dokumen dalam permintaan melebihi ukuran dokumen yang diizinkan. |
Cantumkan dokumen di bawah koleksi menggunakan ReadFeed
ReadFeed dapat digunakan untuk mengambil semua dokumen, atau hanya perubahan bertahap pada dokumen dalam koleksi. Kode statusnya adalah:
| Kode status | Jenis operasi | Keterangan |
|---|---|---|
| 400 | Permintaan Buruk | Pengambilalihan yang ditetapkan dalam x-ms-consistency-level lebih kuat daripada yang ditetapkan selama pembuatan akun. Misalnya, jika tingkat konsistensinya adalah Sesi, pengambilalihan tidak boleh Kuat atau Dibatasi. |
Mendapatkan Dokumen
Operasi Dapatkan Dokumen mengambil dokumen dengan kunci partisi dan kunci dokumennya. Kode statusnya adalah:
| Kode status | Jenis operasi | Keterangan |
|---|---|---|
| 304 | Tidak Diubah | Dokumen yang diminta tidak dimodifikasi sejak nilai eTag yang ditentukan di header If-Match. Layanan menampilkan isi respons kosong. |
| 400 | Permintaan Buruk | Pengambilalihan yang diatur dalam header x-ms-consistency-level lebih kuat daripada yang diatur set selama pembuatan akun. Misalnya, jika tingkat konsistensinya adalah Sesi, pengambilalihan tidak boleh Kuat atau Dibatasi. |
| 404 | Tidak Ditemukan | Dokumen tidak lagi menjadi sumber daya, yaitu dokumen telah dihapus. |
Mengganti Dokumen
Operasi Ganti Dokumen menggantikan seluruh isi dokumen. Kode statusnya adalah:
| Kode status | Jenis operasi | Keterangan |
|---|---|---|
| 400 | Permintaan Buruk | Isi JSON tidak valid. Periksa tanda kurung keriting atau tanda kutipan yang hilang. |
| 404 | Tidak Ditemukan | Dokumen tidak ada lagi, yaitu, dokumen telah dihapus. |
| 409 | Konflik | id yang dimasukkan untuk dokumen baru telah digunakan oleh dokumen yang sudah ada. |
| 413 | Entitas Terlalu Besar | Ukuran dokumen dalam permintaan melebihi ukuran dokumen yang diizinkan. |
Patch Dokumen
Operasi Patch Dokumen melakukan pembaruan tingkat jalur ke file/properti tertentu dalam satu dokumen. Kode statusnya adalah:
| Kode status | Jenis operasi | Keterangan |
|---|---|---|
| 400 | Permintaan Buruk | Isi JSON tidak valid. |
| 412 | Prasyarat gagal | Pra-kondisi yang ditentukan tidak dipenuhi. |
Menghapus Dokumen
Operasi Hapus Dokumen menghapus dokumen yang sudah ada dalam koleksi. Kode statusnya adalah:
| Kode status | Jenis operasi | Keterangan |
|---|---|---|
| 204 | Tidak ada Konten | Operasi hapus berhasil. |
| 404 | Tidak Ditemukan | Dokumen tidak ditemukan. |
Mengkueri Dokumen
Anda dapat mengkueri dokumen koleksi menggunakan kueri Azure Cosmos DB SQL. Kode statusnya adalah:
| Kode status | Jenis operasi | Keterangan |
|---|---|---|
| 400 | Permintaan Buruk | Permintaan ditentukan dengan sintaks SQL yang salah atau header yang diperlukan tidak ada. |
Kode status penting lainnya yang dapat ditampilkan oleh permintaan Azure Cosmos DB
Beberapa kode status gagal juga mengacu pada pengecualian. Kita akan membahas beberapa kode status ini secara lebih mendetail di bagian berikutnya, tetapi berikut beberapa kode status lebih umum yang perlu ditinjau:
| Kode status | Jenis operasi | Keterangan |
|---|---|---|
| 408 | Waktu 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. |
| 429 | Terlalu banyak permintaan | Pengumpulan telah melebihi batas keluaran yang disediakan. Coba lagi permintaan setelah server menentukan coba lagi setelah durasi. Untuk informasi selengkapnya, lihat unit permintaan. |
| 500 | Kesalahan Server Internal | Operasi gagal karena kesalahan layanan yang tidak terduga. Hubungi dukungan. |
| 503 | Layanan Tidak Tersedia | Operasi tidak dapat diselesaikan karena layanan tidak tersedia. Situasi ini bisa terjadi karena masalah konektivitas jaringan atau ketersediaan layanan. Operasi dapat dicoba lagi dengan aman. Jika masalah berlanjut, hubungi dukungan. |