Cloud Quotas API는 측정기준을 키-값 쌍으로 나타냅니다. key는 측정기준 이름입니다(예: region). value는 측정기준에 할당된 값입니다(예: us-central1과 같은 리전).
예를 들어 Compute Engine은 서로 다른 측정기준을 사용하여 VM 사용량을 측정합니다. region 측정기준은 특정 리전에 있는 VM 수를 측정합니다.
Compute Engine에는 gpu_family를 포함한 여러 제품 속성 측정기준도 있습니다. gpu_family 측정기준은 Google Cloud 프로젝트에서 특정 계열의 GPU 수를 측정합니다.
측정기준 보기
Google Cloud 콘솔을 확인하거나 Google Cloud CLI를 사용하거나 REST API를 쿼리하거나 클라이언트 라이브러리를 통해 할당량과 시스템 한도의 측정기준을 볼 수 있습니다. 값을 지정하지 않은 측정기준을 보려면 gcloud CLI를 사용하세요. 또한 프로젝트에서 아직 연결된 리소스를 사용하지 않는 경우 gcloud CLI를 사용하여 리전 또는 영역 측정기준이 없는 할당량과 시스템 한도의 측정기준을 볼 수 있습니다. 이 섹션에서는 콘솔과 gcloud CLI를 사용하여 측정기준을 보는 방법을 보여줍니다.
콘솔
할당량 및 시스템 한도 페이지로 이동합니다.
이 페이지에 있는 테이블의 측정기준 열에 측정기준이 표시됩니다.
측정기준 열이 표시되지 않으면 다음 단계를 수행합니다. 그 이외의 경우 이 단계를 건너뛰세요.
- 열 표시 옵션을 클릭합니다.
- 측정기준을 선택합니다.
- 확인을 클릭합니다. 테이블에 측정기준 열이 표시됩니다.
결과를 필터링하려면 필터 옆에 있는 필드에 속성 이름이나 값을 입력합니다.
- 제품별로 필터링하려면 제품 이름을 입력하고 표시되는 목록에서 선택합니다.
- 측정기준별로 필터링하려면
dimension_name:dimension_value형식을 사용하여 측정기준을 입력합니다. 예를 들어 us-central1 리전에 정의된 할당량과 시스템 한도를 보려면region:us-central을 입력합니다.
비어 있는 측정기준 이해하기
측정기준 열이 비어 있는 경우가 있습니다. 이는 다음과 같은 이유로 발생할 수 있습니다.
할당량 또는 시스템 한도 값은 기본값이며 모든 측정기준에 적용됩니다. 일부 할당량 및 시스템 한도의 경우 참조용으로 기본 할당량이나 시스템 한도 값을 나열하는 줄이 콘솔에 표시됩니다. 기본값은 모든 측정기준 값에 적용되므로 측정기준 열이 비어 있습니다. 이름 열에서 이러한 항목을 찾아 확인합니다. 이름 열에는 할당량 또는 시스템 한도 이름 끝에 괄호로 묶인 '기본값' 단어가 있는 항목이 표시됩니다.
예를 들어
SetIamPolicyRequestsPerMinutePerProject할당량은region측정기준에서 정의됩니다. 콘솔에는 참조 항목과 각 리전의 항목이 표시됩니다. 이름 열에서는 참조 항목이 '리전별 분당 SetIAMPolicy 요청 수(기본값)'로 나와 있습니다. 이 항목의 경우 측정기준 열이 비어 있습니다.적용되는 측정기준이 없습니다. 예를 들어 Compute Engine 할당량
NETWORKS-per-project는 리전, 영역 또는 제품 속성과 연결되어 있지 않으므로 표시될 측정기준이 없습니다.
gcloud
gcloud CLI를 사용하여 단일 할당량이나 시스템 한도 또는 특정 제품과 연결된 모든 할당량과 시스템 한도의 측정기준을 볼 수 있습니다. 일반적으로 단일 할당량이나 시스템 한도의 측정기준을 보는 것이 제품과 연결된 모든 할당량과 시스템 한도의 측정기준을 보는 것보다 더 빠릅니다. 단일 할당량 쿼리에 대한 응답은 일반적으로 약 200줄입니다. 제품 검색어에 대한 응답은 2,000줄을 초과할 수 있습니다.
gcloud로 단일 할당량 또는 시스템 한도의 측정기준 보기
gcloud CLI를 사용하여 단일 할당량이나 시스템 한도의 측정기준을 보려면 터미널에서 다음 명령어를 실행합니다.
gcloud alpha quotas info describe QUOTA_ID --project=PROJECT_ID --service=SERVICE_ID
다음을 바꿉니다.
QUOTA_ID: 할당량 또는 시스템 한도의 ID입니다. 할당량 ID를 모르는 경우 다음 옵션 중 하나를 선택합니다.- 할당량 ID 찾기의 설명대로 콘솔을 사용하여 찾습니다.
- 관심 있는 할당량이나 시스템 한도와 연결된 제품의 모든 측정기준을 봅니다. 이 명령어에는 할당량 ID가 필요 없습니다. gcloud CLI로 제품 측정기준 보기 섹션을 참조하세요.
PROJECT_ID: Google Cloud 프로젝트의 ID입니다. 프로젝트 ID를 찾으려면 다음 옵션 중 하나를 선택합니다.- 콘솔을 사용하여 프로젝트 ID를 찾으려면 프로젝트 식별을 참조하세요.
- gcloud CLI 구성에서 현재 프로젝트를 기본 프로젝트로 설정한 경우 터미널에서 다음 gcloud 명령어를 실행하여 프로젝트 ID를 찾습니다.
gcloud config get-value project
SERVICE_ID: 할당량이나 시스템 한도와 연결된 제품의 서비스 ID입니다. 예를 들어 할당량이 Compute Engine A2 CPU의 할당량이면 서비스 ID는compute.googleapis.com입니다.
gcloud CLI로 제품 측정기준 보기
gcloud CLI를 사용하여 단일 할당량이나 시스템 한도의 측정기준을 보려면 터미널에서 다음 명령어를 실행합니다.
gcloud alpha quotas info list --project=PROJECT_ID --service=SERVICE_ID
다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트의 ID입니다. 프로젝트 ID를 찾으려면 다음 옵션 중 하나를 선택합니다.- 콘솔을 사용하여 프로젝트 ID를 찾으려면 프로젝트 식별을 참조하세요.
- gcloud CLI 구성에서 현재 프로젝트를 기본 프로젝트로 설정한 경우 터미널에서 다음 gcloud 명령어를 실행하여 프로젝트 ID를 찾습니다.
gcloud config get-value project
SERVICE_ID: 할당량이나 시스템 한도와 연결된 제품의 서비스 ID입니다. 예를 들어 할당량이 Compute Engine A2 CPU의 할당량이면 서비스 ID는compute.googleapis.com입니다.
측정기준 우선순위
Cloud Quotas API의 일부 사용 사례에서는 복잡한 측정기준 설정이 있습니다.
할당량은 리전과 영역보다 더 세부적인 수준에서 구성될 수 있습니다.
서비스별 측정기준을 사용하면 이러한 세분화 수준을 구현할 수 있습니다.
예를 들어 gpu_family 및 network_id는 Compute Engine 서비스의 서비스별 측정기준입니다. 각 개별 서비스에서 측정기준을 정의하며 각 서비스에는 서로 다른 서비스별 측정기준 집합이 있을 수 있습니다.
위치 측정기준이나 서비스별 측정기준을 사용할 때는 다음 우선순위가 적용됩니다.
모든 위치와 서비스별 측정기준이 지정된 할당량 환경설정 구성이 다른 구성보다 우선 적용됩니다.
위치 측정기준을 지정하는 구성만 서비스별 측정기준만 포함된 구성보다 우선 적용됩니다.
측정기준 결합
할당량 환경설정 구성에서 다음과 같은 방법으로 측정기준을 결합할 수 있습니다.
구성에는 위치 측정기준과 서비스별 측정기준 모두 포함될 수 있습니다. 우선순위가 가장 높습니다.
구성에는 위치 측정기준만 포함될 수도 있습니다. 이 구성은 명시적으로 메서드 1로 구성된 측정기준을 제외한 모든 서비스별 측정기준에 적용됩니다.
구성에는 서비스별 측정기준만 포함될 수도 있습니다. 이 구성은 명시적으로 메서드 1 또는 2로 구성된 위치를 제외한 모든 위치에 적용됩니다.
구성에 서비스별 측정기준이 포함된 경우 모든 서비스별 측정기준이 포함되어야 합니다.
측정기준이 없는 구성이 있을 수 있습니다. 이러한 구성은 명시적으로 구성된 측정기준을 제외하고 모든 위치 및 모든 서비스별 측정기준에 적용됩니다.