CustomizingAzdParameters.md

July 14, 2026 ยท View on GitHub

[Optional]: Customizing resource names

By default this template will use the environment name as the prefix to prevent naming collisions within Azure. The parameters below show the default values. You only need to run the statements below if you need to change the values.

To override any of the parameters, run azd env set <PARAMETER_NAME> <VALUE> before running azd up. On the first azd command, it will prompt you for the environment name. Be sure to choose 3-20 characters alphanumeric unique name.

Parameters

NameTypeDefault ValuePurpose
AZURE_ENV_NAMEstringazdtempUsed as a prefix for all resource names to ensure uniqueness across environments.
AZURE_LOCATIONstring<User selects during deployment>Location of the Azure resources. Controls where the infrastructure will be deployed.
AZURE_ENV_AI_SERVICE_LOCATIONstring<User selects during deployment>Location of the Azure resources. Controls where the Azure AI Services will be deployed.
AZURE_ENV_MODEL_DEPLOYMENT_TYPEstringGlobalStandardChange the Model Deployment Type (allowed values: Standard, GlobalStandard).
AZURE_ENV_GPT_MODEL_NAMEstringgpt-5.1Set the Model Name (default: gpt-5.1).
AZURE_ENV_GPT_MODEL_VERSIONstring2025-11-13Set the Azure model version (allowed values: 2025-11-13)
AZURE_ENV_GPT_MODEL_CAPACITYinteger150Set the Model Capacity (choose a number based on available GPT model capacity in your subscription).
AZURE_ENV_EXISTING_LOG_ANALYTICS_WORKSPACE_RIDstringGuide to get your Existing Workspace IDSet this if you want to reuse an existing Log Analytics Workspace instead of creating a new one.
AZURE_ENV_IMAGE_TAGstringlatestTag applied to the backend/frontend images that are built remotely and pushed to the deployment's Azure Container Registry.
AZURE_ENV_VM_SIZEstringStandard_D2s_v5Specifies the size of the Jumpbox Virtual Machine (e.g., Standard_D2s_v5, Standard_D2s_v4). Set a custom value if enablePrivateNetworking is true.
AZURE_ENV_JUMPBOX_ADMIN_USERNAMEstringJumpboxAdminUserSpecifies the administrator username for the Jumpbox Virtual Machine.
AZURE_ENV_JUMPBOX_ADMIN_PASSWORDstringJumpboxAdminP@ssw0rd1234!Specifies the administrator password for the Jumpbox Virtual Machine.
AZURE_ENV_COSMOS_SECONDARY_LOCATIONstring(not set by default)Specifies the secondary region for Cosmos DB. Required if enableRedundancy is true.
AZURE_EXISTING_AIPROJECT_RESOURCE_IDstring(not set by default)Specifies the existing AI Foundry Project Resource ID if it needs to be reused.

How to Set a Parameter

To customize any of the above values, run the following command before azd up:

azd env set <PARAMETER_NAME> <VALUE>

Set the Log Analytics Workspace Id if you need to reuse the existing workspace

azd env set AZURE_ENV_EXISTING_LOG_ANALYTICS_WORKSPACE_RID '/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.OperationalInsights/workspaces/<workspace-name>'

Set the Azure Existing AI Foundry Project Resource ID if you need to reuse the existing AI Foundry Project

azd env set AZURE_EXISTING_AIPROJECT_RESOURCE_ID '/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.CognitiveServices/accounts/<account-name>/projects/<project-name>'

Example:

azd env set AZURE_LOCATION westus2