이 문서에는 Cloud Natural Language에 적용되는 할당량과 시스템 한도가 나와 있습니다. 할당량은 사용할 수 있는 계수 가능한 공유 리소스의 양을 지정하며 Cloud Natural Language와 같은 Google Cloud 서비스에서 정의됩니다. 시스템 한도는 변경할 수 없는 고정 값입니다.
Google Cloud는 공정성을 보장하고 리소스 사용 및 가용성의 급증을 줄이기 위해 할당량을 사용합니다. 할당량은 Google Cloud 프로젝트에서 사용할 수 있는 Google Cloud 리소스의 양을 제한합니다. 할당량은 하드웨어, 소프트웨어, 네트워크 구성요소를 포함하여 다양한 리소스 유형에 적용됩니다. 예를 들어 할당량에 따라 서비스에 대한 API 호출 수, 프로젝트에서 동시에 사용하는 부하 분산기 수, 만들 수 있는 프로젝트 수가 제한될 수 있습니다. 할당량은 서비스 과부하를 방지하여 Google Cloud 사용자 커뮤니티를 보호합니다. 할당량은 자체 Google Cloud 리소스를 관리하는 데도 도움이 됩니다.
Cloud Quotas 시스템은 다음을 수행합니다.
- Google Cloud 제품 및 서비스 소비량 모니터링
- 리소스 소비 제한
- 할당량 값 변경을 요청할 수 있는 수단 제공
대부분의 경우 할당량이 허용하는 것보다 더 많은 리소스를 소비하려고 하면 시스템에서 리소스에 대한 액세스를 차단하고 수행하려는 작업이 실패합니다.
할당량은 일반적으로 Google Cloud 프로젝트 수준에서 적용됩니다. 한 프로젝트의 리소스를 사용해도 다른 프로젝트에서 사용 가능한 할당량에는 영향을 미치지 않습니다. Google Cloud 프로젝트 내에서 할당량은 모든 애플리케이션과 IP 주소에 공유됩니다.
대부분의 할당량을 조정하려면 Google Cloud 콘솔을 사용합니다. 자세한 내용은 할당량 조정 요청을 참고하세요.
자연어 리소스에도 시스템 한도가 있습니다. 한도는 변경할 수 없습니다.
언어 제한
Natural Language API는 현재 언어 지원에 등록된 언어만 지원합니다.
콘텐츠 할당량
Natural Language API 콘텐츠는 텍스트 문자열로 제공됩니다. Natural Language API는 이 텍스트를 일련의 토큰으로 처리하며, 이는 단어 경계와 대략 일치합니다. Natural Language API의 모든 기능(감정 분석, 항목 추출, 구문 분석)은 이러한 토큰을 제공된 텍스트 분석의 기본 요소로 사용합니다.
각 요청에 대해 콘텐츠의 크기에 따른 API 할당량은 다음과 같습니다.
| 콘텐츠 할당량 | 값 | 오버플로우 결과 |
|---|---|---|
| 텍스트 콘텐츠 | 1,000,000바이트 | API 오류 |
| 토큰 할당량 | 토큰 100,000개 | 무시됨 |
| 항목 멘션 | 5,000* | 무시됨 |
텍스트 콘텐츠 할당량을 초과하는 콘텐츠를 처리하려고 할 경우 오류가 발생합니다. 토큰의 경우 할당량을 초과하는 토큰을 처리하려고 하면 오류가 발생하지는 않지만, 할당량을 초과하는 토큰은 모두 무시됩니다.
바이트 수는 텍스트 콘텐츠 내에서 사용되는 인코딩에 따라 문자 수를 반영하지 않을 수도 있습니다.
* 항목 멘션 할당량에는 문서 내에서 반환된 멘션뿐만 아니라, 대명사를 비롯하여 해당 항목에 대한 모든 명사 참조가 포함됩니다.
이러한 대명사는 할당량에 포함되지만 mentions 필드에 직접 반환되지 않습니다.
요청 할당량
현재 Cloud Natural Language API에 적용되는 API 사용 할당량은 다음과 같으며 변경될 수 있습니다.
| 할당량 유형 | 사용 할당량 |
|---|---|
| 분당 요청 수 | 600 |
| 일일 요청 수 | 800,000 |