1# Generate Azure AI Foundry portal URL for a model deployment
2# This script creates a direct clickable link to view a deployment in the Azure AI Foundry portal
3#
4# NOTE: The encoding scheme for the subscription ID portion is proprietary to Azure AI Foundry.
5# This script uses a GUID byte encoding approach, but may need adjustment based on the actual encoding used.
6 
7param(
8    [Parameter(Mandatory=$true)]
9    [string]$SubscriptionId,
10    
11    [Parameter(Mandatory=$true)]
12    [string]$ResourceGroup,
13    
14    [Parameter(Mandatory=$true)]
15    [string]$FoundryResource,
16    
17    [Parameter(Mandatory=$true)]
18    [string]$ProjectName,
19    
20    [Parameter(Mandatory=$true)]
21    [string]$DeploymentName
22)
23 
24function Get-SubscriptionIdEncoded {
25    param([string]$SubscriptionId)
26    
27    # Parse GUID and convert to bytes in string order (big-endian)
28    # Not using ToByteArray() because it uses little-endian format
29    $guidString = $SubscriptionId.Replace('-', '')
30    $bytes = New-Object byte[] 16
31    for ($i = 0; $i -lt 16; $i++) {
32        $bytes[$i] = [Convert]::ToByte($guidString.Substring($i * 2, 2), 16)
33    }
34    
35    # Encode as base64url
36    $base64 = [Convert]::ToBase64String($bytes)
37    $urlSafe = $base64.Replace('+', '-').Replace('/', '_').TrimEnd('=')
38    return $urlSafe
39}
40 
41function Get-FoundryDeploymentUrl {
42    param(
43        [string]$SubscriptionId,
44        [string]$ResourceGroup,
45        [string]$FoundryResource,
46        [string]$ProjectName,
47        [string]$DeploymentName
48    )
49    
50    # Encode subscription ID
51    $encodedSubId = Get-SubscriptionIdEncoded -SubscriptionId $SubscriptionId
52    
53    # Build the encoded resource path
54    # Format: {encoded-sub-id},{resource-group},,{foundry-resource},{project-name}
55    # Note: Two commas between resource-group and foundry-resource
56    $encodedPath = "$encodedSubId,$ResourceGroup,,$FoundryResource,$ProjectName"
57    
58    # Build the full URL
59    $baseUrl = "https://ai.azure.com/nextgen/r/"
60    $deploymentPath = "/build/models/deployments/$DeploymentName/details"
61    
62    return "$baseUrl$encodedPath$deploymentPath"
63}
64 
65# Generate and output the URL
66$url = Get-FoundryDeploymentUrl `
67    -SubscriptionId $SubscriptionId `
68    -ResourceGroup $ResourceGroup `
69    -FoundryResource $FoundryResource `
70    -ProjectName $ProjectName `
71    -DeploymentName $DeploymentName
72 
73Write-Output $url
74