오류 메시지

Vertex AI Vision에서 발생한 몇 가지 오류를 해결하는 방법을 알아봅니다. 이 페이지에서는 오류 메시지에 간단히 설명된 것 이상으로 추가 단계가 필요한 오류에 대해 설명합니다.

오류 처리 권장사항은 Cloud API 문서를 참고하세요.

권한

애플리케이션 기본 사용자 인증 정보를 사용할 수 없음

다음과 같은 메시지가 표시될 경우:

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.

권한 거부됨

다음과 같은 메시지가 표시될 경우:

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

GOOGLE_APPLICATION_CREDENTIALS 환경 변수에 저장된 위치에 유효한 서비스 계정 키 JSON 파일이 있고 이 변수가 올바른 위치를 가리키고 있는지 확인합니다.

이 오류를 진단하려면 Vertex AI Vision API를 호출하려는 폴더에서 서비스 계정 키 파일을 열어보세요.

cat $GOOGLE_APPLICATION_CREDENTIALS

금지됨: 403 POST API를 사용한 적이 없거나 사용 중지했습니다.

다음과 같은 메시지가 표시될 경우:

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. 오류 메시지에 지정된 링크로 이동하여 Vertex AI Vision API를 사용 설정합니다. 몇 분 정도 기다린 후 다시 시도합니다.
  2. GOOGLE_APPLICATION_CREDENTIALS 환경 변수에 유효한 서비스 계정 키 JSON 파일이 저장되어 있는지 확인합니다. 이 오류를 진단하려면 Vertex AI Vision API를 호출하려는 폴더에서 서비스 계정 키 파일을 열어보세요. 
    cat $GOOGLE_APPLICATION_CREDENTIALS

잘못된 인수

지원되지 않는 API 버전

예: 작업을 지원하지 않는 API 버전에 요청이 이루어진 경우

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

잘못된 요청

API 요청이 이루어졌지만 요청 필드에 위반사항이 하나 이상 있는 경우 각 위반사항은 google.rpc.BadRequest 세부정보에서 field_violations로 캡처됩니다.

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

잘못된 프로젝트 번호입니다.

잘못된 프로젝트 번호가 제공된 경우 프로젝트 번호의 예: 848757893952147483648

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

잘못된 리소스 형식

리소스 형식이 잘못된 경우 프로젝트 번호의 예: 1234, 위치 ID의 예: 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"
    }
}

전제 조건을 충족하지 않음

동영상 데이터 누락

일부 API (예: 파티션 수준 주석의 CreateAnnotation)의 경우 애셋의 시작 시간을 추론하려면 애셋에 이미 동영상 데이터가 스트리밍되어 있어야 합니다. 그러지 않으면 다음 오류가 트리거됩니다.

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

할당량 및 한도

할당량 초과

다음과 같은 메시지가 표시될 경우:

RESOURCE_EXHAUSTED: Quota exceeded.

분당 또는 일일 할당량 한도에 도달했습니다. Vertex AI Vision 사용에 대한 할당량 및 한도를 검토하세요.

Google Cloud 콘솔에서 할당량 상향 조정을 요청할 수 있습니다.