Troubleshooting Quota Errors

Table of Contents: Common Quota Errors · Detailed Error Resolution · Request Quota Increase Process · Diagnostic Commands · External Resources

Common Quota Errors

Detailed Error Resolution

QuotaExceeded Error

All available TPM or PTU quota consumed in the region.

Resolution:

1. Check current quota usage:

   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[?contains(name.value,'OpenAI')].{Model:name.value, Used:currentValue, Limit:limit}" -o table

1. Choose 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:

1. Check available quota:

   # 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 table

1. Options:

• 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:

1. List existing deployments:

   az cognitiveservices account deployment list \
     --name <resource-name> \
     --resource-group <rg> \
     --query '[].{Name:name, Model:properties.model.name, Capacity:sku.capacity}' \
     --output table

1. Delete unused deployments:

   az cognitiveservices account deployment delete \
     --name <resource-name> \
     --resource-group <rg> \
     --deployment-name <unused-deployment-name>

1. Verify slot freed:

   az cognitiveservices account deployment list \
     --name <resource-name> \
     --resource-group <rg> \
     --query 'length([])'

429 Rate Limit Errors

TPM capacity insufficient for traffic volume (Standard TPM only).

Resolution:

1. Check deployment capacity:

   az cognitiveservices account deployment show \
     --name <resource-name> \
     --resource-group <rg> \
     --deployment-name <deployment-name> \
     --query '{Name:name, Model:properties.model.name, Capacity:sku.capacity, SKU:sku.name}'

1. Options:

• Option A: Increase TPM capacity on existing deployment

     az cognitiveservices account deployment update \
       --name <resource-name> \
       --resource-group <rg> \
       --deployment-name <deployment-name> \
       --sku-capacity <higher-capacity>

• Option B: Migrate to PTU for guaranteed throughput (no rate limits)
• Option C: Implement retry logic with exponential backoff in application

PTU Capacity Unavailable Error

No PTU quota allocated in region, or PTU not available for model/region.

Resolution:

1. Check PTU quota:

   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[?contains(name.value,'ProvisionedManaged')].{Model:name.value, Used:currentValue, Limit:limit}" -o table

1. Options:

• Request PTU quota increase through Azure Portal (include capacity calculator results)
• Try different region where PTU is available
• Use Standard TPM instead

SKU Not Supported Error

PTU not available for specific model or region combination.

Resolution:

1. Check model availability:

• Review PTU model availability by region

1. Options:

• Deploy with Standard TPM SKU instead
• Choose different region where PTU is supported
• Use alternative model that supports PTU in your region

Request Quota Increase Process

For Standard TPM Quota

1. Navigate to Azure Portal → Your Foundry resource → Quotas
2. Identify model needing increase (e.g., "GPT-4o Standard")
3. Click Request quota increase
4. Fill form:

• Model name
• Requested quota (in TPM)
• Business justification (required)

1. Submit and monitor status

Processing Time: Typically 1-2 business days

For PTU Quota

1. Navigate to Azure Portal → Your Foundry resource → Quotas
2. Select Provisioned throughput unit tab
3. Identify model needing PTU increase
4. Click Request quota increase
5. Fill form:

• Model name
• Requested PTU quota
• Include capacity calculator results
• Detailed business justification (workload characteristics)

1. Submit and monitor status

Processing Time: Typically 3-5 business days (requires stronger justification)

Diagnostic Commands

# Check deployment status
az cognitiveservices account deployment show \
  --name <resource-name> \
  --resource-group <rg> \
  --deployment-name <deployment-name>

# Verify available quota
subId=$(az account show --query id -o tsv)
az rest --method get \
  --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/eastus/usages?api-version=2023-05-01" \
  --query "value[?contains(name.value,'OpenAI')].{Model:name.value, Used:currentValue, Limit:limit, Available:(limit-currentValue)}" \
  --output table

# List all deployments
az cognitiveservices account deployment list \
  --name <resource-name> \
  --resource-group <rg> \
  --query '[].{Name:name, Model:properties.model.name, Capacity:sku.capacity, SKU:sku.name}' \
  --output table

External Resources

• Quota Management Documentation
• Rate Limits Documentation
• Troubleshooting Guide