Mensagens de erro

Saiba como resolver alguns erros apresentados pela Vertex AI Vision. Este tópico aborda erros cuja resolução requer mais passos do que os que podem ser facilmente descritos numa mensagem de erro.

Consulte a documentação da API Cloud para ver as práticas recomendadas de processamento de erros.

Autorizações

As credenciais padrão da aplicação não estão disponíveis

Se receber esta mensagem:

The Application Default Credentials are not available. They are
available if running in Google Compute Engine. Otherwise, the
environment variable GOOGLE_APPLICATION_CREDENTIALS must be defined
pointing to a file defining the credentials.
See https://developers.google.com/accounts/docs/application-default-credentials
for more information.

Autorização recusada

Se receber esta mensagem:

ERROR: (gcloud.auth.application-default.print-access-token) File /path/to/key.json
(pointed by GOOGLE_APPLICATION_CREDENTIALS environment variable) does not exist!
{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "status": "PERMISSION_DENIED"
  }
}

Verifique se tem um ficheiro JSON de chave da conta de serviço válido na localização armazenada na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS e se a variável aponta para o local correto.

Para diagnosticar este erro, experimente abrir o ficheiro de chave da conta de serviço a partir da pasta a partir da qual está a tentar chamar a Vertex AI Vision API.

cat $GOOGLE_APPLICATION_CREDENTIALS

Proibido: 403 A API POST não foi usada ou está desativada

Se receber a mensagem:

Forbidden: 403 POST Vertex AI Vision API has not been used in
project # before or it is disabled.
Enable it by visitng [url] then retry.
If you enabled this API recently, wait a few minutes for the action to
propagate and retry.

1. Aceda ao link especificado na mensagem de erro e ative a Vertex AI Vision API. Aguarde vários minutos e, em seguida, tente novamente.
2. Verifique se tem um ficheiro JSON de chave da conta de serviço válido armazenado na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. Para diagnosticar este erro, experimente abrir o ficheiro de chave da conta de serviço a partir da pasta a partir da qual está a tentar chamar a Vertex AI Vision API.

   cat $GOOGLE_APPLICATION_CREDENTIALS
   

Argumentos inválidos

Versão da API não suportada

Exemplo: quando é feito um pedido a uma versão da API que não suporta a operação.

message: "The requested operation is unsupported for the API version."

Pedido errado

Quando é feito um pedido de API, mas os campos do pedido têm uma ou mais violações. Cada violação é captada como um field_violations nos google.rpc.BadRequest detalhes.

message: "Request contains an invalid argument."
details {
  [type.googleapis.com/google.rpc.BadRequest] {
    field_violations { field: "foo" description: "bar" }
  }
}

Número do projeto inválido.

Quando é fornecido um número de projeto inválido. Exemplo de número do projeto: 848757893952147483648.

message: "Invalid project number used: 848757893952147483648."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "INVALID_PROJECT_NUMBER"
      domain: "visionai.googleapis.com"
    }
}

Formato de recurso inválido

Quando o formato de um recurso é inválido. Exemplo de número do projeto: 1234 e exemplo de ID da localização: us-central1.

message: "Invalid Resource Used: project/1234/location/us-central1. Valid format should be "
"projects/{project_number}/locations/{location_id}."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "INVALID_RESOURCE_FORMAT"
      domain: "visionai.googleapis.com"
    }
}

Falha na pré-condição

Dados de vídeo em falta

Para algumas APIs (como CreateAnnotation para uma anotação ao nível da partição), é necessário que o recurso já tenha dados de vídeo transmitidos para inferir a hora de início do recurso. Caso contrário, é acionado o seguinte erro.

message: "Asset doesn't have start time inferred yet. Should ingest asset and retry."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "FAILED_PRECONDITION"
      domain: "visionai.googleapis.com"
    }
}

Quotas e limites

Quota excedida

Se receber esta mensagem:

RESOURCE_EXHAUSTED: Quota exceeded.

Atingiu o limite da sua quota por minuto ou diária. Reveja as quotas e os limites para usar o Vertex AI Vision.

Pode pedir um aumento das suas quotas na Google Cloud consola.