Mensagens de erro

Saiba como resolver alguns erros gerados pela Vertex AI Vision. Neste tópico, falamos sobre erros com resoluções que exigem etapas além do que pode ser facilmente descrito em uma mensagem de erro.

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

Permissões

As credenciais padrão do aplicativo não estão disponíveis

Se você recebeu 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.

Permissão negada

Se você recebeu 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 você tem um arquivo JSON de chave de conta de serviço válido no local armazenado na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS e se a variável aponta para o local correto.

Para diagnosticar esse erro, tente abrir o arquivo de chave da conta de serviço na pasta que você quer chamar a API Vertex AI Vision.

cat $GOOGLE_APPLICATION_CREDENTIALS

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

Se você 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. Acesse o link especificado na mensagem de erro e ative a API Vertex AI Vision. Aguarde alguns minutos e tente novamente.
2. Verifique se você tem um arquivo JSON de chave de conta de serviço válido armazenado na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. Para diagnosticar esse erro, tente abrir o arquivo de chave da conta de serviço na pasta que você quer chamar a API Vertex AI Vision.

   cat $GOOGLE_APPLICATION_CREDENTIALS
   

Argumentos inválidos

Versão da API não aceita

Exemplo: quando uma solicitação é feita para uma versão da API que não oferece suporte à operação.

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

Bad Request (Solicitação inválida)

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

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

Número de projeto inválido

Quando um número de projeto inválido é fornecido. Exemplo de número de 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 um formato de recurso é inválido. Exemplo de número de projeto: 1234 e exemplo de ID de local: 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 ausentes

Em algumas APIs, como a CreateAnnotation para uma anotação no nível do particionamento, é necessário que o recurso já tenha dados de vídeo transmitidos para inferir o horário de início do recurso. Caso contrário, o seguinte erro será acionado.

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"
    }
}

Cotas e limites

Cota excedida

Se você recebeu esta mensagem:

RESOURCE_EXHAUSTED: Quota exceeded.

Você atingiu o limite de sua cota diária ou por minuto. Leia as cotas e limites para usar a Vertex AI Vision.

Solicite um aumento das suas cotas no consoleGoogle Cloud .