CustomizingAzdParameters.md

December 8, 2025 ยท 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_ENV_COSMOS_LOCATIONstringSame as resource group locationPrimary location for the Cosmos DB instance. When enabling redundancy, verify the region supports zone redundancy. Check supported regions.
AZURE_ENV_COSMOS_SECONDARY_LOCATIONstringcanadacentralSecondary failover location for Cosmos DB when enableRedundancy is true. Check supported regions.
AZURE_ENV_MODEL_DEPLOYMENT_TYPEstringGlobalStandardChange the Model Deployment Type (allowed values: Standard, GlobalStandard).
AZURE_ENV_MODEL_NAMEstringgpt-4o-miniSet the GPT model name (allowed values: gpt-4o).
AZURE_ENV_MODEL_VERSIONstring2025-01-01-previewSet the Azure OpenAI API version (allowed values: 2024-08-06).
AZURE_ENV_MODEL_CAPACITYinteger30Set the model capacity for GPT deployment. Choose based on your Azure quota and usage needs.
AZURE_ENV_EMBEDDING_MODEL_NAMEstringtext-embedding-ada-002Set the model name used for embeddings.
AZURE_ENV_EMBEDDING_MODEL_CAPACITYinteger80Set the capacity for embedding model deployment.
AZURE_ENV_IMAGETAGstringlatest_wafSet the image tag (allowed values: latest_waf, dev, hotfix).
AZURE_LOCATIONstring<User selects during deployment>Sets the Azure region for resource deployment.
AZURE_ENV_LOG_ANALYTICS_WORKSPACE_IDstringGuide to get your Existing Workspace IDReuses an existing Log Analytics Workspace instead of provisioning a new one.
AZURE_EXISTING_AI_PROJECT_RESOURCE_IDstring<Existing AI Foundry Project Resource Id>Reuses an existing AI Foundry Project Resource Id instead of provisioning a new one.

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>

Example:

azd env set AZURE_LOCATION westus2