1# Error Resolution Workflows
2 
3**Table of Contents:** [Workflow 7: Quota Exhausted Recovery](#workflow-7-quota-exhausted-recovery) · [Workflow 8: Resolve 429 Rate Limit Errors](#workflow-8-resolve-429-rate-limit-errors) · [Workflow 9: Resolve DeploymentLimitReached](#workflow-9-resolve-deploymentlimitreached) · [Workflow 10: Resolve InsufficientQuota](#workflow-10-resolve-insufficientquota) · [Workflow 11: Resolve QuotaExceeded](#workflow-11-resolve-quotaexceeded)
4 
5## Workflow 7: Quota Exhausted Recovery
6 
7**A. Deploy to Different Region**
8```bash
9subId=$(az account show --query id -o tsv)
10for region in eastus westus eastus2 westus2 swedencentral uksouth; do
11  az rest --method get --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/$region/usages?api-version=2023-05-01" \
12    --query "value[?name.value=='OpenAI.Standard.gpt-4o'].{Model:name.value, Used:currentValue, Limit:limit, Available:(limit-currentValue)}" -o table &
13done; wait
14```
15 
16**B. Delete Unused Deployments**
17```bash
18az cognitiveservices account deployment delete --name <resource> --resource-group <rg> --deployment-name <deployment>
19```
20 
21**C. Request Quota Increase (3-5 days)**
22 
23**D. Migrate to PTU** - See capacity-planning.md
24 
25---
26 
27## Workflow 8: Resolve 429 Rate Limit Errors
28 
29**Identify Deployment:**
30```bash
31az cognitiveservices account deployment list --name <resource> --resource-group <rg> \
32  --query "[].{Name:name,Model:properties.model.name,TPM:sku.capacity*1000}" -o table
33```
34 
35**Solutions:**
36 
37**A. Increase Capacity**
38```bash
39az cognitiveservices account deployment update --name <resource> --resource-group <rg> --deployment-name <deployment> --sku-capacity 100
40```
41 
42**B. Add Retry Logic** - Exponential backoff in code
43 
44**C. Load Balance**
45```bash
46az cognitiveservices account deployment create --name <resource> --resource-group <rg> --deployment-name gpt-4o-2 \
47  --model-name gpt-4o --model-version "2024-05-13" --model-format OpenAI --sku-name Standard --sku-capacity 100
48```
49 
50**D. Migrate to PTU** - No rate limits
51 
52---
53 
54## Workflow 9: Resolve DeploymentLimitReached
55 
56**Root Cause:** 10-20 slots per resource.
57 
58**Check Count:**
59```bash
60deployment_count=$(az cognitiveservices account deployment list --name <resource> --resource-group <rg> --query "length(@)")
61echo "Deployments: $deployment_count / ~20 slots"
62```
63 
64**Find Test Deployments:**
65```bash
66az cognitiveservices account deployment list --name <resource> --resource-group <rg> \
67  --query "[?contains(name,'test') || contains(name,'demo')].{Name:name}" -o table
68```
69 
70**Delete:**
71```bash
72az cognitiveservices account deployment delete --name <resource> --resource-group <rg> --deployment-name <deployment>
73```
74 
75**Or Create New Resource (fresh 10-20 slots):**
76```bash
77az cognitiveservices account create --name "my-foundry-2" --resource-group <rg> --location eastus --kind AIServices --sku S0 --yes
78```
79 
80---
81 
82## Workflow 10: Resolve InsufficientQuota
83 
84**Root Cause:** Requested capacity exceeds available quota.
85 
86**Check Quota:**
87```bash
88subId=$(az account show --query id -o tsv)
89az rest --method get --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/eastus/usages?api-version=2023-05-01" \
90  --query "value[?contains(name.value,'OpenAI')].{Model:name.value, Used:currentValue, Limit:limit, Available:(limit-currentValue)}" -o table
91```
92 
93**Solutions:**
94 
95**A. Reduce Capacity**
96```bash
97az cognitiveservices account deployment create --name <resource> --resource-group <rg> --deployment-name gpt-4o \
98  --model-name gpt-4o --model-version "2024-05-13" --model-format OpenAI --sku-name Standard --sku-capacity 20
99```
100 
101**B. Delete Unused Deployments**
102```bash
103az cognitiveservices account deployment delete --name <resource> --resource-group <rg> --deployment-name <unused>
104```
105 
106**C. Different Region** - Check quota with multi-region script (Workflow 7)
107 
108**D. Request Increase (3-5 days)**
109 
110---
111 
112## Workflow 11: Resolve QuotaExceeded
113 
114**Root Cause:** Deployment exceeds regional quota.
115 
116**Check Quota:**
117```bash
118subId=$(az account show --query id -o tsv)
119az rest --method get --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/eastus/usages?api-version=2023-05-01" \
120  --query "value[?contains(name.value,'OpenAI')]" -o table
121```
122 
123**Multi-Region Check:** (Use Workflow 7 script)
124 
125**Solutions:**
126 
127**A. Delete Unused Deployments**
128```bash
129az cognitiveservices account deployment delete --name <resource> --resource-group <rg> --deployment-name <unused>
130```
131 
132**B. Different Region**
133```bash
134az cognitiveservices account deployment create --name <resource> --resource-group <rg> --deployment-name gpt-4o \
135  --model-name gpt-4o --model-version "2024-05-13" --model-format OpenAI --sku-name Standard --sku-capacity 50
136```
137 
138**C. Request Increase (3-5 days)**
139 
140**D. Reduce Capacity**
141 
142**Decision:** Available < 10% → Different region; 10-50% → Delete/reduce; > 50% → Delete one deployment
143 
144---
145 
146