Mensajes de error

Consulta cómo resolver algunos errores que genera Vertex AI Vision. En este tema se tratan los errores cuya resolución requiere más pasos de los que se pueden describir fácilmente en un mensaje de error.

Consulta las prácticas recomendadas para gestionar errores en la documentación de la API Cloud.

Permisos

Las credenciales de aplicación predeterminadas no están disponibles

Si recibes este mensaje:

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.

Permiso denegado

Si recibes este mensaje:

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

Comprueba que tienes un archivo JSON de clave de cuenta de servicio válido en la ubicación almacenada en la variable de entorno GOOGLE_APPLICATION_CREDENTIALS y que la variable apunta al lugar correcto.

Para diagnosticar este error, prueba a abrir el archivo de clave de cuenta de servicio desde la carpeta desde la que intentas llamar a la API Vertex AI Vision.

cat $GOOGLE_APPLICATION_CREDENTIALS

Prohibido: no se ha usado la API POST 403 o está inhabilitada

Si recibes el mensaje:

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. Visita el enlace especificado en el mensaje de error y habilita la API Vertex AI Vision. Espera varios minutos y vuelve a intentarlo.
2. Comprueba que tienes un archivo JSON de clave de cuenta de servicio válido almacenado en la variable de entorno GOOGLE_APPLICATION_CREDENTIALS. Para diagnosticar este error, prueba a abrir el archivo de clave de cuenta de servicio desde la carpeta desde la que intentas llamar a la API Vertex AI Vision.

   cat $GOOGLE_APPLICATION_CREDENTIALS
   

Argumentos no válidos

Versión de la API no compatible

Por ejemplo, cuando se hace una solicitud a una versión de la API que no admite la operación.

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

Bad Request

Cuando se envía una solicitud a la API, pero los campos de la solicitud tienen una o varias infracciones. Cada infracción se registra como un field_violations en los google.rpc.BadRequest detalles.

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

Número de proyecto no válido

Cuando se proporciona un número de proyecto no válido. Número de proyecto de ejemplo: 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 no válido

Cuando el formato de un recurso no es válido. Número de proyecto de ejemplo: 1234 e ID de ubicación de ejemplo: 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"
    }
}

No se cumple la condición previa

Faltan datos de vídeo

En algunas APIs (como CreateAnnotation para una anotación a nivel de partición), es necesario que el recurso ya tenga datos de vídeo transmitidos para inferir la hora de inicio del recurso. De lo contrario, se activará el siguiente error.

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

Cuotas y límites

Se ha superado la cuota

Si recibes este mensaje:

RESOURCE_EXHAUSTED: Quota exceeded.

Has alcanzado el límite de tu cuota por minuto o diaria. Consulta las cuotas y los límites para usar Vertex AI Vision.

Puedes solicitar que te aumentemos las cuotas desde la Google Cloud consola.