Błędy

Następujące sekcje opisują model błędu dla metod zasobów v2 i v1, odpowiednio.

model błędu zasobu v2

Domyślnie metody zasobów odpowiadają za pomocą statusu 200 OK.Gdy żądania nie powiodą się, Open Cloud zwraca standardowe kody błędu.Wszystkie odpowiedzi na błędy mają ten sam format, który obejmuje:

• code - Reprezentuje kod stanu HTTP.
• message - Wiadomość, która wyjaśnia błąd.
• details - Obiekt, który zawiera więcej informacji specyficznych dla błędu.

Przykładowy błąd
{
  "code": "INVALID_ARGUMENT",
  "message": "The provided filter is invalid.",
  "details": [
    {
      ...
    }
  ]
}

Kodów

Poniższa tabela opisuje możliwe wartości dla code.

model błędu zasobu v1

Wszystkie odpowiedzi na błędy mają ten sam, standardowy format, który obejmuje:

• Pole error, które jest wysokopoziomową przyczyną, która jest stosowana we wszystkich punktach końcowych Open Cloud.
• Błąd wyjaśniający message, który dalej wyjaśnia błąd.
• Przedmiot errorDetails, który zawiera więcej informacji o błędzie, który jest specyficzny dla każdej API.

Aby przeanalizować przyczynę podstawową błędu, odwołaj się do wartości pola error i pola errorDetails.Użyj pola message jako uzupełnienia dla obsługi błędów, ponieważ czasami może nie pokrywać takiego samego poziomu szczegółowości jak pole errorDetails.

Odpowiedź na błąd standardowego przechowywania danych przykład
{
  "error": "INVALID_ARGUMENT",
  "message": "Invalid cursor.",
  "errorDetails": [
    {
      "errorDetailType": "DatastoreErrorInfo",
      "datastoreErrorCode": "InvalidCursor"
    }
  ]
}

Odpowiedź o błędzie przykładowym pokazuje wysokopoziomową otwartą chmurę jako , błąd jako i specyficzny dla sklepów danych ze jako .Z error i datastoreErrorCode pól odpowiedzi możesz zrozumieć, że przekazałeś nieważny parametr kurora, który spowodował błąd.Następnie możesz skorygować parametr kurora, aby rozwiązać problem.

Wszystkie zamówione odpowiedzi o błędach przechowywania danych mają ten sam format, który obejmuje:

Przykład odpowiedzi na błąd złożonych sklepów danych
{
  "code": "INVALID_ARGUMENT",
  "message": "Invalid cursor."
}

The code będzie zawierać ciąg wysokiego poziomu błędu, podczas gdy message będzie zawierać szczegóły związane z błędem

Kodów

Odwołaj się do poniższej tabeli, aby uzyskać przegląd wszystkich poważnych błędów w chmurze otwartej.