Erros

As seções a seguir descrevem o modelo de erro para os métodos de recursos v2 e v1, respectivamente.

Modelo de erro de recurso v2

Por padrão, os métodos de recurso respondem com um status 200 OK. Quando as solicitações falham, o Open Cloud retorna códigos de erro padrão. Todas as respostas de erro têm o mesmo formato, que incluem:

• code - Representa o código de status HTTP.
• message - Uma mensagem explicando o erro.
• details - Um objeto que contém mais informações específicas para o erro.

Erro de exemplo
{
  "code": "INVALID_ARGUMENT",
  "message": "The provided filter is invalid.",
  "details": [
    {
      ...
    }
  ]
}

Códigos

A tabela a seguir descreve possíveis valores para código.

Modelo de erro de recurso v1

Todas as respostas de erro têm o mesmo formato padrão, que inclui:

• Um campo error, que é uma causa de alto nível aplicável a todos os endpoints Open Cloud.
• Um erro explicativo message , que explica ainda mais o erro.
• Um errorDetails Objeto, que cobre mais informações sobre o erro específico de cada API (Interface de Programação para Aplicações).

Para analisar a causa raiz de um erro, consulte o valor do campo error e o campo errorDetails. Use o campo message como um suplemento para lidar com erros, pois às vezes pode não cobrir o mesmo nível de detalhes que o campo errorDetails.

Exemplo de resposta de erro do DataStores padrão
{
  "error": "INVALID_ARGUMENT",
  "message": "Invalid cursor.",
  "errorDetails": [
    {
      "errorDetailType": "DatastoreErrorInfo",
      "datastoreErrorCode": "InvalidCursor"
    }
  ]
}

A resposta de erro de exemplo mostra a Nuvem Aberta de alto nível error como INVALID_ARGUMENT , o erro message como InvalidCursor , e o errorDetails específico para armazena dados com o datastoreErrorCode como InvalidCursor . A partir dos campos error e datastoreErrorCode da resposta, você pode entender que passou um parâmetro de cursor inválido que causou o erro. Você pode então corrigir seu parâmetro de cursor para resolver o problema.

Todas as respostas de erro de armazenamento de dados encomendadas têm o mesmo formato, que inclui:

Exemplo de Resposta de Erro do DataStores Pedido
{
  "code": "INVALID_ARGUMENT",
  "message": "Invalid cursor."
}

O code conterá uma string do erro de alto nível enquanto o message conterá detalhes específicos relacionados ao erro

Códigos

Consulte a tabela a seguir para obter um resumo de todos os erros de alto nível do Open Cloud.