Merge pull request #7585 from deeikele/terraform-samples

add azurerm samples

Author: JamesJBarnett

articles/ai-foundry/how-to/create-resource-terraform.md

@@ -15,21 +15,23 @@ ai-usage: ai-assisted
 #customer intent: As a Terraform user, I want to see how to configure Azure AI Foundry using Terraform, so I can automate my setup.
 ---
 
-# Use Terraform to create Azure AI Foundry resource
+# Use Terraform to manage Azure AI Foundry resources
 
-In this article, you use Terraform to create an [Azure AI Foundry](https://ai.azure.com/?cid=learnDocs) resource. You learn how to use Terraform to create AI Foundry management configurations including projects, deployments, and connections. 
+In this article, you use Terraform to manage an [Azure AI Foundry](https://ai.azure.com/?cid=learnDocs) resource. You learn how to use Terraform to manage AI Foundry management configurations including projects, deployments, and connections. 
 
-The examples used in article use the [AzAPI](/azure/developer/terraform/overview-azapi-provider) Terraform provider. Similar [AzureRM](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/ai_services) provider support is available via the classic `AzureRM_AIServices` module (using the `aiservices` kind as its value), but is limited in functionality to resource and deployment creation.
+You can use either the Terraform [AzAPI Provider](/azure/developer/terraform/overview-azapi-provider) or [AzureRM Provider](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/cognitive_account) to manage Azure AI Foundry resources. While the AzAPI provider lets you access all Foundry control plane configurations including preview features, the AzureRM variant is limited to core management capabilities:
+
+|Action|AzAPI Provider|AzureRM Provider|
+| --- | --- | --- |
+| Create a resource group | ✅ | ✅ |
+| Create an AI Foundry resource | ✅ | ✅ |
+| Configure deployments | ✅ | ✅ |
+| Configure projects | ✅ | - |
+| Configure a connection to knowledge and tools | ✅ | - |
+| Configure a capability host (for advanced tool configurations like [Agent standard setup](../agents/concepts/capability-hosts.md)) | ✅ | - |
 
-[!INCLUDE [About Terraform](~/azure-dev-docs-pr/articles/terraform/includes/abstract.md)]
 
-> [!div class="checklist"]
-> * Create a resource group
-> * Create an AI Foundry resource.
-> * Configure projects.
-> * Configure deployments.
-> * Configure a connection to other resources.
-> * Configure capability host to bring your own storage with Agent service.
+[!INCLUDE [About Terraform](~/azure-dev-docs-pr/articles/terraform/includes/abstract.md)]
 
 ## Prerequisites
 
@@ -39,10 +41,7 @@ The examples used in article use the [AzAPI](/azure/developer/terraform/overview
 
 ## Implement a basic AI Foundry configuration using Terraform code
 
-> [!NOTE]
-> The sample code for this article is located in the [Azure Terraform GitHub repo](https://github.com/Azure/terraform/tree/master/quickstart/101-azure-ai-foundry). You can view the log file containing the [test results from current and previous versions of Terraform](https://github.com/Azure/terraform/tree/master/quickstart/101-azure-ai-foundry/TestRecord.md). You may need to update the resource provider versions used in the template to use the latest available versions.
-> 
-> See more [articles and sample code showing how to use Terraform to manage Azure resources](/azure/terraform)
+# [AzAPI Provider](#tab/azapi)
 
 1. Create a directory in which to test and run the sample Terraform code and make it the current directory.
 
@@ -58,6 +57,24 @@ The examples used in article use the [AzAPI](/azure/developer/terraform/overview
 
     :::code language="Terraform" source="~/foundry-samples-main/samples/microsoft/infrastructure-setup-terraform/00-basic/code/variables.tf"::: 
 
+# [AzureRM Provider](#tab/azurerm)
+
+1. Create a directory in which to test and run the sample Terraform code and make it the current directory.
+
+1. Create a file named `providers.tf` and insert the following code.
+
+    :::code language="Terraform" source="~/foundry-samples-main/samples/microsoft/infrastructure-setup-terraform/00-basic-azurerm/code/providers.tf":::
+
+1. Create a file named `main.tf` and insert the following code.
+
+    :::code language="Terraform" source="~/foundry-samples-main/samples/microsoft/infrastructure-setup-terraform/00-basic-azurerm/code/main.tf":::
+
+1. Create a file named `variables.tf` and insert the following code.
+
+    :::code language="Terraform" source="~/foundry-samples-main/samples/microsoft/infrastructure-setup-terraform/00-basic-azurerm/code/variables.tf"::: 
+
+---
+
 ## Initialize Terraform
 
 [!INCLUDE [terraform-init.md](~/azure-dev-docs-pr/articles/terraform/includes/terraform-init.md)]
@@ -87,5 +104,8 @@ See the [Azure AI Foundry Samples](https://github.com/azure-ai-foundry/foundry-s
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [See more articles about Azure AI Foundry hub](/search/?terms=Azure%20ai%20hub%20and%20terraform)
+> [See AzureRM reference docs for Azure AI Foundry](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/cognitive_account)
+> [Terraform Azure Verified Module sample](https://github.com/Azure/terraform-azurerm-avm-res-cognitiveservices-account)
+> [Learn more about AzAPI provider](/azure/developer/terraform/overview-azapi-provider)
+