한도 및 할당량

Data Manager API를 사용할 때의 한도와 할당량을 알아보려면 이 가이드를 따르세요.

프로젝트 한도

Data Manager API를 사용하려면 Google Cloud 프로젝트가 필요합니다. Google Cloud 프로젝트는 API 요청을 인증하는 데 사용하는 OAuth 클라이언트와 사용자 인증 정보를 제공합니다.

Data Manager API는 서비스 및 작업 유형 (읽기 대 변경)별로 구분된 각 Google Cloud 프로젝트에 비율 제한을 적용합니다.

서비스 작업 일일 요청 수 분당 요청 수
IngestionService 변형 (쓰기) 100,000 300
IngestionService 읽기 100,000 300
기타 모든 서비스 합계 변형 (쓰기) 50,000 300
기타 모든 서비스 합계 읽기 50,000 300

한도를 초과하는 요청은 RESOURCE_EXHAUSTED 오류 및 HTTP 상태 429 Too Many Requests로 거부됩니다.

적극적으로 요청 수를 줄이고 클라이언트 측에서 QPS를 제한하여 앱을 제어하고 비율 제한을 완화할 수 있습니다. Google Cloud 콘솔에서 할당량 알림 및 모니터링을 설정하여 애플리케이션이 한도에 도달하기 전에 알림을 받을 수도 있습니다.

할당량 이름

각 한도는 Google Cloud의 할당량 한도 이름 및 측정항목에 해당합니다. 요청이 한도를 초과하면 Data Manager API는 metadata.quota_limit 아래의 ErrorInfo 표준 세부정보 페이로드에 할당량 한도 이름을 반환합니다.

할당량 한도 이름 서비스 작업 창 한도
IngestionMutateRequestsPerDayPerProject IngestionService 변형 일 100,000
IngestionMutateRequestsPerMinutePerProject IngestionService 변형 분 300
IngestionReadRequestsPerDayPerProject IngestionService 읽기 일 100,000
IngestionReadRequestsPerMinutePerProject IngestionService 읽기 분 300
ManagementMutateRequestsPerDayPerProject 기타 모든 서비스 변형 일 50,000
ManagementMutateRequestsPerMinutePerProject 기타 모든 서비스 변형 분 300
ManagementReadRequestsPerDayPerProject 기타 모든 서비스 읽기 일 50,000
ManagementReadRequestsPerMinutePerProject 기타 모든 서비스 읽기 분 300

ErrorInfo 페이로드에서 metadata.quota_limit를 검사하여 일일 한도 오류와 분당 한도 오류를 구분하고, 일시적으로 일시중지하고 지연 후 재시도할지 아니면 일일 할당량이 재설정될 때까지 일시중지할지 결정합니다. 자세한 내용은 할당량 및 비율 제한 오류를 참고하세요.

요청 한도

다음은 특정 요청에 대한 한도입니다.