1# Troubleshooting Quota Errors
2 
3**Table of Contents:** [Common Quota Errors](#common-quota-errors) · [Detailed Error Resolution](#detailed-error-resolution) · [Request Quota Increase Process](#request-quota-increase-process) · [Diagnostic Commands](#diagnostic-commands) · [External Resources](#external-resources)
4 
5## Common Quota Errors
6 
7| Error | Cause | Quick Fix |
8|-------|-------|-----------|
9| `QuotaExceeded` | Regional quota consumed (TPM or PTU) | Delete unused deployments or request increase |
10| `InsufficientQuota` | Not enough available for requested capacity | Reduce deployment capacity or free quota |
11| `DeploymentLimitReached` | Too many deployment slots used | Delete unused deployments to free slots |
12| `429 Rate Limit` | TPM capacity too low for traffic (Standard only) | Increase TPM capacity or migrate to PTU |
13| `PTU capacity unavailable` | No PTU quota in region | Request PTU quota or try different region |
14| `SKU not supported` | PTU not available for model/region | Check model availability or use Standard TPM |
15 
16## Detailed Error Resolution
17 
18### QuotaExceeded Error
19 
20All available TPM or PTU quota consumed in the region.
21 
22**Resolution:**
23 
241. **Check current quota usage:**
25   ```bash
26   subId=$(az account show --query id -o tsv)
27   region="eastus"
28   az rest --method get \
29     --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/$region/usages?api-version=2023-05-01" \
30     --query "value[?contains(name.value,'OpenAI')].{Model:name.value, Used:currentValue, Limit:limit}" -o table
31   ```
32 
332. **Choose resolution:**
34   - **Option A**: Delete unused deployments to free quota
35   - **Option B**: Reduce requested deployment capacity
36   - **Option C**: Deploy to different region with available quota
37   - **Option D**: Request quota increase through Azure Portal
38 
39### InsufficientQuota Error
40 
41Available quota less than requested capacity.
42 
43**Resolution:**
44 
451. **Check available quota:**
46   ```bash
47   # Calculate available: limit - currentValue
48   subId=$(az account show --query id -o tsv)
49   region="eastus"
50   az rest --method get \
51     --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/$region/usages?api-version=2023-05-01" \
52     --query "value[?name.value=='OpenAI.Standard.gpt-4o'].{Model:name.value, Used:currentValue, Limit:limit, Available:(limit-currentValue)}" -o table
53   ```
54 
552. **Options:**
56   - Reduce deployment capacity to fit available quota
57   - Delete existing deployments to free capacity
58   - Try different region with more available quota
59   - Request quota increase
60 
61### DeploymentLimitReached Error
62 
63Resource reached maximum deployment slot limit (10-20 slots).
64 
65**Resolution:**
66 
671. **List existing deployments:**
68   ```bash
69   az cognitiveservices account deployment list \
70     --name <resource-name> \
71     --resource-group <rg> \
72     --query '[].{Name:name, Model:properties.model.name, Capacity:sku.capacity}' \
73     --output table
74   ```
75 
762. **Delete unused deployments:**
77   ```bash
78   az cognitiveservices account deployment delete \
79     --name <resource-name> \
80     --resource-group <rg> \
81     --deployment-name <unused-deployment-name>
82   ```
83 
843. **Verify slot freed:**
85   ```bash
86   az cognitiveservices account deployment list \
87     --name <resource-name> \
88     --resource-group <rg> \
89     --query 'length([])'
90   ```
91 
92### 429 Rate Limit Errors
93 
94TPM capacity insufficient for traffic volume (Standard TPM only).
95 
96**Resolution:**
97 
981. **Check deployment capacity:**
99   ```bash
100   az cognitiveservices account deployment show \
101     --name <resource-name> \
102     --resource-group <rg> \
103     --deployment-name <deployment-name> \
104     --query '{Name:name, Model:properties.model.name, Capacity:sku.capacity, SKU:sku.name}'
105   ```
106 
1072. **Options:**
108   - **Option A**: Increase TPM capacity on existing deployment
109     ```bash
110     az cognitiveservices account deployment update \
111       --name <resource-name> \
112       --resource-group <rg> \
113       --deployment-name <deployment-name> \
114       --sku-capacity <higher-capacity>
115     ```
116   - **Option B**: Migrate to PTU for guaranteed throughput (no rate limits)
117   - **Option C**: Implement retry logic with exponential backoff in application
118 
119### PTU Capacity Unavailable Error
120 
121No PTU quota allocated in region, or PTU not available for model/region.
122 
123**Resolution:**
124 
1251. **Check PTU quota:**
126   ```bash
127   subId=$(az account show --query id -o tsv)
128   region="eastus"
129   az rest --method get \
130     --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/$region/usages?api-version=2023-05-01" \
131     --query "value[?contains(name.value,'ProvisionedManaged')].{Model:name.value, Used:currentValue, Limit:limit}" -o table
132   ```
133 
1342. **Options:**
135   - Request PTU quota increase through Azure Portal (include capacity calculator results)
136   - Try different region where PTU is available
137   - Use Standard TPM instead
138 
139### SKU Not Supported Error
140 
141PTU not available for specific model or region combination.
142 
143**Resolution:**
144 
1451. **Check model availability:**
146   - Review [PTU model availability by region](https://learn.microsoft.com/azure/ai-services/openai/concepts/models#provisioned-deployment-model-availability)
147 
1482. **Options:**
149   - Deploy with Standard TPM SKU instead
150   - Choose different region where PTU is supported
151   - Use alternative model that supports PTU in your region
152 
153## Request Quota Increase Process
154 
155### For Standard TPM Quota
156 
1571. Navigate to Azure Portal → Your Foundry resource → **Quotas**
1582. Identify model needing increase (e.g., "GPT-4o Standard")
1593. Click **Request quota increase**
1604. Fill form:
161   - Model name
162   - Requested quota (in TPM)
163   - Business justification (required)
1645. Submit and monitor status
165 
166**Processing Time:** Typically 1-2 business days
167 
168### For PTU Quota
169 
1701. Navigate to Azure Portal → Your Foundry resource → **Quotas**
1712. Select **Provisioned throughput unit** tab
1723. Identify model needing PTU increase
1734. Click **Request quota increase**
1745. Fill form:
175   - Model name
176   - Requested PTU quota
177   - Include capacity calculator results
178   - Detailed business justification (workload characteristics)
1796. Submit and monitor status
180 
181**Processing Time:** Typically 3-5 business days (requires stronger justification)
182 
183## Diagnostic Commands
184 
185```bash
186# Check deployment status
187az cognitiveservices account deployment show \
188  --name <resource-name> \
189  --resource-group <rg> \
190  --deployment-name <deployment-name>
191 
192# Verify available quota
193subId=$(az account show --query id -o tsv)
194az rest --method get \
195  --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/eastus/usages?api-version=2023-05-01" \
196  --query "value[?contains(name.value,'OpenAI')].{Model:name.value, Used:currentValue, Limit:limit, Available:(limit-currentValue)}" \
197  --output table
198 
199# List all deployments
200az cognitiveservices account deployment list \
201  --name <resource-name> \
202  --resource-group <rg> \
203  --query '[].{Name:name, Model:properties.model.name, Capacity:sku.capacity, SKU:sku.name}' \
204  --output table
205```
206 
207## External Resources
208 
209- [Quota Management Documentation](https://learn.microsoft.com/azure/ai-services/openai/how-to/quota)
210- [Rate Limits Documentation](https://learn.microsoft.com/azure/ai-services/openai/quotas-limits)
211- [Troubleshooting Guide](https://learn.microsoft.com/azure/ai-services/openai/troubleshooting)
212