할당량 및 한도

이 페이지에서는 API 게이트웨이의 할당량 한도를 설명합니다.

API, API 구성, 게이트웨이의 한도

API 게이트웨이에서는 API, API 구성, 게이트웨이에 다음과 같은 한도를 적용합니다.

API - 총 50개
API 구성 - API별 100개
게이트웨이 - 리전별 50개

동일한 API에 대해 첫 번째 API 구성 만들기가 완료되기 전에 두 번째 API 구성을 만들려고 시도하면 두 구성 중 하나 또는 모두를 이후 게이트웨이에서 사용하지 못할 수 있습니다.

요청 비율 제한

기본적으로 비율 한도는 서비스 프로듀서 프로젝트별로 100초당 할당량 단위 1천만 회입니다. services.check를 호출할 때마다 그리고 services.report를 통해 보고되는 작업이 있을 때마다 각각 할당량 단위 1회가 소모됩니다.

페이로드 크기 한도

다음 한도는 특히 배포된 게이트웨이를 통한 트래픽의 최대 페이로드 크기에 적용됩니다.

한도	용량
요청 크기	32MB
응답 크기	32MB
gRPC 트랜스코딩 응답 크기	1MB
gRPC 트랜스코딩 요청 크기	1MB

스트리밍은 지원되지 않습니다.

헤더 크기 한도

다음 한도는 특히 배포된 게이트웨이를 통한 트래픽의 최대 헤더 크기에 적용됩니다.

한도	용량
요청 헤더 크기	60KB

API 게이트웨이에서 호출하는 백엔드 서비스의 한도가 더 낮을 수 있습니다.

할당량을 늘리는 방법

Cloud Quotas 조정 요청은 검토 대상입니다. 할당량 조정 요청에 검토가 필요한 경우 요청 접수 확인 이메일이 전송됩니다. 추가 지원이 필요한 경우 이 이메일에 회신해 주세요. 요청이 검토되면 요청의 승인 여부를 나타내는 이메일 알림이 전송됩니다. Google Cloud 콘솔, Cloud Quotas API 또는 Google Cloud CLI를 사용하여 할당량 조정을 요청할 수 있습니다. 다음 안내에서는 Google Cloud 콘솔을 사용하거나 Cloud Quotas API에 REST 요청을 전송하여 새 할당량 값을 요청하는 방법을 보여줍니다.

콘솔

할당량 조정을 요청하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 IAM 및 관리자 > 할당량 및 시스템 한도 페이지로 이동합니다.
할당량 및 시스템 한도로 이동
프로젝트를 선택하라는 메시지가 표시되면 조정할 프로젝트를 선택합니다.
조정하려는 할당량을 찾아 할당량 변경사항 대화상자를 엽니다.
- 표에 없는 할당량:
  - 필터 검색창에서 할당량을 검색합니다. 사용량 또는 조정된 값이 없는 할당량은 표에 표시되지 않으므로 리전 또는 영역을 지정하지 마세요 (해당하는 경우).
  - 표에서 할당량 항목을 찾습니다. 이는 기본 항목이거나 리전 또는 영역과 관계없이 기록이 있는 항목일 수 있습니다.
  - 항목의 행에서 작업 더보기 > 추가 리전/영역 구성을 클릭합니다.
  - 조정하려는 리전 또는 영역을 선택합니다. 수정을 클릭합니다.
- 기타 모든 할당량:
  - 필터 검색창에서 할당량을 검색합니다.
  - 항목의 행에서 할당량의 체크박스를 선택합니다.
  - 수정을 클릭합니다.
할당량 변경사항 대화상자가 표시됩니다.
새 값 입력란 위에 더 큰 할당량 신청 링크가 표시되고 화면에 표시된 숫자보다 할당량 값을 상향 조정하려면 링크를 따르세요. 양식을 작성하고 제출한 후 여기에서 나머지 단계를 건너뜁니다. 그렇지 않으면 이 가이드를 계속 따르세요.
새 값 필드에 원하는 증가된 할당량 값을 입력합니다. 요청 설명 필드가 표시되면 설명을 입력합니다. 완료를 클릭합니다.
- '이 요청으로 모든 재정의가 삭제된다는 점을 이해했습니다.'라는 텍스트가 포함된 체크박스가 표시되면 할당량 값이 기본값보다 낮게 설정된 것입니다. 할당량 값을 기본값 이상으로 조정하면 재정의가 삭제됩니다. 계속하려면 체크박스를 선택하세요. 할당량 재정의 자세히 알아보기
다음 버튼이 표시되면 다음을 클릭하고 다음 화면에서 연락처 세부정보를 작성합니다.
요청 제출을 클릭합니다.

콘솔에서 조정을 요청할 수 없는 경우 Cloud Customer Care에서 상향을 요청합니다.

할당량 상향 절차에 대한 자세한 내용은 할당량 조정 정보를 참고하세요.

할당량 조정을 위한 요청 일괄 처리

포함하려는 각 할당량의 체크박스를 선택하여 할당량 조정 요청을 일괄 처리할 수 있습니다. 하지만 일괄 요청을 사용하면 Google Cloud 에서 요청을 검토하는 데 걸리는 시간이 늘어날 수 있습니다.

검토 시간을 줄이기 위해 할당량 조정 요청을 제품 및 영역별로 그룹화합니다. 예를 들어 네트워킹 및 Compute Engine VM 할당량 조정을 요청하려면 네트워킹 할당량 요청 하나와 Compute Engine VM 할당량 요청 하나를 만듭니다.

REST

Cloud Quotas API에서 할당량 조정을 요청하려면 다음 코드 샘플을 사용하세요. 수정 가능한 자리표시자를 값으로 채웁니다. 자리표시자 필드에 대해 알아보려면 코드 샘플 뒤에 나오는 설명을 참고하세요.

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

다음을 바꿉니다.

PROJECT_NUMBER: Google Cloud 프로젝트 번호 Google Cloud 콘솔의 시작 페이지에서 또는 다음 gcloud CLI 명령어를 실행하여 프로젝트 번호를 찾을 수 있습니다.
```
PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"
```
QUOTA_PREFERENCE_ID: 업데이트할 할당량 환경설정의 ID입니다.
QUOTA_ID: 업데이트할 할당량의 ID입니다.
SERVICE_ID: 조정하려는 할당량이 속한 Google Cloud 의 ID입니다. 일반적으로 SERVICE_NAME.googleapis.com 형식입니다. 예를 들어 Compute Engine 서비스 이름은 compute.googleapis.com입니다.
DIMENSION_1: 조정하려는 측정기준의 유형입니다(예: region 또는 zone). 여러 측정기준을 포함할 수 있습니다. 각 측정기준을 값(예: VALUE_1) 뒤에 쉼표로 구분합니다. 할당량의 모든 측정기준을 조정하려면 이 줄을 생략하세요.
VALUE_1: 이전 차원의 값입니다. 예를 들어 이전 측정기준이 region이면 us-central1과 같은 리전을 입력합니다.
JUSTIFICATION: 요청 이유입니다.
EMAIL: 추가 할당량을 부여하기 전에 Google Cloud 에서 결정을 내리는 데 더 많은 정보가 필요한 경우에 연락처로 사용할 수 있는 이메일 주소입니다.

요청 예시

다음은 Compute Engine 할당량 PUS-PER-GPU-FAMILY-per-project-region의 할당량 값 증가 요청의 예입니다. us-central1 리전에 있는 GPU 계열 NVIDIA_H100의 머신에 대해 할당량 값 100을 요청합니다.

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}