이 문서에서는 Cloud Key Management Service 할당량을 관리하는 방법을 보여줍니다. Cloud KMS와 관련된 할당량에 대한 자세한 내용은 할당량을 참조하세요.
시작하기 전에
프로젝트 할당량을 보려면 다음 권한이 필요합니다.
resourcemanager.projects.getmonitoring.timeSeries.listserviceusage.services.listserviceusage.quotas.get
프로젝트 할당량을 변경하려면 serviceusage.quotas.update 권한이 필요합니다.
이러한 권한이 포함된 IAM 역할에 대한 자세한 내용은 IAM 권한 참조를 확인하세요.
Cloud KMS 할당량 검사
Google Cloud 콘솔에서 Cloud KMS API의 API/서비스 세부정보 페이지로 이동합니다.
이 페이지에서는 Cloud KMS API의 할당량 세부정보를 확인할 수 있습니다.
다른 프로젝트의 할당량을 보려면 Google Cloud 콘솔 헤더에서 프로젝트를 선택합니다.
할당량 유형으로 필터링하려면 필터 표시줄을 클릭하고 속성 목록에서 할당량 을 선택한 후 할당량을 선택합니다.
리전별로 필터링하려면 필터 표시줄을 클릭하고 속성 목록에서 측정기준(예: 위치): 을 선택한 후 리전 이름을 입력합니다.
할당량에 근접하거나 초과하는 경우 더 큰 Cloud KMS 할당량을 요청할 수 있습니다. 할당량 조정기 시스템에서 사용량에 따라 Cloud KMS 할당량을 자동으로 조정하도록 선택할 수도 있습니다.
할당량 문제 해결
할당량을 초과하여 시스템에서 요청을 처리할 수 없으므로 Cloud KMS가 요청을 거부하면 RESOURCE_EXHAUSTED 오류가 반환됩니다. Cloud KMS REST API를 사용하여 생성된 요청의 경우 RESOURCE_EXHAUSTED 오류에는 HTTP 상태 코드 429가 포함됩니다.
반복되는 RESOURCE_EXHAUSTED 오류는 프로젝트가 하나 이상의 할당량을 정기적으로 초과함을 나타냅니다. 이 문제를 해결하려면 다음 중 일부 또는 전부를 시도해 보세요.
프로젝트가 Cloud KMS 리소스를 사용한 요청을 수행하는 속도를 줄입니다.
더 큰 Cloud KMS 할당량을 요청하거나 할당량 조정기 시스템을 사용하여 사용량에 따라 Cloud KMS 할당량을 자동으로 조정하도록 선택합니다.
여러 리소스가 동일한 할당량을 공유하지 않도록 적절한 경우 리소스에 별도의 키 프로젝트를 사용합니다.
클라이언트에 백오프 메커니즘을 추가하여
RESOURCE_EXHAUSTED오류를 처리합니다.
더 큰 Cloud KMS 할당량 요청
Google Cloud 콘솔에서 Cloud KMS API의 API/서비스 세부정보 페이지로 이동합니다.
이 페이지에서는 Cloud KMS API의 할당량 세부정보를 확인할 수 있습니다.
다른 프로젝트의 할당량 상향을 요청하려면 콘솔 헤더 Google Cloud 에서 프로젝트를 선택합니다.
할당량 목록에서 늘리려는 기본 또는 리전별 할당량을 선택한 다음 할당량 수정 을 클릭합니다.
할당량 변경 창에서 선택한 할당량에 선택한 한도를 입력합니다.
요청 설명에 요청 사유에 관한 설명을 입력합니다.
계속하려면 다음을 클릭합니다.
이름, 이메일, 전화를 포함한 연락처 정보를 입력합니다.
요청을 제출하려면 요청 제출 을 클릭합니다.
요청이 제출되면 평가를 위해 승인자에게 전송됩니다. 검토가 완료되면 요청 상태에 대한 알림이 전송됩니다.
특정 프로젝트의 Cloud KMS 사용량 한도 설정
Cloud KMS 리소스에 더 엄격한 사용량 할당량을 적용하려면 지정된 프로젝트의 할당량을 기본값보다 낮은 한도로 설정합니다.
Google Cloud 콘솔에서 Cloud KMS API의 API/서비스 세부정보 페이지로 이동합니다.
이 페이지에서는 Cloud KMS API의 할당량 세부정보를 확인할 수 있습니다.
다른 프로젝트의 할당량을 줄이려면 콘솔 헤더에서 Google Cloud 프로젝트를 선택합니다.
할당량 목록에서 줄이려는 기본 또는 리전별 할당량을 선택한 다음 할당량 수정 을 클릭합니다.
할당량 변경 창에서 선택한 할당량에 선택한 한도를 입력합니다.
계속하려면 다음 을 클릭합니다.
할당량을 현재 한도보다 10% 넘게 줄이면 경고가 표시됩니다. 계속 진행하여 기본값보다 낮은 할당량을 적용하려면 확인을 클릭합니다. 그렇지 않으면 취소를 클릭하여 돌아가서 새 한도를 선택하면 됩니다.
변경사항을 저장하려면 요청 제출을 클릭합니다.
새 한도가 즉시 적용됩니다.
다음 단계
- Cloud 할당량 자세히 알아보기
- 클라이언트 라이브러리에
RESOURCE_EXHAUSTED오류가 표시되는 방식에 대한 자세한 내용은 클라이언트 라이브러리 매핑을 참조하세요. - Cloud KMS 할당량에 관한 세부정보를 확인하세요.