1---
2name: microsoft-foundry:resource/create
3description: |
4  Create Azure AI Services multi-service resource (Foundry resource) using Azure CLI.
5  USE FOR: create Foundry resource, new AI Services resource, create multi-service resource, provision Azure AI Services, AIServices kind resource, register resource provider, enable Cognitive Services, setup AI Services account, create resource group for Foundry.
6  DO NOT USE FOR: creating ML workspace hubs (use microsoft-foundry:project/create), deploying models (use microsoft-foundry:models/deploy), managing permissions (use microsoft-foundry:rbac), monitoring resource usage (use microsoft-foundry:quota).
7compatibility:
8  required:
9    - azure-cli: ">=2.0"
10  optional:
11    - powershell: ">=7.0"
12    - azure-portal: "any"
13---
14 
15# Create Foundry Resource
16 
17This sub-skill orchestrates creation of Azure AI Services multi-service resources using Azure CLI.
18 
19> **Important:** All resource creation operations are **control plane (management)** operations. Use **Azure CLI commands** as the primary method.
20 
21> **Note:** For monitoring resource usage and quotas, use the `microsoft-foundry:quota` skill.
22 
23**Table of Contents:** [Quick Reference](#quick-reference) · [When to Use](#when-to-use) · [Prerequisites](#prerequisites) · [Core Workflows](#core-workflows) · [Important Notes](#important-notes) · [Additional Resources](#additional-resources)
24 
25## Quick Reference
26 
27| Property | Value |
28|----------|-------|
29| **Classification** | WORKFLOW SKILL |
30| **Operation Type** | Control Plane (Management) |
31| **Primary Method** | Azure CLI: `az cognitiveservices account create` |
32| **Resource Type** | `Microsoft.CognitiveServices/accounts` (kind: `AIServices`) |
33| **Resource Kind** | `AIServices` (multi-service) |
34 
35## When to Use
36 
37Use this sub-skill when you need to:
38 
39- **Create Foundry resource** - Provision new Azure AI Services multi-service account
40- **Create resource group** - Set up resource group before creating resources
41- **Register resource provider** - Enable Microsoft.CognitiveServices provider
42- **Manual resource creation** - CLI-based resource provisioning
43 
44**Do NOT use for:**
45- Creating ML workspace hubs/projects (use `microsoft-foundry:project/create`)
46- Deploying AI models (use `microsoft-foundry:models/deploy`)
47- Managing RBAC permissions (use `microsoft-foundry:rbac`)
48- Monitoring resource usage (use `microsoft-foundry:quota`)
49 
50## Prerequisites
51 
52- **Azure subscription** - Active subscription ([create free account](https://azure.microsoft.com/pricing/purchase-options/azure-account))
53- **Azure CLI** - Version 2.0 or later installed
54- **Authentication** - Run `az login` before commands
55- **RBAC roles** - One of:
56  - Contributor
57  - Owner
58  - Custom role with `Microsoft.CognitiveServices/accounts/write`
59- **Resource provider** - `Microsoft.CognitiveServices` must be registered in your subscription
60  - If not registered, see [Workflow #3: Register Resource Provider](#3-register-resource-provider)
61  - If you lack permissions, ask a subscription Owner/Contributor to register it or grant you `/register/action` privilege
62 
63> **Need RBAC help?** See [microsoft-foundry:rbac](../../rbac/rbac.md) for permission management.
64 
65## Core Workflows
66 
67### 1. Create Resource Group
68 
69**Command Pattern:** "Create a resource group for my Foundry resources"
70 
71#### Steps
72 
731. **Ask user preference**: Use existing or create new resource group
742. **If using existing**: List and let user select from available groups (0-4: show all, 5+: show 5 most recent with "Other" option)
753. **If creating new**: Ask user to choose region, then create
76 
77```bash
78# List existing resource groups
79az group list --query "[-5:].{Name:name, Location:location}" --out table
80 
81# Or create new
82az group create --name <rg-name> --location <location>
83az group show --name <rg-name> --query "{Name:name, Location:location, State:properties.provisioningState}"
84```
85 
86See [Detailed Workflow Steps](./references/workflows.md) for complete instructions.
87 
88---
89 
90### 2. Create Foundry Resource
91 
92**Command Pattern:** "Create a new Azure AI Services resource"
93 
94#### Steps
95 
961. **Verify prerequisites**: Check Azure CLI, authentication, and provider registration
972. **Choose location**: Always ask user to select region (don't assume resource group location)
983. **Create resource**: Use `--kind AIServices` and `--sku S0` (only supported tier)
994. **Verify and get keys**
100 
101```bash
102# Create Foundry resource
103az cognitiveservices account create \
104  --name <resource-name> \
105  --resource-group <rg> \
106  --kind AIServices \
107  --sku S0 \
108  --location <location> \
109  --yes
110 
111# Verify and get keys
112az cognitiveservices account show --name <resource-name> --resource-group <rg>
113az cognitiveservices account keys list --name <resource-name> --resource-group <rg>
114```
115 
116**Important:** S0 (Standard) is the only supported SKU - F0 free tier not available for AIServices.
117 
118See [Detailed Workflow Steps](./references/workflows.md) for complete instructions.
119 
120---
121 
122### 3. Register Resource Provider
123 
124**Command Pattern:** "Register Cognitive Services provider"
125 
126Required when first creating Cognitive Services in subscription or if you get `ResourceProviderNotRegistered` error.
127 
128```bash
129# Register provider (requires Owner/Contributor role)
130az provider register --namespace Microsoft.CognitiveServices
131az provider show --namespace Microsoft.CognitiveServices --query "registrationState"
132```
133 
134If you lack permissions, ask a subscription Owner/Contributor to register it or use `microsoft-foundry:rbac` skill.
135 
136See [Detailed Workflow Steps](./references/workflows.md) for complete instructions.
137 
138---
139 
140## Important Notes
141 
142- **Resource kind must be `AIServices`** for multi-service Foundry resources
143- **SKU must be S0** (Standard) - F0 free tier not available for AIServices
144- Always ask user to choose location - different regions may have varying availability
145 
146---
147 
148## Additional Resources
149 
150- [Common Patterns](./references/patterns.md) - Quick setup patterns and command reference
151- [Troubleshooting](./references/troubleshooting.md) - Common errors and solutions
152- [Azure AI Services documentation](https://learn.microsoft.com/en-us/azure/ai-services/multi-service-resource?pivots=azcli)
153