예를 들어 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를 사용하여 측정기준을 보는 방법을 보여줍니다.
콘솔
Google Cloud 콘솔에서 IAM 및 관리자 > 할당량 및 시스템 한도 페이지로 이동합니다.
측정기준 열이 표시되지 않으면 다음 단계를 수행합니다.
그 이외의 경우 이 단계를 건너뛰세요.
view_column열 표시 옵션을 클릭합니다.
측정기준을 선택합니다.
확인을 클릭합니다. 테이블에 측정기준 열이 표시됩니다.
결과를 필터링하려면 filter_list필터 옆에 있는 필드에 속성 이름이나 값을 입력합니다.
제품별로 필터링하려면 제품 이름을 입력하고 표시되는 목록에서 선택합니다.
측정기준별로 필터링하려면 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 CLI 구성에서 현재 프로젝트를 기본 프로젝트로 설정한 경우 터미널에서 다음 gcloud 명령어를 실행하여 프로젝트 ID를 찾습니다.
gcloudconfigget-valueproject
SERVICE_ID: 할당량이나 시스템 한도와 연결된 제품의 서비스 ID입니다. 예를 들어 할당량이 Compute Engine A2 CPU의 할당량이면 서비스 ID는 compute.googleapis.com입니다.
측정기준 우선순위
Cloud Quotas API의 일부 사용 사례에서는 복잡한 측정기준 설정이 있습니다.
할당량은 리전과 영역보다 더 세부적인 수준에서 구성될 수 있습니다.
서비스별 측정기준을 사용하면 이러한 세분화 수준을 구현할 수 있습니다.
예를 들어 gpu_family 및 network_id는 Compute Engine 서비스의 서비스별 측정기준입니다. 각 개별 서비스에서 측정기준을 정의하며 각 서비스에는 서로 다른 서비스별 측정기준 집합이 있을 수 있습니다.
위치 측정기준이나 서비스별 측정기준을 사용할 때는 다음 우선순위가 적용됩니다.
모든 위치와 서비스별 측정기준이 지정된 할당량 환경설정 구성이 다른 구성보다 우선 적용됩니다.
위치 측정기준을 지정하는 구성만 서비스별 측정기준만 포함된 구성보다 우선 적용됩니다.
측정기준 결합
할당량 환경설정 구성에서 다음과 같은 방법으로 측정기준을 결합할 수 있습니다.
구성에는 위치 측정기준과 서비스별 측정기준 모두 포함될 수 있습니다. 우선순위가 가장 높습니다.
구성에는 위치 측정기준만 포함될 수도 있습니다. 이 구성은 명시적으로 메서드 1로 구성된 측정기준을 제외한 모든 서비스별 측정기준에 적용됩니다.
구성에는 서비스별 측정기준만 포함될 수도 있습니다. 이 구성은 명시적으로 메서드 1 또는 2로 구성된 위치를 제외한 모든 위치에 적용됩니다.
구성에 서비스별 측정기준이 포함된 경우 모든 서비스별 측정기준이 포함되어야 합니다.
측정기준이 없는 구성이 있을 수 있습니다. 이러한 구성은 명시적으로 구성된 측정기준을 제외하고 모든 위치 및 모든 서비스별 측정기준에 적용됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eCloud Quotas dimensions, represented as key-value pairs, measure resource usage in Google Cloud, and these can be based on region, zone, user, or product attributes.\u003c/p\u003e\n"],["\u003cp\u003eDimensions for quotas and system limits can be viewed in the Google Cloud console or using the gcloud CLI, where the console displays them in the 'Dimensions' column, which can be filtered.\u003c/p\u003e\n"],["\u003cp\u003eAn empty 'Dimensions' column in the console indicates that the quota or system limit applies universally to all dimensions, or that no dimensions are associated with it, like the 'NETWORKS-per-project' quota.\u003c/p\u003e\n"],["\u003cp\u003eThe gcloud CLI allows for viewing dimensions for a single quota/system limit or for an entire product, where the single quota query is much faster than listing all the dimensions for a whole product.\u003c/p\u003e\n"],["\u003cp\u003eWhen configuring quotas, a setup with both location and service-specific dimensions takes the highest precedence, followed by configurations with only location dimensions, then those with only service-specific dimensions.\u003c/p\u003e\n"]]],[],null,["# Configure Cloud Quotas dimensions\n\nCloud Quotas dimensions represent different ways of measuring resource usage in Google Cloud. Dimensions are typically a region, zone, Google Cloud user, or product attribute.\n\n\u003cbr /\u003e\n\nThe Cloud Quotas API represents dimensions as key-value pairs. The `key` is\nthe dimension name (for example, `region`). The `value` is the assigned value\nfor the dimension (for example, a region such as `us-central1`).\n\nFor example, Compute Engine measures VM use by using different dimensions. The\n`region` dimension measures the number of VMs you have in a given region.\nCompute Engine also has a number of product attribute dimensions, including\n`gpu_family`. The `gpu_family` dimension measures the number of GPUs of a\ngiven family in your Google Cloud project.\n\nView dimensions\n---------------\n\nYou can view the dimensions for quotas and system limits by looking in the\nGoogle Cloud console, using the Google Cloud CLI, querying the REST API, or through\nclient libraries. To view dimensions that you haven't specified a value for, use\nthe gcloud CLI. Also use the gcloud CLI to view dimensions\nfor quotas and system limits that don't have regional or zonal dimensions if\nyour project doesn't already use the associated resource. This section shows how\nto view dimensions by using the console and by using the gcloud CLI. \n\n### Console\n\n1. In the Google Cloud console, go to the\n **IAM \\& Admin \\\u003e Quotas \\& System Limits** page:\n\n\n [Go to Quotas \\& System Limits](https://console.cloud.google.com/iam-admin/quotas)\n\n \u003cbr /\u003e\n\n The table on this page displays dimensions in the **Dimensions** column.\n2. If you don't see the **Dimensions** column, take the following steps.\n Otherwise, skip this step.\n\n 1. Click view_column **Column display options**.\n 2. Select **Dimensions**.\n 3. Click **OK** . The **Dimensions** column appears in the table.\n3. To filter the results, enter a property name or value in the field next to\n filter_list **Filter**.\n\n - To filter by product, begin entering the product name and select from the list that appears.\n - To filter by dimension, enter your dimension using the following format: `dimension_name:dimension_value`. For example, to see quotas and system limits defined for the us-central1 region, enter: `region:us-central`.\n\n### Understand blank dimensions\n\nSometimes the **Dimensions** column is empty. This can happen for the\nfollowing reasons:\n\n- The quota or system limit value is the default value and applies for all\n dimensions. For some quotas and system limits, the console shows a line\n that lists the default quota or system limit value for reference. Because\n the default applies to all dimension values, the **Dimensions** column is\n blank. Look at the **Name** column to identify these entries. The **Name**\n column indicates these entries with the word \"default\" in parenthesis at\n the end of the quota or system limit name.\n\n For example, the quota `SetIamPolicyRequestsPerMinutePerProject` is defined\n on the `region` dimension. The console shows a reference entry, and an\n entry for each region. In the **Name** column, the reference entry is\n listed as\n \"SetIAMPolicy requests per minute per region (default).\" For this entry,\n the **Dimensions** column is empty.\n- No dimensions apply. For example, the Compute Engine quota\n `NETWORKS-per-project` isn't associated with a region, zone, or product\n attribute, so there are no dimensions to display.\n\n### gcloud\n\n\n| **Preview\n| --- gcloud CLI for Cloud Quotas**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\n\u003cbr /\u003e\n\nYou can use the gcloud CLI to view dimensions for a single quota or\nsystem limit, or for all quotas and system limits associated with a given\nproduct. Viewing dimensions for a single quota or system limit is usually\nfaster than viewing dimensions for all quotas and system limits associated\nwith a product. The response to a query for a single quota is typically about\n200 lines. The response to a query for a product can exceed 2,000 lines.\n\n### View dimensions for a single quota or system limit with gcloud\n\nTo view dimensions for a single quota or system limit using the\ngcloud CLI, run the following command in your terminal: \n\n```bash\ngcloud beta quotas info describe QUOTA_ID --project=PROJECT_ID --service=SERVICE_ID\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eQUOTA_ID\u003c/var\u003e: the ID for the quota or system limit. If\n you don't know your quota ID, choose one of the following options:\n\n 1. Find it by using the console as described in [Find your quota ID](/docs/quotas/gcloud-cli-examples#find_your_quota_id).\n 2. View all dimensions for the product associated with the quota or system limit you're interested in. This command doesn't require the quota ID. See the section [View dimensions for a product with gcloud CLI](#gcloud-view-product).\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: The ID of your Google Cloud\n project. To find your project ID, choose one of the following options:\n\n 1. To find your project ID by using the console, see [Identifying projects](/resource-manager/docs/creating-managing-projects#identifying_projects).\n 2. If you set your current project as your default project in the gcloud CLI configuration, find your project ID get by running the following gcloud command in your terminal: \n\n ```bash\n gcloud config get-value project\n ```\n- \u003cvar translate=\"no\"\u003eSERVICE_ID\u003c/var\u003e: the service ID of the product associated\n with the quota or system limit. For example, if the quota is for Compute Engine\n A2 CPUs, the service ID is `compute.googleapis.com`.\n\n### View dimensions for a product with gcloud CLI\n\nTo view dimensions for a single quota or system limit using the\ngcloud CLI, run the following command in your terminal: \n\n```bash\ngcloud beta quotas info list --project=PROJECT_ID --service=SERVICE_ID\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: The ID of your Google Cloud\n project. To find your project ID, choose one of the following options:\n\n 1. To find your project ID by using the console, see [Identifying projects](/resource-manager/docs/creating-managing-projects#identifying_projects).\n 2. If you set your current project as your default project in the gcloud CLI configuration, find your project ID get by running the following gcloud command in your terminal: \n\n ```bash\n gcloud config get-value project\n ```\n- \u003cvar translate=\"no\"\u003eSERVICE_ID\u003c/var\u003e: the service ID of the product associated\n with the quota or system limit. For example, if the quota is for Compute Engine\n A2 CPUs, the service ID is `compute.googleapis.com`.\n\nDimension precedence\n--------------------\n\nSome use cases for the Cloud Quotas API have complex dimension setups.\nQuotas can be configured at a more granular level than just regions and zones.\nYou can accomplish this granularity when you use service-specific dimensions.\nFor example, the `gpu_family` and `network_id` are service-specific dimensions\nin the Compute Engine service. Dimensions are defined by each individual\nservice and each service might have a different set of service-specific\ndimensions.\n\nWhen working with either location dimensions or service-specific dimensions,\nthe following precedence is applied:\n\n1. A quota preference configuration with all location and service-specific\n dimensions specified takes precedence over any other configuration.\n\n2. Configurations that specify location dimensions only take precedence over\n configurations containing only service-specific dimensions.\n\nCombining dimensions\n--------------------\n\nIn a quota preference configuration, you can combine dimensions in the following\nways:\n\n1. The configuration may contain *both* location dimensions and service-specific\n dimensions. This is the highest order in precedence.\n\n2. The configuration may *only* contain location dimensions. This configuration\n applies to all service-specific dimensions, except the ones explicitly\n configured with method 1.\n\n3. The configuration may *only* contain service-specific dimensions. This configuration\n applies to all locations except those explicitly configured with method 1 or 2.\n\n4. If the configuration contains *any* service-specific dimensions, it must contain\n all service-specific dimensions.\n\n5. You can have configurations *without any* dimensions. Such configurations\n apply to all locations and all service-specific dimensions, except the ones\n explicitly configured."]]
