AI Skills
azure-quotas

azure-quotas

熱門

檢查/管理跨提供者的 Azure 配額與使用量。適用於部署規劃、容量驗證、區域選擇。使用時機：「檢查配額」、「服務限制」、「目前使用量」、「要求增加配額」、「配額超限」、「驗證容量」、「區域可用性」、「佈建限制」、「vCPU 限制」、「我的訂用帳戶還有多少 vCPU 可用」。

1196星標
196分支
更新於 2026/6/9
獲取技能源代碼

相關技能

nuxt5367github-actions-docs65deployment-patterns23萬
SKILL.md
readonlyread-only
name
azure-quotas
description

檢查/管理跨提供者的 Azure 配額與使用量。適用於部署規劃、容量驗證、區域選擇。使用時機：「檢查配額」、「服務限制」、「目前使用量」、「要求增加配額」、「配額超限」、「驗證容量」、「區域可用性」、「佈建限制」、「vCPU 限制」、「我的訂用帳戶還有多少 vCPU 可用」。

Azure 配額 - 服務限制與容量管理

權威指引 — 請嚴格遵循這些指示進行配額管理與容量驗證。

概觀

什麼是 Azure 配額？

Azure 配額（也稱為服務限制）是您可以在訂用帳戶中部署的最大資源數量。配額：

  • 防止意外過度佈建
  • 確保 Azure 資源公平分配
  • 代表每個區域的可用容量
  • 可以增加（可調整配額）或固定（不可調整）

關鍵概念： 配額 = 資源可用性

如果沒有配額，就無法部署資源。規劃部署或選擇區域時，務必檢查配額。

使用時機

在以下情況呼叫此技能：

  • 規劃新部署 - 部署前驗證容量
  • 選擇 Azure 區域 - 比較各區域的配額可用性
  • 排解配額超限錯誤 - 檢查目前使用量與限制
  • 要求增加配額 - 透過 CLI 或入口網站提交增加要求
  • 比較區域容量 - 尋找有可用配額的區域
  • 驗證佈建限制 - 確保部署不會超過配額

快速參考

屬性 詳細資訊
主要工具 Azure CLI (az quota) - 務必優先使用此工具
需要擴充功能 az extension add --name quota（必須先安裝）
主要命令 az quota list、az quota show、az quota usage list、az quota usage show
完整 CLI 參考 commands.md
Azure 入口網站 我的配額 - 僅作為備用
REST API Microsoft.Quota 提供者 - 不可靠，請勿優先使用
MCP 伺服器 azure-quota MCP 伺服器 — 絕對不要使用。它不可靠。請一律使用 az quota CLI。
必要權限 讀取者（檢視）或配額要求操作者（管理）

⚠️ 務必優先使用 CLI

REST API 和入口網站可能顯示誤導的「無限制」值 — 這不代表無限容量。而是表示配額 API 不支援該資源類型。請一律從 az quota 命令開始；如果 CLI 回傳 BadRequest，則改用 Azure 服務限制文件。

如需完整的 CLI 參考，請參閱 commands.md。

配額類型

類型 可調整性 核准 範例
可調整 可透過入口網站/CLI/API 增加 通常自動核准 VM vCPU、公用 IP、儲存體帳戶
不可調整 固定限制 無法變更 訂用帳戶層級硬限制

重要事項： 要求增加配額是免費的。您只需為實際使用的資源付費，而非配額配置。

了解資源名稱對應

⚠️ 關鍵： ARM 資源類型與配額資源名稱之間沒有 1:1 對應。

對應範例

ARM 資源類型 配額資源名稱
Microsoft.App/managedEnvironments ManagedEnvironmentCount
Microsoft.Compute/virtualMachines standardDSv3Family、cores、virtualMachines
Microsoft.Network/publicIPAddresses PublicIPAddresses、IPv4StandardSkuPublicIpAddresses

探索工作流程

切勿從 ARM 類型推測配額資源名稱。 請一律使用此工作流程：

  1. 列出資源提供者的所有配額：

    az quota list --scope /subscriptions/<id>/providers/<ProviderNamespace>/locations/<region>

  2. 透過 localizedValue（人類可讀的描述）比對，找到相關配額

  3. 在後續命令中使用 name 欄位（而非 ARM 資源類型）：

    az quota show --resource-name ManagedEnvironmentCount --scope ...
az quota usage show --resource-name ManagedEnvironmentCount --scope ...

📖 詳細對應範例與工作流程： 請參閱 commands.md - 資源名稱對應

指令碼

預先建置的指令碼可處理配額擴充功能安裝、使用量查詢和容量計算。請使用這些指令碼，而非手動建構命令。單次呼叫即可回傳限制、使用量和可用容量。

指令碼 用途 使用方式
scripts/check-quota.ps1 回傳所有配額的限制、使用量和可用容量（若提供資源名稱則回傳單一配額） 配額檢查的主要指令碼
scripts/check-quota.sh 同上 (bash) 配額檢查的主要指令碼

核心工作流程

工作流程 1：檢查特定資源的配額

情境： 部署前驗證配額限制與目前使用量

使用資源提供者和區域執行指令碼。它會在一次呼叫中回傳所有配額的表格，包含限制、目前使用量和可用容量：

.\scripts\check-quota.ps1 -ResourceProvider <provider> -Region <region>

./scripts/check-quota.sh <provider> <region>

若要檢查單一資源，請加上資源名稱：

.\scripts\check-quota.ps1 -ResourceProvider <provider> -Region <region> -ResourceName <resource-name>

./scripts/check-quota.sh <provider> <region> <resource-name>

範例：

.\scripts\check-quota.ps1 -ResourceProvider Microsoft.Compute -Region eastus

範例輸出：

資源 區域 限制 使用量 可用
cores eastus 100 50 50
standardDSv3Family eastus 350 50 300
virtualMachines eastus 25000 5 24995
... ... ... ... ...

📖 另請參閱： az quota show、az quota usage show

工作流程 2：跨區域比較配額

情境： 根據可用容量找出最適合部署的區域

# 定義候選區域
REGIONS=("eastus" "eastus2" "westus2" "centralus")
VM_FAMILY="standardDSv3Family"
SUBSCRIPTION_ID="<subscription-id>"

# 檢查各區域的配額可用性
for region in "${REGIONS[@]}"; do
  echo "=== 檢查 $region ==="
  
  # 取得限制
  LIMIT=$(az quota show \
    --resource-name $VM_FAMILY \
    --scope "/subscriptions/$SUBSCRIPTION_ID/providers/Microsoft.Compute/locations/$region" \
    --query "properties.limit.value" -o tsv)
  
  # 取得目前使用量
  USAGE=$(az quota usage show \
    --resource-name $VM_FAMILY \
    --scope "/subscriptions/$SUBSCRIPTION_ID/providers/Microsoft.Compute/locations/$region" \
    --query "properties.usages.value" -o tsv)
  
  # 計算可用量
  AVAILABLE=$((LIMIT - USAGE))
  
  echo "區域: $region | 限制: $LIMIT | 使用量: $USAGE | 可用: $AVAILABLE"
done

📖 另請參閱： commands.md 以取得完整的指令碼化多區域迴圈模式

工作流程 3：要求增加配額

情境： 目前配額不足以部署

# 要求增加 VM 配額
az quota update \
  --resource-name standardDSv3Family \
  --scope /subscriptions/<subscription-id>/providers/Microsoft.Compute/locations/eastus \
  --limit-object value=500 \
  --resource-type dedicated

# 檢查要求狀態
az quota request status list \
  --scope /subscriptions/<subscription-id>/providers/Microsoft.Compute/locations/eastus

核准流程：

  • 大多數可調整配額會在幾分鐘內自動核准
  • 部分要求需要人工審查（數小時到數天）
  • 不可調整配額需要 Azure 支援票證

📖 另請參閱： az quota update、az quota request status

工作流程 4：列出所有配額以進行規劃

情境： 了解某區域中資源提供者的所有配額

# 列出美國東部的所有計算配額（表格格式）
az quota list \
  --scope /subscriptions/<subscription-id>/providers/Microsoft.Compute/locations/eastus \
  --output table

# 列出所有網路配額
az quota list \
  --scope /subscriptions/<subscription-id>/providers/Microsoft.Network/locations/eastus \
  --output table

# 列出所有 Container Apps 配額
az quota list \
  --scope /subscriptions/<subscription-id>/providers/Microsoft.App/locations/eastus \
  --output table

📖 另請參閱： az quota list

疑難排解

常見錯誤

錯誤 原因 解決方案
REST API「無限制」 誤導 — 並非無限 改用 CLI；請參閱快速參考中的警告
ExtensionNotFound 未安裝配額擴充功能 az extension add --name quota
BadRequest 配額 API 不支援該資源提供者 查閱服務限制文件
MissingRegistration 未註冊 Microsoft.Quota 提供者 az provider register --namespace Microsoft.Quota
QuotaExceeded 部署會超過配額 要求增加配額或選擇其他區域
InvalidScope 範圍格式不正確 使用模式：/subscriptions/<id>/providers/<namespace>/locations/<region>
CLI 命令完全失敗 驗證、擴充功能或環境問題 驗證 Azure CLI 登入 (az account show)、重新安裝配額擴充功能、檢查網路。請勿使用 azure-quota MCP 伺服器 — 它不可靠。

不支援的資源提供者

已知不支援的提供者：

確認可用的提供者：

  • ✅ Microsoft.Compute (VM、磁碟、核心)
  • ✅ Microsoft.Network (VNet、IP、負載平衡器)
  • ✅ Microsoft.App (Container Apps)
  • ✅ Microsoft.Storage (儲存體帳戶)
  • ✅ Microsoft.MachineLearningServices (ML 計算)

📖 另請參閱： 疑難排解指南

其他資源

資源 連結
CLI 命令參考 commands.md - 完整語法、參數、範例
Azure 配額概觀 Microsoft Learn
服務限制文件 Azure 訂用帳戶限制
Azure 入口網站 - 我的配額 入口網站連結
要求增加配額 如何要求增加

最佳做法

  1. ✅ 部署前務必檢查配額 - 避免配額超限錯誤
  2. ✅ 先執行 az quota list - 找出正確的配額資源名稱
  3. ✅ 比較區域 - 尋找有可用容量的區域
  4. ✅ 考量成長 - 要求比立即需求多 20% 的緩衝
  5. ✅ 使用表格輸出進行概覽 - --output table 快速掃描
  6. ✅ 監控使用量趨勢 - 在 80% 閾值設定警示（透過入口網站）