1# Common Patterns: Create Foundry Resource
2 
3**Table of Contents:** [Pattern A: Quick Setup](#pattern-a-quick-setup) · [Pattern B: Multi-Region Setup](#pattern-b-multi-region-setup) · [Quick Commands Reference](#quick-commands-reference)
4 
5## Pattern A: Quick Setup
6 
7Complete setup in one go:
8 
9```bash
10# Ask user: "Use existing resource group or create new?"
11 
12# ==== If user chooses "Use existing" ====
13# Count and list existing resource groups
14TOTAL_RG_COUNT=$(az group list --query "length([])" -o tsv)
15az group list --query "[-5:].{Name:name, Location:location}" --out table
16 
17# Based on count: show appropriate list and options
18# User selects resource group
19RG="<selected-rg-name>"
20 
21# Fetch details to verify
22az group show --name $RG --query "{Name:name, Location:location, State:properties.provisioningState}"
23# Then skip to creating Foundry resource below
24 
25# ==== If user chooses "Create new" ====
26# List regions and ask user to choose
27az account list-locations --query "[].{Region:name}" --out table
28 
29# Variables
30RG="rg-ai-services"  # New resource group name
31LOCATION="westus2"  # User's chosen location
32RESOURCE_NAME="my-foundry-resource"
33 
34# Create new resource group
35az group create --name $RG --location $LOCATION
36 
37# Verify creation
38az group show --name $RG --query "{Name:name, Location:location, State:properties.provisioningState}"
39 
40# Create Foundry resource in user's chosen location
41az cognitiveservices account create \
42  --name $RESOURCE_NAME \
43  --resource-group $RG \
44  --kind AIServices \
45  --sku S0 \
46  --location $LOCATION \
47  --yes
48 
49# Get endpoint and keys
50echo "Resource created successfully!"
51az cognitiveservices account show \
52  --name $RESOURCE_NAME \
53  --resource-group $RG \
54  --query "{Endpoint:properties.endpoint, Location:location}"
55 
56az cognitiveservices account keys list \
57  --name $RESOURCE_NAME \
58  --resource-group $RG
59```
60 
61## Pattern B: Multi-Region Setup
62 
63Create resources in multiple regions:
64 
65```bash
66# Variables
67RG="rg-ai-services"
68REGIONS=("eastus" "westus2" "westeurope")
69 
70# Create resource group
71az group create --name $RG --location eastus
72 
73# Create resources in each region
74for REGION in "${REGIONS[@]}"; do
75  RESOURCE_NAME="foundry-${REGION}"
76  echo "Creating resource in $REGION..."
77 
78  az cognitiveservices account create \
79    --name $RESOURCE_NAME \
80    --resource-group $RG \
81    --kind AIServices \
82    --sku S0 \
83    --location $REGION \
84    --yes
85 
86  echo "Resource $RESOURCE_NAME created in $REGION"
87done
88 
89# List all resources
90az cognitiveservices account list --resource-group $RG --output table
91```
92 
93## Quick Commands Reference
94 
95```bash
96# Count total resource groups to determine which scenario applies
97az group list --query "length([])" -o tsv
98 
99# Check existing resource groups (up to 5 most recent)
100# 0 → create new | 1-4 → select or create | 5+ → select/other/create
101az group list --query "[-5:].{Name:name, Location:location}" --out table
102 
103# If 5+ resource groups exist and user selects "Other", show all
104az group list --query "[].{Name:name, Location:location}" --out table
105 
106# If user selects existing resource group, fetch details to verify and get location
107az group show --name <selected-rg-name> --query "{Name:name, Location:location, State:properties.provisioningState}"
108 
109# List available regions (for creating new resource group)
110az account list-locations --query "[].{Region:name}" --out table
111 
112# Create resource group (if needed)
113az group create --name rg-ai-services --location westus2
114 
115# Create Foundry resource
116az cognitiveservices account create \
117  --name my-foundry-resource \
118  --resource-group rg-ai-services \
119  --kind AIServices \
120  --sku S0 \
121  --location westus2 \
122  --yes
123 
124# List resources in group
125az cognitiveservices account list --resource-group rg-ai-services
126 
127# Get resource details
128az cognitiveservices account show \
129  --name my-foundry-resource \
130  --resource-group rg-ai-services
131 
132# Delete resource
133az cognitiveservices account delete \
134  --name my-foundry-resource \
135  --resource-group rg-ai-services
136```
137