1# Detailed Workflows: Create Foundry Resource
2 
3**Table of Contents:** [Workflow 1: Create Resource Group](#workflow-1-create-resource-group---detailed-steps) · [Workflow 2: Create Foundry Resource](#workflow-2-create-foundry-resource---detailed-steps) · [Workflow 3: Register Resource Provider](#workflow-3-register-resource-provider---detailed-steps)
4 
5## Workflow 1: Create Resource Group - Detailed Steps
6 
7### Step 1: Ask user preference
8 
9Ask the user which option they prefer:
101. Use an existing resource group
112. Create a new resource group
12 
13### Step 2a: If user chooses "Use existing resource group"
14 
15Count and list existing resource groups:
16 
17```bash
18# Count total resource groups
19TOTAL_RG_COUNT=$(az group list --query "length([])" -o tsv)
20 
21# Get list of resource groups (up to 5 most recent)
22az group list --query "[-5:].{Name:name, Location:location}" --out table
23```
24 
25**Handle based on count:**
26 
27**If 0 resources found:**
28- Inform user: "No existing resource groups found"
29- Ask if they want to create a new one, then proceed to Step 2b
30 
31**If 1-4 resources found:**
32- Display all X resource groups to the user
33- Let user select from the list
34- Fetch the selected resource group details:
35  ```bash
36  az group show --name <selected-rg-name> --query "{Name:name, Location:location, State:properties.provisioningState}"
37  ```
38- Display details to user, then proceed to create Foundry resource
39 
40**If 5+ resources found:**
41- Display the 5 most recent resource groups
42- Present options:
43  1. Select from the 5 displayed
44  2. Other (see all resource groups)
45- If user selects a resource group, fetch details:
46  ```bash
47  az group show --name <selected-rg-name> --query "{Name:name, Location:location, State:properties.provisioningState}"
48  ```
49- If user chooses "Other", show all:
50  ```bash
51  az group list --query "[].{Name:name, Location:location}" --out table
52  ```
53  Then let user select, and fetch details as above
54- Display details to user, then proceed to create Foundry resource
55 
56### Step 2b: If user chooses "Create new resource group"
57 
581. List available Azure regions:
59 
60```bash
61az account list-locations --query "[].{Region:name}" --out table
62```
63 
64Common regions:
65- `eastus`, `eastus2` - US East Coast
66- `westus`, `westus2`, `westus3` - US West Coast
67- `centralus` - US Central
68- `westeurope`, `northeurope` - Europe
69- `southeastasia`, `eastasia` - Asia Pacific
70 
712. Ask user to choose a region from the list above
72 
733. Create resource group in the chosen region:
74 
75```bash
76az group create \
77  --name <resource-group-name> \
78  --location <user-chosen-location>
79```
80 
814. Verify creation:
82 
83```bash
84az group show --name <resource-group-name> --query "{Name:name, Location:location, State:properties.provisioningState}"
85```
86 
87Expected output: `State: "Succeeded"`
88 
89## Workflow 2: Create Foundry Resource - Detailed Steps
90 
91### Step 1: Verify prerequisites
92 
93```bash
94# Check Azure CLI version (need 2.0+)
95az --version
96 
97# Verify authentication
98az account show
99 
100# Check resource provider registration status
101az provider show --namespace Microsoft.CognitiveServices --query "registrationState"
102```
103 
104If provider not registered, see Workflow #3: Register Resource Provider.
105 
106### Step 2: Choose location
107 
108**Always ask the user to choose a location.** List available regions and let the user select:
109 
110```bash
111# List available regions for Cognitive Services
112az account list-locations --query "[].{Region:name, DisplayName:displayName}" --out table
113```
114 
115Common regions for AI Services:
116- `eastus`, `eastus2` - US East Coast
117- `westus`, `westus2`, `westus3` - US West Coast
118- `centralus` - US Central
119- `westeurope`, `northeurope` - Europe
120- `southeastasia`, `eastasia` - Asia Pacific
121 
122> **Important:** Do not automatically use the resource group's location. Always ask the user which region they prefer.
123 
124### Step 3: Create Foundry resource
125 
126```bash
127az cognitiveservices account create \
128  --name <resource-name> \
129  --resource-group <rg> \
130  --kind AIServices \
131  --sku S0 \
132  --location <location> \
133  --yes
134```
135 
136**Parameters:**
137- `--name`: Unique resource name (globally unique across Azure)
138- `--resource-group`: Existing resource group name
139- `--kind`: **Must be `AIServices`** for multi-service resource
140- `--sku`: Must be **S0** (Standard - the only supported tier for AIServices)
141- `--location`: Azure region (**always ask user to choose** from available regions)
142- `--yes`: Auto-accept terms without prompting
143 
144### Step 4: Verify resource creation
145 
146```bash
147# Check resource details to verify creation
148az cognitiveservices account show \
149  --name <resource-name> \
150  --resource-group <rg>
151 
152# View endpoint and configuration
153az cognitiveservices account show \
154  --name <resource-name> \
155  --resource-group <rg> \
156  --query "{Name:name, Endpoint:properties.endpoint, Location:location, Kind:kind, SKU:sku.name}"
157```
158 
159Expected output:
160- `provisioningState: "Succeeded"`
161- Endpoint URL
162- SKU: S0
163- Kind: AIServices
164 
165### Step 5: Get access keys
166 
167```bash
168az cognitiveservices account keys list \
169  --name <resource-name> \
170  --resource-group <rg>
171```
172 
173This returns `key1` and `key2` for API authentication.
174 
175## Workflow 3: Register Resource Provider - Detailed Steps
176 
177### When Needed
178 
179Required when:
180- First time creating Cognitive Services in subscription
181- Error: `ResourceProviderNotRegistered`
182- Insufficient permissions during resource creation
183 
184### Steps
185 
186**Step 1: Check registration status**
187 
188```bash
189az provider show \
190  --namespace Microsoft.CognitiveServices \
191  --query "registrationState"
192```
193 
194Possible states:
195- `Registered`: Ready to use
196- `NotRegistered`: Needs registration
197- `Registering`: Registration in progress
198 
199**Step 2: Register provider**
200 
201```bash
202az provider register --namespace Microsoft.CognitiveServices
203```
204 
205**Step 3: Wait for registration**
206 
207Registration typically takes 1-2 minutes. Check status:
208 
209```bash
210az provider show \
211  --namespace Microsoft.CognitiveServices \
212  --query "registrationState"
213```
214 
215Wait until state is `Registered`.
216 
217**Step 4: Verify registration**
218 
219```bash
220az provider list --query "[?namespace=='Microsoft.CognitiveServices']"
221```
222 
223### Required Permissions
224 
225To register a resource provider, you need one of:
226- **Subscription Owner** role
227- **Contributor** role
228- **Custom role** with `Microsoft.*/register/action` permission
229 
230**If you are not the subscription owner:**
2311. Ask someone with the **Owner** or **Contributor** role to register the provider for you
2322. Alternatively, ask them to grant you the `/register/action` privilege so you can register it yourself
233 
234**Alternative registration methods:**
235- **Azure CLI** (recommended): `az provider register --namespace Microsoft.CognitiveServices`
236- **Azure Portal**: Navigate to Subscriptions → Resource providers → Microsoft.CognitiveServices → Register
237- **PowerShell**: `Register-AzResourceProvider -ProviderNamespace Microsoft.CognitiveServices`
238