문제해결

이 페이지에는 다음 Service Infrastructure API의 각 버전에 대한 문제해결 정보가 나와 있습니다.

  • Service Management API
  • Service Control API
  • Service Consumer Management API

일반적으로 Service Control API 오류를 해결하는 방법

Service Control API는 로깅, 모니터링 등 관리형 서비스의 컨트롤 플레인 기능을 제공합니다. 따라서 Service Control API의 호출자는 일반적으로 서버 애플리케이션입니다. 다음은 REST/RPC API 수준에서 오류를 처리하는 방법에 대한 일반적인 권장사항입니다.

  • 서버는 Service Control API에서 반환하는 모든 오류를 로깅해야 하며, 이 데이터를 사용하여 관리형 서비스의 문제를 해결할 수 있어야 합니다.
  • 서버가 Service Control API로부터 429 오류를 수신한 경우에는 429 오류를 클라이언트에 반환해야 합니다.
  • 서버가 Service Control API에 액세스할 수 없는 경우에는 fail-open(오류 무시) 또는 fail-close(클라이언트에 503 반환) 중에 선택할 수 있습니다.
  • 서버가 Service Control API로부터 500 오류를 수신한 경우에는 500 오류를 클라이언트에 반환해야 합니다. 이러한 오류는 일반적으로 Service Control API 내에 버그가 있음을 의미합니다.
  • 서버가 Service Control API로부터 다른 오류를 수신한 경우에는 500 오류를 클라이언트에 반환해야 합니다. 이러한 오류는 일반적으로 관리형 서비스 내에 버그가 있음을 의미합니다.

'서비스 사용 설정되지 않음' 오류가 의미하는 내용

Google API 서비스를 사용하려면 Google Cloud 프로젝트를 준비하고, 이 프로젝트에 대해 서비스를 사용 설정하고 각 API 요청에 대해 프로젝트와 연결된 API 키 또는 OAuth 액세스 토큰을 전달해야 합니다. 자세한 내용은 인증 가이드를 참조하세요. 이 오류를 해결하려면 Google Cloud Console, Google Cloud SDK, Service Usage API를 사용하여 프로젝트에 대해 서비스를 사용 설정해야 합니다. 서비스를 사용 설정하는 방법은 서비스 사용 설정 및 중지를 참조하세요.

권한 거부 오류를 수정하는 방법

이러한 오류는 일반적으로 특정 리소스에서 호출자에게 올바른 Identity and Access Management 권한이 없다는 것을 의미입니다. 다음의 각 Service Infrastructure API에 필요한 권한에 대한 정보는 각각의 액세스 제어 페이지를 참조하세요.

API 오류가 발생할 때 다시 시도하는 방법

지수에 임의성을 더한 간격으로 재시도하는 것이 좋습니다. 최소 재시도 간격은 429 할당량 오류의 경우 30초, 500503 서버 오류의 경우 1초여야 합니다. 다른 오류의 경우에는 반드시 추가적인 오류 정보를 바탕으로 해서 재시도를 수행해야 합니다. 자세한 내용은 google.rpc.Code를 참고하세요.

더 높은 API 할당량을 요청하는 방법

다음의 각 Service Infrastructure API에 더 높은 할당량을 신청하는 방법을 알아보려면 할당량 및 제한 페이지의 관련 섹션을 방문하세요.

'도메인 이름 소유권을 확인할 수 없음' 오류를 수정하는 방법

이 오류는 호출자가 서비스 구성에서 지정된 관리형 서비스 이름에 사용되는 도메인 이름의 소유권을 가지고 있지 않음을 나타냅니다. 유효한 도메인을 사용하려면 다음 가이드를 따르세요.