Troubleshooting Quota Errors
Table of Contents: Common Quota Errors · Detailed Error Resolution · Request Quota Increase Process · Diagnostic Commands · External Resources
Common Quota Errors
| Error | Cause | Quick Fix |
|---|---|---|
QuotaExceeded | Regional quota consumed (TPM or PTU) | Delete unused deployments or request increase |
InsufficientQuota | Not enough available for requested capacity | Reduce deployment capacity or free quota |
DeploymentLimitReached | Too many deployment slots used | Delete unused deployments to free slots |
429 Rate Limit | TPM capacity too low for traffic (Standard only) | Increase TPM capacity or migrate to PTU |
PTU capacity unavailable | No PTU quota in region | Request PTU quota or try different region |
SKU not supported | PTU not available for model/region | Check model availability or use Standard TPM |
Detailed Error Resolution
QuotaExceeded Error
All available TPM or PTU quota consumed in the region.
Resolution:
Check current quota usage:
bashsubId=$(az account show --query id -o tsv) region="eastus" az rest --method get \ --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/$region/usages?api-version=2023-05-01" \ --query "value[?contains(name.value,'OpenAI')].{Model:name.value, Used:currentValue, Limit:limit}" -o tableChoose resolution:
- Option A: Delete unused deployments to free quota
- Option B: Reduce requested deployment capacity
- Option C: Deploy to different region with available quota
- Option D: Request quota increase through Azure Portal
InsufficientQuota Error
Available quota less than requested capacity.
Resolution:
Check available quota:
bash# Calculate available: limit - currentValue subId=$(az account show --query id -o tsv) region="eastus" az rest --method get \ --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/$region/usages?api-version=2023-05-01" \ --query "value[?name.value=='OpenAI.Standard.gpt-4o'].{Model:name.value, Used:currentValue, Limit:limit, Available:(limit-currentValue)}" -o tableOptions:
- Reduce deployment capacity to fit available quota
- Delete existing deployments to free capacity
- Try different region with more available quota
- Request quota increase
DeploymentLimitReached Error
Resource reached maximum deployment slot limit (10-20 slots).
Resolution:
- List existing deployments:bash
az cognitiveservices account deployment list \