Merge pull request #43 from azure-ai-foundry/feature/infra-templates

Add connections bicep samples

Author: deeikele

.gitignore

@@ -399,3 +399,4 @@ FodyWeavers.xsd
 
 # JetBrains Rider
 *.sln.iml
+use-cases/infrastructure-setup/01-connections/your.deployment.parameters.json

use-cases/infrastructure-as-code/01-connections/README.md

@@ -0,0 +1,5 @@
+# Connections Bicep Examples
+
+Connections enable your AI applications to access tools and objects managed elsewhere in or outside of Azure.
+
+This folder provides a set of examples for the most common connection categories.

use-cases/infrastructure-as-code/01-connections/application-insights.bicep

@@ -1,45 +1,50 @@
 /*
+Connections enable your AI applications to access tools and objects managed elsewhere in or outside of Azure.
+
 This example demonstrates how to add an Azure AI Search connection.
 */
-param aiFoundryName string = 'your-account'
-param aiSearchName string = 'ais-${aiFoundryName}'
+param aiFoundryName string = '<your-account-name>'
+param connectedResourceName string = 'ais-${aiFoundryName}'
+param location string = 'westus'
 
-// whether ai Search is existing or new
+// Whether to create a new Azure AI Search resource
 @allowed([
   'new'
   'existing'
 ])
 param newOrExisting string = 'new'
 
-#disable-next-line BCP081
+// Refers your existing Azure AI Foundry resource
 resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' existing = {
   name: aiFoundryName
   scope: resourceGroup()
 }
 
+// Conditionally refers your existing Azure AI Search resource
 resource existingSearchService 'Microsoft.Search/searchServices@2025-02-01-preview' existing = if (newOrExisting == 'existing') {
-  name: aiSearchName
+  name: connectedResourceName
 }
 
+// Conditionally creates a new Azure AI Search resource
 resource newSearchService 'Microsoft.Search/searchServices@2025-02-01-preview' = if (newOrExisting == 'new') {
-  name: aiSearchName
-  location: 'westus'
+  name: connectedResourceName
+  location: location
   sku: {
     name: 'basic'
   }
   properties: {}
 }
 
-resource project_connection_azureai_search 'Microsoft.CognitiveServices/accounts/connections@2025-04-01-preview' = {
-  name: aiSearchName
+// Creates the Azure Foundry connection to your Azure AI Search resource
+resource connection 'Microsoft.CognitiveServices/accounts/connections@2025-04-01-preview' = {
+  name: '${aiFoundryName}-aisearch'
   parent: aiFoundry
   properties: {
     category: 'CognitiveSearch'
     target: ((newOrExisting == 'new') ? newSearchService.properties.endpoint : existingSearchService.properties.endpoint)
-    authType: 'ApiKey'
-    isSharedToAll: true
+    authType: 'ApiKey' // Supported auth types: ApiKey, AAD
     credentials: { 
-      key: ((newOrExisting == 'new') ? listKeys(newSearchService.id, '2020-06-10').key1 : listKeys(existingSearchService.id, '2020-06-10').key1)
+      key: ((newOrExisting == 'new') ? newSearchService.listAdminKeys().primaryKey : existingSearchService.listAdminKeys().primaryKey)
     }
     metadata: {
       ApiType: 'Azure'