Cloud Quotas API 以键值对的形式表示维度。key
是维度名称(例如“region
”)。value
是分配给维度的值(例如区域,比如 us-central1
)。
例如,Compute Engine 使用不同的维度来衡量虚拟机使用情况。region
维度用于衡量您在给定区域中的虚拟机数量。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 requests per minute per region (default)”。对于此条目,“维度”列为空。没有适用的维度。例如,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。
- 查看与您感兴趣的配额或系统限制相关联的产品的所有维度。此命令不需要配额 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 明确配置的位置除外)。
如果配置包含任何特定于服务的维度,则必须包含所有特定于服务的维度。
您的配置可以没有任何维度。此类配置适用于所有位置和所有特定于服务的维度(明确配置的维度除外)。