Kesalahan

Bagian berikut menjelaskan model kesalahan untuk metode sumber daya v2 dan v1, masing-masing.

model kesalahan sumber daya v2

Secara default, metode sumber daya menanggapi dengan status 200 OK.Saat permintaan gagal, Open Cloud mengembalikan kode kesalahan standar.Semua respons kesalahan memiliki format yang sama, yang termasuk:

• code - Mewakili kode status HTTP.
• message - Pesan yang menjelaskan kesalahan.
• details - Sebuah objek yang berisi lebih banyak informasi khusus untuk kesalahan.

Contoh Kesalahan
{
  "code": "INVALID_ARGUMENT",
  "message": "The provided filter is invalid.",
  "details": [
    {
      ...
    }
  ]
}

Kode

Tabel berikut menjelaskan nilai yang mungkin untuk code .

model kesalahan sumber daya v1

Semua respons kesalahan memiliki format standar yang sama, yang termasuk:

• Sebuah bidang error , yang merupakan penyebab tingkat tinggi yang berlaku untuk semua akhir Open Cloud.
• Kesalahan penjelas message , yang lebih lanjut menjelaskan kesalahan.
• Sebuah objek errorDetails yang berisi lebih banyak informasi tentang kesalahan yang khusus untuk setiap API.

Untuk menganalisis penyebab akar dari sebuah kesalahan, merujuk pada nilai bidang error dan errorDetails.Gunakan bidang message sebagai tambahan untuk penanganan kesalahan, karena terkadang mungkin tidak mencakup tingkat rincian yang sama dengan bidang errorDetails.

Contoh Respon Kesalahan DataStores Standar
{
  "error": "INVALID_ARGUMENT",
  "message": "Invalid cursor.",
  "errorDetails": [
    {
      "errorDetailType": "DatastoreErrorInfo",
      "datastoreErrorCode": "InvalidCursor"
    }
  ]
}

Tanggapan kesalahan contoh menunjukkan respons tingkat tinggi Open Cloud error sebagai INVALID_ARGUMENT , kesalahan message sebagai InvalidCursor , dan errorDetails khusus untuk penyimpanan data dengan datastoreErrorCode sebagai InvalidCursor .Dari bidang error dan datastoreErrorCode dari respons, Anda dapat memahami bahwa Anda melewati parameter kurator yang tidak valid yang menyebabkan kesalahan.Anda kemudian dapat memperbaiki parameter kurator Anda untuk memecahkan masalah.

Semua respons kesalahan penyimpanan data yang dipesan memiliki format yang sama, yang termasuk:

Contoh Tanggapan Kesalahan DataStores yang Dipesan
{
  "code": "INVALID_ARGUMENT",
  "message": "Invalid cursor."
}

The code akan berisi string kesalahan tingkat tinggi sementara message akan berisi rincian spesifik terkait dengan kesalahan

Kode

Referensikan tabel berikut untuk ringkasan semua kesalahan Open Cloud tingkat tinggi.