Add APIM resource private endpoint (#285)

* apim resource

* made arm changes

* fix variable

* fix template

* revert unnecesary changes

* Fix high priority issues: parameter consistency and README documentation

- Fixed parameter inconsistency between Bicep and JSON templates
- Replaced separate apiManagementName, apiManagementResourceGroupName, apiManagementSubscriptionId parameters with single apiManagementResourceId parameter
- Updated README.md with comprehensive API Management documentation
- Added API Management to template customization section
- Added API Management to private endpoints documentation
- Added API Management to Private DNS Zones table
- Maintains consistency with other resource parameter patterns

* new folder for apim preview

* Update README.md

---------

Co-authored-by: vtomar <[email protected]>

Author: Vijendra123

samples/microsoft/infrastructure-setup/16-private-network-standard-agent-apim-setup-preview/README.md

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
+  "contentVersion": "1.0.0.0",
+  "parameters": {
+    "location": {
+      "value": "eastus2"
+    },
+    "aiServices": {
+      "value": ""
+    },
+    "modelName": {
+      "value": ""
+    },
+    "modelFormat": {
+      "value": ""
+    },
+    "modelVersion": {
+      "value": ""
+    },
+    "modelSkuName": {
+      "value": ""
+    },
+    "modelCapacity": {
+      "value": 0
+    },
+    "deploymentTimestamp": {
+      "value": ""
+    },
+    "firstProjectName": {
+      "value": ""
+    },
+    "projectDescription": {
+      "value": ""
+    },
+    "displayName": {
+      "value": ""
+    },
+    "vnetName": {
+      "value": ""
+    },
+    "agentSubnetName": {
+      "value": ""
+    },
+    "peSubnetName": {
+      "value": ""
+    },
+    "existingVnetResourceId": {
+      "value": ""
+    },
+    "vnetAddressPrefix": {
+      "value": ""
+    },
+    "agentSubnetPrefix": {
+      "value": ""
+    },
+    "peSubnetPrefix": {
+      "value": ""
+    },
+    "aiSearchResourceId": {
+      "value": ""
+    },
+    "azureStorageAccountResourceId": {
+      "value": ""
+    },
+    "azureCosmosDBAccountResourceId": {
+      "value": ""
+    },
+    "projectCapHost": {
+      "value": ""
+    },
+    "apiManagementResourceId": {
+      "value": ""
+    },
+    "existingDnsZones": {
+      "value": {
+        "privatelink.services.ai.azure.com": "",
+        "privatelink.openai.azure.com": "",
+        "privatelink.cognitiveservices.azure.com": "",
+        "privatelink.search.windows.net": "",
+        "privatelink.blob.core.windows.net": "",
+        "privatelink.documents.azure.com": "",
+        "privatelink.azure-api.net": ""
+      }
+    }
+  }
+}

samples/microsoft/infrastructure-setup/16-private-network-standard-agent-apim-setup-preview/azuredeploy.json

@@ -0,0 +1,100 @@
+#!/bin/bash
+
+# Script to delete the capability host
+
+# Prompt for required information
+read -p "Enter Subscription ID: " subscription_id
+read -p "Enter Resource Group name: " resource_group
+read -p "Enter Foundry Account or Project name: " account_name
+read -p "Enter CapabilityHost name: " caphost_name
+
+# Get Azure access token
+echo "Getting Azure access token..."
+access_token=$(az account get-access-token --query accessToken -o tsv)
+
+if [ -z "$access_token" ]; then
+    echo "Error: Failed to get access token. Please make sure you're logged in with 'az login'"
+    exit 1
+fi
+
+# Construct the API URL
+api_url="https://management.azure.com/subscriptions/${subscription_id}/resourceGroups/${resource_group}/providers/Microsoft.CognitiveServices/accounts/${account_name}/capabilityHosts/${caphost_name}?api-version=2025-04-01-preview"
+
+echo "Deleting capability host: ${caphost_name}"
+echo "API URL: ${api_url}"
+ 
+# Send DELETE request and capture headers
+echo "Sending DELETE request..."
+response_headers=$(mktemp)
+curl -X DELETE \
+     -H "Authorization: Bearer ${access_token}" \
+     -H "Content-Type: application/json" \
+     -D "${response_headers}" \
+     -s \
+     "${api_url}"
+     
+# Check if the curl command was successful
+if [ $? -ne 0 ]; then
+    echo -e "\nError: Failed to send deletion request."
+    rm -f "${response_headers}"
+    exit 1
+fi
+
+# Extract the Azure-AsyncOperation URL from the response headers
+operation_url=$(grep -i "Azure-AsyncOperation" "${response_headers}" | cut -d' ' -f2 | tr -d '\r')
+
+if [ -z "${operation_url}" ]; then
+    echo -e "\nError: Could not find operation URL in the response."
+    cat "${response_headers}"
+    rm -f "${response_headers}"
+    exit 1
+fi
+
+rm -f "${response_headers}"
+
+echo -e "\nCapability host deletion request initiated."
+echo "Monitoring operation: ${operation_url}"
+
+# Poll the operation URL until the operation completes
+status="Creating"
+while [ "${status}" = "Creating" ]; do
+    echo "Checking operation status..."
+    access_token=$(az account get-access-token --query accessToken -o tsv)
+    # Get the operation status
+    operation_response=$(curl -s \
+        -H "Authorization: Bearer ${access_token}" \
+        -H "Content-Type: application/json" \
+        "${operation_url}")
+
+    # Check for transient errors
+    error_code=$(echo "${operation_response}" | jq -r '.error.code // empty')
+    if [ "${error_code}" = "TransientError" ]; then
+        echo "Transient error encountered. Continuing to poll..."
+        sleep 10
+        continue
+    fi
+    # Extract the status from the response using jq
+    status=$(echo "${operation_response}" | jq -r '.status')
+
+    if [ -z "${status}" ]; then
+        echo "Error: Could not determine operation status."
+        echo "Response: ${operation_response}"
+        exit 1
+    fi
+
+    echo "Current status: ${status}"
+
+    if [ "${status}" = "Creating" ]; then
+        echo "Operation still in progress. Waiting 10 seconds before checking again..."
+        sleep 10
+    fi
+done
+
+# Check the final status
+if [ "${status}" = "Succeeded" ]; then
+    echo -e "\nCapability host deletion completed successfully."
+else
+    echo -e "\nCapability host deletion failed with status: ${status}"
+    echo "Response: ${operation_response}"
+    exit 1
+fi