API에 따라 일일 요청, 분당 요청 또는 사용자별 분당 요청으로 요청을 명시적으로 제한할 수 있습니다.
청구 가능 사용량에 상한을 설정하여 제한할 수 있습니다. 예를 들어 무료 우대 사용량 한도를 초과하여 결제가 되지 않도록 하기 위해 일일 요청 상한을 설정할 수 있습니다
요청 수 한도 보기 및 수정
결제 가능 API에 대한 모든 요청에 한도를 설정할 수 있습니다. 대부분 API에는 기본 한도가 설정되어 있지만 Google에서 지정하는 최댓값까지 기본 한도를 변경할 수 있습니다. 일부 API에서는 프로젝트에서 결제를 사용 설정할 때까지 한도가 낮게 설정됩니다.
API 한도를 보거나 변경하려면 다음 단계를 따릅니다.
- Google Cloud Console에서 API 및 서비스 대시보드 페이지로 이동합니다.
- 프로젝트 목록에서 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
- 확인하려는 API의 이름을 클릭합니다.
- 할당량을 클릭합니다. 탭 탐색에 할당량 탭이 없으면 선택한 API에 할당량이 정의되지 않은 것입니다.
- 상한을 설정하려는 할당량을 찾으려면 필터 필드에 적절한 속성과 값을 입력합니다. 예를 들어 서브네트워크 할당량을 찾으려면 Quota:Subnetworks를 입력합니다.
- 상한을 설정할 할당량 옆에 있는 체크박스를 클릭한 다음 할당량 수정을 클릭합니다.
- 설정하려는 새 한도를 포함하여 할당량 변경 양식을 작성합니다.
- 요청 제출을 클릭합니다.
일부 API에서는 양식을 제출하여 한도 상향 조정을 요청할 수 있습니다. 그 밖에 프로젝트에서 결제가 사용 설정되어 있는 경우에만 할당량 상향 조정이 가능한 API도 있습니다.
Premium 요금제 할당량 섹션은 더 이상 제공되지 않는 Google 지도 Premium 요금제와 관련이 있습니다. 현재 Google 지도 프리미엄 플랜 고객이 아닌 경우 해당 섹션을 수정하지 마세요.
사용자당 요청 제한
각 사용자가 API 할당량을 모두 소진하지 못하도록 일부 API에는 기본 사용자별 분당 제한이 포함됩니다.
API에 사용자별 분당 기본 한도가 포함되어 있는지 확인하려면 요청 수의 한도 보기 및 수정에 관한 안내에 설명된 대로 API 할당량에서 이 한도를 찾습니다. 해당 API에 이러한 기본 한도가 존재하는 경우, 다음 안내에 따라 각 사용자가 사용할 수 있는 할당량을 제한하도록 이 값을 수정할 수 있습니다. API에 할당량에 이 기본 한도가 포함되지 않은 경우 추가 또는 수정이 지원되지 않습니다.
개별 사용자는 고유 문자열로 식별됩니다. 따라서 사용자를 대신해 요청하는 서버 측 애플리케이션(개발자가 소유한 서버에서 호출 코드가 호스팅됨)을 개발하는 경우에는 quotaUser 매개변수가 API에 대한 사용량 제한 요청에 포함되어야 합니다. 이 매개변수는 시스템 매개변수 문서에 정의되어 있습니다.
사용자를 식별하려면 quotaUser=userID URL 쿼리 매개변수를 사용합니다. 이 값은 단기 할당량에만 적용됩니다. 따라서 실제 사용자 ID를 사용할 필요 없습니다. 40자 미만의 임의 문자열을 선택하여 사용자를 고유하게 식별할 수 있습니다.
quotaUser 매개변수는 사용자별 분당 요청 수의 상한을 설정할 때만 사용됩니다. quotaUser 매개변수를 보내지 않으면 모든 호출이 서버 머신에서 발생합니다. 이 경우 사용자가 호출 한도를 설정할 수 없습니다.
API에 사용자별 분당 기본 한도가 포함되지 않으면 quotaUser 값이 무시됩니다.
프로젝트의 API에 적용되는 모든 할당량 보기 및 편집
Google Cloud Console의 IAM 및 관리자 섹션에 있는 할당량 페이지를 확인하여 지정된 프로젝트에서 모든 결제 가능한 API에 적용되는 할당량 한도를 검토, 수정 또는 상향 요청할 수 있습니다.
프로젝트에서 모든 결제 가능 API에 적용되는 할당량을 보고 편집하려면 다음 단계를 따릅니다.
- Google Cloud Console에서 할당량 페이지로 이동합니다.
- 프로젝트 목록에서 프로젝트를 선택하거나 새 프로젝트를 만듭니다. 선택한 프로젝트의 할당량 페이지가 표시됩니다. 이 페이지에는 각 서비스에서 사용 가능한 각 할당량 유형의 항목이 나열됩니다.
- 테이블 필터링을 클릭하여 특정 속성별로 할당량을 쿼리합니다.
- 수정하고자 하는 할당량 옆의 체크박스를 선택합니다. 일부 체크박스를 클릭하려면 프로젝트에 결제가 사용 설정되어 있어야 합니다.
- 할당량 수정을 클릭합니다.
- 표시된 할당량 변경 창에서 서비스 뷰를 펼친 다음 필요에 따라 해당 서비스의 할당량을 수정한 후 완료를 클릭합니다.
- 선택한 각 서비스에서 할당량 수정을 반복합니다.
- 현재 할당량 한도는 입력 상자에 자동으로 입력됩니다.
- 제출 시 알림 아이콘()이 있는 서비스에는 입력 오류가 있습니다.
- 이전에 설명된 대로 수정할 할당량을 선택하여 할당량을 추가할 수 있습니다.
- 확장되지 않은 서비스 뷰로 마우스를 가져간 다음 삭제 아이콘()을 클릭하여 할당량 변경 창에서 서비스를 삭제할 수 있습니다.
- 할당량 수정을 마치면 다음을 클릭합니다.
- 할당량 수정 요청에 검토가 필요한 경우 연락처 세부정보 양식이 표시됩니다. 연락처 세부정보를 입력하여 양식을 작성합니다.
- 요청 제출을 클릭합니다.