Bicep CLI: baixar versions anteriors

Features and Bug fixes
- Emit GA language version for NullableExisting and ThisNamespace (#20258)
- Make apiVersion optional in the Azure resource schema MCP tool (#20292)
- Fix diagnostic locations for inherited .bicepparam values (#20085)
- Refine docs command configuration and error handling (#20269)
- Add trusted cloud configuration (#20294)
- Custom clouds that aren't in the built-in list must now be allowed through the BICEP_TRUSTED_CLOUDS environment variable, the same way trusted registries work:
[{"resourceManagerEndpoint":"https://management.example.com","activeDirectoryAuthority":"https://login.example.com"}]
- Visualizer: improved resource discovery and creation (#20340)
- Separate resource-creation dock, better browsing and filtering, and API version selection that takes the deployment scope into account
- Fills in required resource properties and shows related diagnostics on the graph
- Common resource providers listed first when browsing
- Visualizer: undo/redo (#20356)
- Undo and redo resource creation, node moves, and Reset Layout with Ctrl/Cmd+Z, Ctrl/Cmd+Shift+Z, or Ctrl+Y
- Simpler communication between the visualizer and VS Code, and simpler visualizer internals
Community contributions
- fix: skip secure params lint for type aliases (#19796) - Thanks @nanookclaw!
- fix: description decorator placement for type properties (#20185) - Thanks @johnlokerse!
- Update image and contributing.md paths in mcp-tools.md (#20283) - Thanks @johnlokerse!
- Fix blockquote formatting in resource and module hovers (#20281) - Thanks @simon-jensenz!
- Refresh setup, testing, and debugging instructions in CONTRIBUTING.md (#20285) - Thanks @simon-jensenz!
- Add -NoProfile in the call to PowerShell.exe in the installer (#20296) - Thanks @kilasuit!
- Fix bicep test exit code on compilation errors (#20305) - Thanks @pathei-kosmos!
Full Changelog: Comparing v0.47.16...v0.48.1 · Azure/bicep

Highlights
[Experimenta] Bicep module documentation generation (#20183)
Adds the experimental bicep docs generate command, which renders module documentation to a Markdown file. Formatting can be customized using a Scriban template.
# Generate README.md beside one module
bicep docs generate .\main.bicep

# Render one module to stdout
bicep docs generate .\main.bicep --stdout

# Generate documentation for matched modules
bicep docs generate --pattern '.\modules\**\main.bicep'
See https://github.com/Azure/bicep/blob/main/docs/experimental/docs-commands.md for more details.
Bicep Configuration Inheritance (#20176, #20181, #20198)
This feature adds an extends property to bicepconfig.json, letting a config inherit from another config file and override only the settings it needs to change. Everything not explicitly overridden falls through from the base config.
Example: a company-wide bicepconfig.corp.json sets strict linter rules for everyone. This team's config inherits the base's no-unused-params rule as-is, while overriding no-hardcoded-env-urls from warning to error.
// /shared/bicepconfig.base.json (shared org-wide base config)
{
"analyzers": {
"core": {
"rules": {
"no-hardcoded-env-urls": { "level": "warning" },
"no-unused-params": { "level": "warning" }
}
}
}
}
// /team/bicepconfig.json (this team's leaf config -- extends the shared base)
{
"extends": "../shared/bicepconfig.base.json",
"analyzers": {
"core": {
"rules": {
"no-hardcoded-env-urls": { "level": "error" }
}
}
}
}
// Effective (merged) result for this team:
{
"analyzers": {
"core": {
"rules": {
"no-hardcoded-env-urls": { "level": "error" }, // overridden by leaf
"no-unused-params": { "level": "warning" } // inherited from base, untouched
}
}
}
}
Bicep Playground interface redesign (#20225)
Main Changes:
- Redesign the Bicep Playground with a responsive islands-style interface and native, accessible controls
- Moved Bicep WASM compilation to a web worker to prevent the UI from freezing during compilation
- Add compilation freshness, diagnostics, ARM output actions, light/dark themes, and in-place sample loading
- Fix a regression for ARM template decompilation
Try out the new Bicep Playground and see it in action.
New linter rules to enforce descriptions (#20036)
Thanks @johnlokerse for implementing this!
The following linter rules are defaulted to off, but can be enabled, to flag missing or empty @description decorators.
- use-description-params - flag missing or empty descriptions on parameters
- use-description-vars - flag missing or empty descriptions on variables
- use-description-outputs - flag missing or empty descriptions on outputs
- use-description-types - flag missing or empty descriptions on type declarations
- use-description-type-properties - flag missing or empty descriptions on type properties
Performance improvements
We optimized the startup path of the Bicep CLI to significantly reduce cold-start times and address a performance regression introduced by the move to .NET 10. The optimization includes enabling ReadyToRun (R2R) to reduce startup overhead, making common CLI operations more responsive, particularly in automation and short-lived execution scenarios. To preserve the existing distribution footprint, we also enabled single-file compression, keeping the binary size roughly unchanged from previous releases while delivering faster startup performance. (#20255)
Other improvements to VSCode extension responsiveness & CLI compilation speed:
- Avoid re-initializing ApiVersionProvider on multiple requests (#20133)
- Cache regex pattern validation results (#20143)
- Cache configuration source directories (#20146)
- Ensure Configuration and Features are cached in SemanticModel (#20152)
Features and Bug Fixes
- Fix Bicep console rendering for wrapped input (#20154)
- Fix resource ID imports in parameter files (#20142)
- Add "placement" top-level property to fallback Az resource type (#20172)
- Fix scalar YAML aliases in loadYamlContent (#20151)
- Add R

Highlights
- New no-unused-types linter rule to warn on unused type declarations (#20035)
Example:
type usedType = {
name: string
}

type unusedType = string // Warning: Type "unusedType" is declared but never used.

param person usedType
output personName string = person.name
- [Experimental] Runtime values in tags and sku (#20059)
A new experimental feature that allows runtime values to be used in tags and sku properties — useful for preserving existing values during redeployment.
Example usage:
resource example 'Microsoft...' = {
name: 'example'
location: resourceGroup().location
sku: {
name: this.existingResource().?sku.name ?? 'Standard'
}
tags: this.existingResource().?tags ?? {}
}
Features and Bug fixes
- Restore YAML alias and anchor handling behavior (#20070)
- Fix concurrency issue in RPC Client (#20071)
- Fix brm startup crash caused by verbose option alias parsing (#20069)
- Fix external inputs breaking base parameter spreads (#20062)
- Validate deployment-context functions in parameter file imports (#20063)
- Only return list-prefixed functions in Az types (#20106)
- Harden webview not-found pages against HTML injection (#20108)
- Use public JSONRPC client for e2e tests (#20080)
- Bump System.Security.Cryptography.Xml (#20101)
- Harden webview not-found pages against HTML injection (#20108)
Community contributions
- Revise grpcurl and grpcui installation methods (#20061) - Thanks @samirbanjanovic!

Features and bug fixes
- Fix Bicep exports regression - Reverted a change to block exporting variables or functions that reference deployment-context functions (#20056)
- Remove ISourceFile Uri (#20037)
- Rename test fixtures project to testing (#20038)
- Clarify ARM resources in README FAQ (#20034).

Highlights
- [Experimental] OCI registry support for Bicep extension publishing (#18956, #20032)
Publishing to non-ACR registries is now supported with the ociEnabled experimental feature enabled. Full documentation available here.
Example usage - publishing a module to GitHub Container Registry:
bicep publish ./main.bicep --target br:ghcr.io/myorg/modules/storage:v1
Example usage - consuming a module from GitHub Container Registry:
module storage 'br:ghcr.io/myorg/modules/storage:v1' = {
params: {
// ...
}
}
- @retryOn decorator is now GA! (#19988)
Use the @retryOn decorator to retry a resource deployment if the deployment hits a specific error code. You can also specify how many times this retry should happen.
Example usage:
@retryOn(['ServerError'], 1)
resource sqlServer 'Microsoft.Sql/servers@2021-11-01' = {
name: 'sql-server-name'
location: 'polandcentral'
}
- [Bicep console] Add line navigation features, and undo+redo handling (#19992, #19996)
Demo Video
- Inherited parameters are now optional in extended parameters files (#19698)
Example usage:
- shared.bicepparam
using none

// These 3 parameters are permitted, even though they're unused in main.bicep
param location = 'switzerlandnorth'
param customerId = '12345'
param namePrefix = 'contoso'
- main.bicepparam
using './main.bicep'
extends './shared.bicepparam'

param rgName = '${base.namePrefix}-infra'
- main.bicep
param rgName string
- Publish the language server as a NuGet dotnet tool (#19976)
It's now possible to run the Bicep Language Server with the following command:
dnx -y Azure.Bicep.LangServer
- Add secure-params-in-parameters-file linter rule (#20021)
The following usage pattern will be flagged:
// main.bicep
@secure()
param secureParam string
param insecureParam string
// main.bicepparam
using 'main.bicep'
param secureParam = 'MYSECRET'
param insecureParam = secureParam // <-- now flagged (Warning)
- Add no-hardcoded-outputs linter rule (defaults to "off") (#19994)
The following usage pattern will be flagged:
output apiVersion string = '2024-01-01'
And given an automatic fix:
@export()
var apiVersion = '2024-01-01'
- Bicep RPC Client: Implement pooled client factory (#19886)
Instead of creating a new Bicep client for each call to Initialize, this factory manages a pool of clients with multiplexed connections, making it more efficient for use across multiple threads.
Example usage:
using var factory = new PooledBicepClientFactory();

using var bicep = await factory.Initialize(new() {
BicepVersion = "0.45.6"
});
Features and Bug Fixes
- Show version-specific docs links on resource hovers (#20016)
- Display nested operations in local deploy CLI (#19974)
- Display nested errors in local deploy (#19983)
- Make REPL load-function output locale-invariant for numeric values (#19752)
- Handle invalid json parameters files in the deployment pane (#19838)
- Improve inline type property decorator completion logic and add tests (#19174)
- Fix build-params crash for inherited object params in extended bicepparam files (#19895)
- Fix discriminated union IntelliSense for root-level params in .bicepparam files (#19987)
- Validate instance function call placement (#19980)
- Fix description not showing for template spec module (#20026)
- Fix force restore command to show picklist if active file is not a bicep file or no file is open (#20029)
- Emit warning comment when parameter names are renamed during decompilation (#19977)
- any? property and parameter incorrectly marked as required (#19990)
- Add '=' completion after module path string (Ctrl+Space) (#20022)
- Add warning when decompiling a bicep generated ARM template (#20028)
- Fix nested resource reference completions (#20017)
- Fix invalid rename location errors (#20015)
- Fix resource methods on aliased collection elements (#20019)
- Fix Bicep playground WASM file handling (#20023)
- Fix escape sequence semantic highlighting (#19975)
- Block non-pure functions in exported declarations (#20025)
- Replace BCP Error with W

Highlights
- Extendable Params are now GA! (#19697)
Extendable Bicep Parameter Files (enabled with the extend keyword) allows you to reuse parameters from one .bicepparam file in another .bicepparam file.
root.bicepparam This is your main bicepparam file, which can be reused by multiple extended .bicepparam files and in multiple deployments.
using none
// Notice that the first line of this .bicepparam file declares `using none` which tells the compiler not to validate this against any particular .bicep file.

param namePrefix = 'Prod'
leaf.bicepparam This is your extended bicepparam file, which will refer to one main.bicep file and one main .bicepparam file. Any parameter value in this file will override all previous values.
using 'main.bicep'

extends 'root.bicepparam'

param namePrefix = 'Dev' // this will override the 'Prod' value we assign in our root.bicepparam file
- ThisNamespace and NullIfNotFound are now GA! (#19639)
When applied to an existing resource, using the @nullIfNotFound() decorator for existing resources will return null if it doesn't exist at deployment time instead of failing.
@nullIfNotFound()
resource exampleResource 'Microsoft.Storage/storageAccounts@2021-04-01' existing = {
name: 'test'
}
For 'ThisNamespace': this.exists() returns a bool indicating the existence of the current resource. this.existingResource() returns null if the resource does not exist and returns the full resource if the resource exists.
resource usingThis 'Microsoft...' = {
name: 'example'
location: 'eastus'
properties: {
property1: this.exists() ? 'resource exists' : 'resource does not exist'
property2: this.existingResource().?properties.?property2
property3: this.existingResource().?tags
}
}
Features and Bug Fixes
- Remove old Cytoscape.js visualizer (#19747)
- Migrate to System.CommandLine library for CLI commands for enhanced discoverability (#19312)
- Trim mcp tools returned resource schema (#19645)
- fix vs code generate params json output path (#19755)
- Fix BCP120 on extension Required+DTC identifier properties (#19637)
Diagnostics and Tests
- Add diagnostics and tests for spread operator limitations with for-expressions (#19516)
- Add snapshot regression test for roleDefinitions (#19638)
- add getSecret parameter reference regression coverage (#19714)
- add regression coverage for bicepparam completions (#19703)

Features and Bug Fixes
- Reverted the retryOn decorator to an experimental feature flag (#19604)
- The retryOn experimental flag was removed in the previous release, but the feature is not yet enabled in template language version 2.0. This could cause validation errors during deployment for users relying on retryOn. This release restores the feature flag as a temporary workaround while backend support for template language version 2.0 is being rolled out.
- Added build_bicep and build_bicepparam tools to the MCP server (#19602)

Highlights
- @retryOn decorator is now GA! (#19454)
Use the @retryOn decorator to retry a resource deployment if the deployment hits a specific error code. You can also specify how many times this retry should happen.
Example usage:
@retryOn(['ServerError'], 1)
resource sqlServer 'Microsoft.Sql/servers@2021-11-01' = {
name: 'sql-server-name'
location: 'polandcentral'
}
- New like() and distinct() functions (#18990, #19167)
Example usage:
// outputs true if myInput contains 'Bar'
output wildcardMatch bool = like(myInput, '*Bar*')

// outputs [1, 2, 3]
output values string[] = distinct([1, 2, 2, 3, 1])
- Add use-recognized-resource-type linter rule to warn for unrecognized resource types in reference/list* functions (#19303)
The following code will emit a warning because 'Microsoft.Foo/bar' is not a recognized resource type:
output foo object = reference('Microsoft.Foo/bar', '2020-01-01')
- Add no-module-name linter rule to enforce omitting explicit module names (optional - off by default) (#19556)
The following code will emit a warning if enabled, because the module name property is no longer needed:
module foo 'foo.bicep' = {
name: 'foo'
params: { ... }
}
Features and Bug Fixes
- [BREAKING CHANGE] Block usage of custom domains for ACR (#19564)
- Bicep snapshot CLI commands:
- Include predicted outputs (#19379)
- Support management group id parameter (#19378)
- Deploy command: Allow location for non-RG scope deployments (#19330)
- Add description to module name property for improved IntelliSense (#19310)
- Fix duplicate errors for undefined types on resources (#19273)
- Bicepparam Improvements:
- Add missing import and extension top-level completions in .bicepparam files (#19448)
- extendable param files intellisense for shared bicepparam files (#19061)
- enable build-params evaluation of for-expressions in .bicepparam (#18949)
- MCP Server Improvements:
- Convert MCP GetAzResourceTypeSchema output to standard JSON Schema format (#19388)
- Extract Azure.Bicep.McpServer.Core library to enable building custom remote MCP servers (#19499)
- Add MCP Tools to support Extension Resource Types (#19453)
- Allow expressions in getSecret function (#19204)
- Theme vscode-elements widgets in visualizer ExportToolbar (#19557)
Community Contributions
- Update waitUntil feature description in docs (#19560) - thanks @brianveldman !
- Fix resource manager: Add condition for opened PRs from dependabot (#19311) - thanks @DragosDanielBoia !

Highlights
- Bicep console GA! (#19261)
- Bicep Role Definitions Function (#18457)
properties: {
roleDefinitionId:
roleDefinitions('Data Factory Contributor').id
principalId: scriptIdentity.principalId
}
Features and Bug Fixes
Experimental Visualizer
An experimental version of the Bicep visualizer was added, which can run side-by-side with the existing one. The new visualizer includes several improvements:
- Improved UI styling
- Accessibility enhancements: accent color support and a light high-contrast theme
- New feature: export the graph as a PNG image (see screenshot below)
To use the new visualizer, right-click the editor tab and select Open Bicep Visual Designer (Experimental) or Open Bicep Visual Designer to the Side (Experimental):
The existing visualizer will be deprecated and removed after two release cycles.
Other
- Enhance error messages for ArgumentException (#19208)
- External input bug fixes (#19256)
- Don't crash when nonexistent symbol is used with external inputs (#19260)
- Don't crash on error symbol external input parameters (#19263)
- Update active pseudo-grammar of the bicep language (#19169)
- Added the grace period to delay recommending the latest API version (#19205)
- RpcClient: Various improvements for safety + ux (#19203)
- Add more info about JSONRPC (#19277)
- Fix generate-params JSON defaults (#19265)
- Fix playground quickstart module handling and Monaco worker init (#19264)

Highlights
- Snapshot command is GA (#19084)
Example usage:
# capture a snapshot
bicep snapshot main.bicepparam

# validate a snapshot
bicep snapshot main.bicepparam --mode validate

# capture a snapshot with Azure context
bicep snapshot main.bicepparam --subscription-id 3faf6056-8474-4818-a729-1aff55d6b3fa --resource-group myRg --location westus --mode overwrite
Walkthrough YouTube - Bicep Snapshot Demo
Official docs coming soon. In the meantime, see Using the snapshot command.
- [Experimental] @nullIfNotFound() decorator for existing resources (#18697)
Basic example:
@nullIfNotFound()
resource storageAccount 'Microsoft.Storage/storageAccounts@2021-04-01' existing = {
name: 'testStorage'
}

output safeLocation string? = storageAccount.?location
output safeSkuName string? = storageAccount.?sku.name
output safeAccessTier string? = storageAccount.?properties.accessTier

output locationWithDefault string = storageAccount.?location ?? 'westus'
output skuNameWithDefault string = storageAccount.?sku.name ?? 'Standard_LRS'
output accessTierWithDefault string = storageAccount.?properties.accessTier ?? 'Hot'
Bug Fixes and Features
- Add MCP server metadata JSON file to NuGet package (#18909)
- Add section on comments to Best Practices doc (#18913)
- Fix nested extendable params spread: ensure inherited spread expressions are bound correctly (#19028)
- add support for array splat completion in type syntax and enhance completion context (#18948)
- Add completions for #disable-diagnostics and #restore-diagnostics (#18919)
- Add extension namespace functions (#18910)
- [PublishExtension command] Ensure namespace functions are considered when building types archive (#18999)
- Use file handle URI in output (#18920)
- [Experimental] Visualizer V2 (#18986, #18987, #18992, #18995, #19025, #19029, #19080)
Community Contributions
- Minor typos in README.md (#19079) - thanks @gerbermarco !
- Enhance snapshot command documentation (#18959) - thanks @verschaevesiebe !
- Add snapshot command help documentation to RootCommand (#18988) - thanks @verschaevesiebe !

Highlights
- Multi-line interpolated strings GA! (#18666)
Basic example:
var s = $'''
this is ${interpolated}'''
With multiple $ characters:
var s = $$'''
this is $${interpolated}
this is not ${interpolated}'''
- [Experimental] New this.exists() and this.existingResource() functions for resource existence checks (#17727)
Example usage:
resource storageAccount 'Microsoft.Storage/storageAccounts@2021-09-01' = {
name: 'mystorageaccount'
location: 'eastus'
sku: {
name: 'Standard_LRS'
}
kind: 'StorageV2'
properties: {
minimumTlsVersion: 'TLS1_2'
publicNetworkAccess: this.exists() ? 'Enabled' : 'Disabled'
}
}
- New MCP Server tools (#18707, #18826)
- decompile_arm_parameters_file: Converts ARM template parameter JSON files into Bicep parameters format (.bicepparam).
- decompile_arm_template_file: Converts ARM template JSON files into Bicep syntax (.bicep).
- format_bicep_file: Applies consistent formatting (indentation, spacing, line breaks) to Bicep files.
- get_bicep_file_diagnostics: Analyzes a Bicep file and returns all compilation diagnostics.
- get_file_references: Analyzes a Bicep file and returns a list of all referenced files including modules, parameter files, and other dependencies.
- get_deployment_snapshot: Creates a deployment snapshot from a .bicepparam file by compiling and pre-expanding the ARM template, allowing you to preview predicted resources and perform semantic diffs between Bicep implementations.
- Publish Bicep MCP server as a nuget package (#18709)
Example mcp.json configuration:
{
"servers": {
"Bicep": {
"type": "stdio",
"command": "dnx",
"args": [ "Azure.Bicep.McpServer", "--yes" ]
}
}
}
- bicep console: Support piping and stdin/out redirection (#18762)
Example with piping:
echo "parseCidr('10.144.0.0/20')" | bicep console
Example with input redirection:
echo "parseCidr('10.144.0.0/20')" > test.txt
bicep console < test.txt
Example with output redirection:
echo "parseCidr('10.144.0.0/20')" | bicep console > output.json
- Extendable Parameter Files Improvements:
- Enable parameter files to evaluate variables from extended base parameters (#18626)
- Add support for loadTextContent function in extendable parameter files (#18424)
- Multiline diagnostic pragmas (#18622)
Disable a specific diagnostic for a whole file:
#disable-diagnostics BCP422

...

resource foo 'type@version' = if (condition) {}

output bar string = foo.properties.bar // <-- would normally raise BCP422 as a warning, but will not due to pragma at top of file
Disable specific diagnostics for a span:
resource foo 'type@version' = if (condition) {}

#disable-diagnostics BCP422
output bar string = foo.properties.bar // <-- would normally raise BCP422 as a warning, but will not due to pragma at top of file
#restore-diagnostics BCP422

output baz string = foo.properties.baz // <-- will raise BCP422 warning because it's outside of the pragma fence
- Migrate to .NET 10 (#18458)
Bug Fixes and Features
- Use integer and boolean literal types when deriving return type for loadJsonContent (#18466)
- Update deployment() return type signature to add conditional metadata property (#18468)
- Recognize <collection module>[<index>]! as a direct module reference for secure outputs check (#18522)
- Extension config default values constraint fixes (#18606)
- Update lv 2.0 triggers to take syntactically nested resources into account (#18607)
- Making the scope property a fully qualified resource Id (#18165)
- Expand support for types in local extension (#18662)
- Improved extension configuration experience (#18828)
- Fix handling registry module resource derived types in params file (#18661)
- Fix completion to correctly suggest imported types in bicepparam files (#18523)
- Fix quoted property names and enhance symbol resolution (#18509)
- Fix nested function calls losing bindings when using extendable parameters (#18876)
- Always use named pipes on Windows for gRPC (#18712)
- Remove DSC experimental feature (#18821)
- Simplify YAML/JSON parser code path with Resu

Highlights
- [Experimental] Enhancements to bicep console command:
- Support load* functions (#18413)
- Support types & functions (#18261)
- Improve line break handling (#18320)
- [Requires the multilineStringInterpolation Experimental feature] New syntax for multi-line string interpolation (#18324)
Basic example:
var s = $'''
this is ${interpolated}'''
With multiple $ characters:
var s = $$'''
this is $${interpolated}
this is not ${interpolated}'''
Bug Fixes and Features
- Improve F12 UX for using declaration in .bicepparam (#18372)
- Add ability to promote info diagnostics to warning in msbuild (#18412)
- Document bicep console for-loop expression limitations (#18269)
- Update ARM JSON type loader to support optional type constraints (#18307)
- Block the existing keyword for extension resources that have no readable scopes (#18260)
- Document the list_avm_metadata Bicep MCP tool (#18327)
- improve syntax handling and update diagnostics for decorators in parameter files (#18274)
- Add support for extended imports (#18223)
- bicep deploy: Disable live table rendering if ANSI disabled (#18409)
- Fix for deployCommands experimental feature issue (#18367)
- Clarify JSONRPC command options in RootCommand.cs (#18418)
- Add diagnostic trace information on OS & architecture (#18321)
- Build command: Don't write an empty file on unhandled exception (#18214)
- Support access token refresh in deploy pane (#18326)
- Provide simple DI methods for common libraries (#18362)
- DSC requires the apiVersion field and it's no longer being emitted (#18365)
Community Contributions
- fix: Playground not loading (#18270) - thanks @ShpendKe !
- docs: Readme refresh (#17246) - thanks @matsest !
- Add Bicep RPC client library documentation (#18173) - thanks @Gijsreyn !
- Polish documentation for Bicep MCP Server and its tools in VS Code (#18329) - thanks @Gijsreyn !

Bug Fixes
- Fix for incorrect error diagnostic on policyDefinitions existing resource usage (#18169)
- Fix regression on secure inline object types and resource-derived string and object types (#18170)
- Bicep.RpcClient - use PipeReader & PipeWriter APIs (#18212)

Bug Fixes and Features
- Fix for incorrect error diagnostic on MSGraph existing resource usage (#18160)
- Add library for interacting with Bicep CLI via JSONRPC (#18151)

Highlights
- onlyIfNotExists GA! (#17996)
@onlyIfNotExists()
resource onlyDeployIfNotExists 'Microsoft...' = {
name: 'example'
location: 'eastus'
properties: {
...
}
}
- [Experimental] Interactive bicep console command for REPL functionaltiy (#18152)
See Using the Console Command for additional information.
- [Experimental] Interactive bicep deploy, bicep what-if and bicep teardown commands (#18041, #18052, #18053, #18096, #18104)
https://github.com/user-attachments/assets/da64f3a3-3c11-411b-94b6-6324f79af107
See Using the Deploy Commands for additional information and code samples.
- [Experimental] Add @validate() decorator for custom validation (#17804) - requires the userDefinedConstraints feature flag
@validate(x => startsWith(x, 'foo')) // <-- Accepts 'food' or 'fool' but causes the deployment to fail if 'booed' was supplied
param p string
- Add loadDirectoryFileInfo function (#17241) - thanks @GABRIELNGBTUC !
This function returns an array of objects for each file in the directory for you to use in your Bicep template.
var directoryInfo = loadDirectoryFileInfo('./directory')
var directoryInfoWildcard = loadDirectoryFileInfo('./directory', '*.txt')
- Add an explicit any type (#17848)
This PR adds a new ambient type symbol (any) to take advantage of "type" constraints being made optional in ARM's w34 release. Anywhere type syntax is expected, users can now supply any:
param foo any
output bar any = foo

func cowSay(toSay any) string => 'The cow says, "${toSay}"'
- Remove moduleIdentity experimental feature (#17909)
module mod './module.bicep' = {
identity: {
type: 'UserAssigned'
userAssignedIdentities: {
'${mid.id}': {}
}
}
}
Bug Fixes and Features
- Bicep MCP server
- Updated mcp experimental docs to show EXPERIMENTAL server name (#17754)
- Add List AVM MCP Tool (#17845)
- fixing typos in mcp server best practices file (#17855)
- Bicepparam
- Remove redundant checks for empty parameter assignments in parameter evaluation (#17807)
- fix and add test for invalid parameter type (#17193)
- implement "base" parameters support for extended bicepparam files (#17850)
- Fix a bug where source files with extensions cannot be published (#17808)
- Check for Windows Style Absolute Paths (#17995)
- Add experimentalFeaturesWarning (#17910)
- Add "Creating a Local Extension with .NET" quickstart guide (#17726)
- Graph extension update dynamic types link (#17851)
- Automatically enable symbolic name compilation for resource/module collection access (#17861)
- [docs] Add information about trace verbosity (#18093)
- Do not require properties marked as readonly+required (#17913)
- Add & handle readableScopes + writableScopes properties (#17849)
- Inline existing resources with runtime names (#17904)
- Bug fixes for moduleExtensionConfigs experimental feature. (#17860)
- Fix quickstart instructions (#17759)
- Fix broken local-deploy links (#17846)
- Increase local deploy job timeout (#18040)
- Avoid returning internal information for extensible resource snapshot (#18119)
Community Contributions
- feat: BRM Tool - Removed deprecated pathFilter property from BRM version schema (#17720) - thanks @AlexanderSehr !
- Add fix to decompile desiredStateConfiguration resources (#17764) - thanks @Gijsreyn !
- Fix bicep decompile-params if file is different name (#17795) - thanks @Gijsreyn !
- Linter rule should exclude all metadata (#17667) - thanks @guimatheus92 !

Highlights
- [Experimental] Bicep MCP server (#17519, #17572, #17607, #17712). See Using Bicep MCP Server in VS Code (Preview!) for usage information.
- [Experimental] Simplified C# authoring experience for Local Deploy extensions (#17557, #17616) - thanks @samirbanjanovic !
- See Creating a Local Extension with .NET for a minimal quickstart guide.
- GA release for the externalInput() function (#17470)
- [Requires the localDeploy Experimental feature] Simplify publishing process by supporting type discovery via gRPC (#17665)
- Add "format" capability to bicep jsonrpc (#17567)
- [Requires the moduleExtensionConfigs Experimental feature] Extension config assignment syntax updates and module aware extension config assignment (#17389)
Bugs and Features
- Use language version 2.0 for extensibility (#17714)
- Update short-circuiting linter to use nested deployment expander (#17334)
- Emit an error diagnostic when a secure output is dereferenced indirectly (#17453)
- Improve reduce type inference (#17574)
- Add stacks extensibility linting rule. Restrict syntax on config assignments. (#17654)
- Add control bar for visual designer (#17518)
- Remove deprecated CLI arguments (#17564)
Community Contributions
- Update params-file-grammar.md (#17510) - thanks @rgant !
- Add linter rule to warn on usage of outdated AzPowerShell version in deployment scripts (#17556) - thanks @guimatheus92 !
- Added references to the Azure Verified Module website and bicep-registry-module repository (#17664) - thanks @johnlokerse !

Highlights
- Add Identity Snippets for Resources (#17335)
- Update Bicep linter diagnostics to point to https://aka.ms/bicep/linter-diagnostics (#17390)
- Mark conditional resources as nullable for the purposes of property access (#16987)
- Typing improvements for extensions (#17242)
Features and Bug Fixes
- Handle union type properly in use-secure-value-for-secure-inputs rule (#17372)
- Update Azure.Deployments.Templates to latest (#17375)
- Fix extension collection reference codegen (#17381)
- Detect usage of fully-qualified non-deterministic functions in resource identifiers (#17505)
- Remove auxiliary file size limit for local deploy (#17506)
- Add (WIP) visual designer and resource type explorer apps (#17503)
- Add DeployTimeConstant Flag for Module Identity (#17383)
- Support ES target for highlight.js (#17285)
- Only use listOutputsWithSecureValues to dereference secure outputs (#17423)
Snapshot command
- Add support for null-valued parameters to snapshot command (#17291)
- Use the target scope of the template file as the target scope of a params file (#17292)
- Surface cross-module validation errors in snapshot command as messages, not unhandled exceptions (#17378)
- Enable speculative reference evaluation in snapshot helper (#17512)
Community Contributions
- Correct Param & Var Declarations (#17511) - thanks @rgant !
- Add Dependabot configuration for .NET SDK updates (#17424) - thanks @JamieMagee !
- Type definition code base and associated unit tests (#17391) - thanks @samirbanjanovic !

Highlights
- GA release for optional types in variables (#17055)
// current variable syntax
var foo = 'hello'
// new variable syntax with optional type
var foo string = 'hello'
- Add userPrincipalName to deployer() function return type (#17099)
Example usage:
var myUser = deployer().userPrincipalName
- [Experimental] New CLI command group bicep snapshot for snapshot validation. See Using the snapshot command for usage information.
- Video demo available here
- [Experimental] Local Deploy: Various improvements to support end-to-end scenarios (#17048, #17195, #17234, #17235, #17095)
- Video demo available here
- [Requires the moduleIdentity Experimental feature] Support identity assignments on modules (#17150, #17233)
Example usage:
param identityId string
module mod './module.bicep' = {
identity: {
type: 'UserAssigned'
userAssignedIdentities: {
'${identityId}': {}
}
}
}
Note that this is introduced for future capabilities, and is not currently supported by the backend service.
- Bicep Extensibility feature flag has been removed (#17094)
Documentation available at Use Bicep Extensions
Fixes
- Fix completions for function arguments (#17146)
- Enable decompilation of KV reference in parameters json (#17196)
- Allow outer variable completions in user-defined functions (#17198)
- Handle case insensitive name clashes for imported variable, func, and type symbols (#17200)
- Add value bounds to loop index variable (#17201)
- Raise error diagnostic on ambiguous scope (#17202)
- Fix F12 for imported symbols from oci modules (#16941)
- use-secure-value-for-secure-inputs linter rule: Remove some false positives (#17107)
- adding cases to handle user defined typed params (#16864)
- adding completion support for 'extends' keyword (#17194)
- Fix F12 for imported symbols from oci modules (#16941)
Community Contributions
- Add linter rule to warn on unused compile-time imports (#16990) - thanks @GABRIELNGBTUC !
- Disable linter rule "Maximum number of variables used" when the file does not contain declarations used in files meant to deployed and variables are exported (#17149) - thanks @GABRIELNGBTUC !

Highlights
- GA release for the @secure() decorator on module outputs! You can now output secure values from a child module and read them in a parent module. (#16796)
- Visual Studio Bicep extension support for .bicepparam files! (#16861)
- New functions for working with URIs - parseUri() and buildUri() (#16802)
Example usage:
/*
Returns
{
scheme: 'https'
host: 'example.com'
port: 1234
path: '/foo/bar'
}
*/
output parsedUri object = parseUri('https://example.com:1234/foo/bar')
/*
Returns:
'https://example.com:1234/foo/bar'
*/
output builtUri string = buildUri({
scheme: 'https'
host: 'example.com'
port: 1234
path: 'foo/bar'
})
- New functions for working with Availaiblity Zones (#16985)
- toLogicalZone() - converts physical zones to logical zones
- toPhysicalZone() - converts logical zones to physical zones
- Array versions for bulk conversions (toLogicalZones() & toPhysicalZones())
var subscriptionId = subscription().subscriptionId
var location = 'westus2'
/*
Returns the physical AZ corresponding to the specified logical AZ in the specified subscription and location.
For westus2 location, this will be one of 'westus2-az1', 'westus2-az2', 'westus2-az3' depending on the subscription.
*/
output singlePhysicalZone string = toPhysicalZone(subscriptionId, location, '1')
/*
Returns an array of physical AZs corresponding to the specified logical AZs in the specified subscription and location.
*/
output physicalZones string[] = toPhysicalZones(subscriptionId, location, ['1', '2'])
/*
Returns the logical AZ corresponding to the specified physical AZ in the specified subscription and location.
Returns '1', '2', or '3' depending on the subscription.
*/
output singleLogicalZone string = toLogicalZone(subscriptionId, location, 'westus2-az2')
/*
Returns an array of logical AZs corresponding to the specified physical AZs in the specified subscription and location.
*/
output logicalZones string[] = toLogicalZones(subscriptionId, location, [
'westus2-az1'
'westus2-az2'
])
- use-secure-value-for-secure-inputs linter rule: Use resource type information to catch more unsafe passing of non-secure values (#16873)
- [requires the onlyIfNotExists experimental feature] Resource Existence Checks using @onlyIfNotExists() decorator (#16655)
Attaching this decorator to a resource declaration means deployment of the resource will only take place if it hasn't already been deployed. Example usage:
@onlyIfNotExists()
resource onlyDeployIfNotExists 'Microsoft...' = {
name: 'example'
location: 'eastus'
properties: {
...
}
}
- [requires the typedVariables experimental feature] Support importing and declaring types in .bicepparam files with typedVariables decorator (#16929)
- Allow usage of the type keyword in .bicepparam files
- Allow importing types from .bicep files in .bicepparam files
- Allow usage of inline types in .bicepparam files
- [requires the externalInputFunction experimental feature] External Input function - externalInput function to allow reading input that will be resolved later by external tooling in order to inject values at deployment time. (#16726)
Bugs and Features
- Decompiler support for user-defined functions (#16883)
- use-parent-property linter rule: Fix incorrect warning with blobContainer and fileShare (#16738)
- Raise diagnostic for unsupported usage of spread (#16739)
- Add friendly name to Playground link (#16803)
- Revert #16442 - Fixed bug VSCode extension does not read values from parameter file (#16789)
- no-hardcoded-env-urls linter rule: Remove URLs not present in environment() function output (#16863)
- Fix for intellisense of symbols inside import statement (#16936)
- fixing dotnet format issues, and addressing IDE0305: Collection initialization can be simplified errors/warnings (#16808)
- Use symbolic name for list function calls (#16862)
- Enhance substring type inference - updated parameter types for substring to infer acceptable ranges based on the other arguments provided to the function. (#16859)
- Prevent infinite re

Features and Bug Fixes
- Use languageVersion 2.0 when an existing resource has an explicit dependency (#16670)
- Validate regex patterns against non-backtracking engine (#16687)
- Generate deterministic dependsOn (#16668)
- Add more detailed information about local-deploy (#16677)
- Add more info on implementing extensions for local-deploy (#16678)
- Add name pattern validation for modules (#16680)
- Add Desired State Configuration target scope and experimental feature flag (#16389)

Highlights:
- Address v0.33.13 language server crash/stack overflow (#16235)
- Address v0.33.13 deployment failures when depending on looped resources in non-symbolic name templates (#16236)
- Release Deployment Pane as a non-experimental feature (#16173)
Other bugs and features:
- Offer code fix to fully qualify function call for shadowed decorator functions (#16116)

Highlights:
- Paste as BicepParams (#15897)
- Add resourceInput<> and resourceOutput<> utility types (#15825)
We've added two new utility types (resourceInput<> and resourceOutput<>), which deprecates the existing resource<> utility types. These three utility types are all closely related but differ in which property flags they surface:
- resource<> has the flags that were originally defined in the RP types artifact. This is generally not what people want.
- resourceInput<> strips out all WriteOnly flags. This means that template authors can access properties on a resourceInput<>-typed parameter that would have previously raised a BCP077 diagnostic.
- resourceOutput<> strips out all ReadOnly flags.
- Expose fail function (#15958) This function takes a single string argument, whose value is the message of the error that will be raised.

Other bugs and features:
- extendable param files add a warning when referencing to a non-existent .bicepparam file (#15338)
- adding support for variables, objects and arrays in extended param files (#15834)
- Refactor and simplify handling of single quotes in module completions (#15913)
- use-safe-access linter rule: Expand to check for nullable properties (#15838)
- Fix for WhatIf results not showing up properly in the deploy pane (#16048)
- Support object property name completions in lambda body syntax (#16055)
- MS Graph type provider warns on property mismatch (#15824)
- Fix unhandled exception in import closure calculation (#15833)
- Validate type clauses in UDFs (#15842)
- Allow exports of symbols that share a name with an output (#15899)
- Catch recursion in parameterized type invocations (#15903)
- Use fully qualified symbolic name as copy loop name (#15910)
- Include imported variables in max variables check (#15956)
- Rename Bicep.IO package to Azure.Bicep.IO (#16046)
- Validate that type expressions that will be compiled to ARM schema nodes can be expressed in ARM's type system prior to compilation (#15901)
- SecureOutput Feature Bug Fix (#16108)
- Allow accessing generated module names (#16058)
- Deprecate the term provider (#16107)
- Fix linter discrepancies when optional module name is enabled (#16106)
- Emit symbolic name template when an optional module name is enabled. (#16114)
- Fix BCP159 to check existence of any nested resources (#15988)
- Decompile-params: Resolve bicep file path relative to current directory (#15986)
- Add AdditionalPropertiesDescription property to ObjectType (#15990)

Highlights:
- New deployer() function to retrieve ObjectId of the principal that is deploying the Bicep file (#15340)
- Support partial public registry completions (#15646). Previously, if typing the entire module reference, you would lose completions after typing a /
Other bugs and features:
- Support deploying to other clouds in Deploy Pane (#15635) - thank you @alaskascooter for filing
- Only add an explicit dependency on an existing resource when the deployments engine will use the GET response (#15693) - thank you @AleksandrKomarov for filing
- Move all indexing expressions when calculating dependsOn expressions (#15580) - thank you @slavizh for filing
- Local Deploy: Support null for InnerError field (#15583)
- InsertResource - correctly strip read-only properties (#15689)
- MS Graph type loader accepts resource identifier property flag (#15518)
- Fixed stack overflow when requesting completion in an object literal (#15579)
- Use vscode authentication instead of Azure Account extension (#15403)
- Move deploy-pane to vscode-bicep-ui (#15584)
- Emit type and apiVersion separately for local and v2 ext resources (#15762)
- Update jsonrpc.test.ts reference (#15657)
- Add case-insensitive equality operators to grammar (#15640)

Features and bug fixes
- Revert "Only add an explicit dependency on an existing resource when the deployments engine will use the GET response" (#15524)
- Don't collapse scope references or namespaces into objects (#15570)
- allow using none statements in bicepparam files at build-params command (#15107)

Highlights:
- Improve ternary type inference (#15399)
- Allow dependsOn for existing resources (#15459)
- Tree-shake existing resources where possible (#15447)
- Sort public registry module version completion items (#15400)
- Refactor: Extract variable, parameter, type (#14701)
- Allow imported variable access from within User Defined Functions (#15142)
- Nameof function (#14704) - Thanks @miqm !
Bugs and Features:
- Add deprecation warning for microsoftGraph builtin extension (#15149)
- Add deployment script snippets (#15191)
- Fix reduce() return type signature (#15386)
- Clarify newlines before/after extractions (#15194)
- 15266 Completion for "resource<...>" should include the necessary str… (#15267)
- Allow extracting param as resource-derived type (#15282)
- Fix linter rule: Max variables limit increased from 256 -> 512 (#15464)

What's Changed
- Support named pipe fallback for IPC in local mode on unsupported platforms (#15046)

Highlights
- Bicep error codes for core diagnostics documentation (#14881)
Bugs and Features
- Use minutes in VS Code default bicep deployment name (#14764) - thanks @Strandfelt !
- Support completions for import file paths (#14659)
- Handle operator precedence correctly in use-safe-access linter rule codefix (#14710)
- Local mode Bicep issue fixes for #14770 (#14830)
- Support validation & completions for property access on array element (#14846)
- Rename provider -> extension in many places (#14872)
- adding code completion for extends keyword in bicepparam files (#14986)
- adding none in the suggested completions list (#14988)
- Avoid assigning invalid cyclic types to declarations (#14874)
- Trim descriptions in compiled JSON (#14870)
- Deploy pane: link to correct Portal blade for nested deployments (#14880)
- Relax bicepconfig.json validation for extensions, to allow file paths (#14873)
- Add spread & multiline objects + arrays to grammar (#14983)
- Use imported symbol identifiers rather than identity in memory to deduplicate imports when building closure (#14615)
- Enable type narrowing on assignment of non-variable symbols (#14989)
- Fix go to def for template spec modules (#14871)
- Fix obsoletion warnings (#14992)
- Allow Variable Symbol Access from within user defined functions (#14531)
- What If Short Circuiting Linter Rule (Default Off) (#14910)
- Added Documentation on Extendable Bicep Params (#14865)
- Fix for issue 12800 function arguments with comment before end token (#14699)

Bugs and Features
- Handle special characters in use-safe-access rule correctly (#14593)
- Fix bug with local-deploy CLI command group when using OCI (#14592)

Highlights
- [Experimental] Extendable Param Files feature (#13900)
- [Experimental] Support for the local-deploy CLI command (#14243, #14234, #14231, #14237, #14514, #14587, #14438)
- New linter rule: use-recent-module-versions (#14309)
- New linter rule: use-safe-access (#14322)
Breaking Changes
- Replace the provider keyword with the extension keyword (#14379)
- Deprecate provider in Bicep configuration files (#14468)
For more details about the breaking changes, see Bugs and Features
- Added info about missing CLI option --outdir (#14188) - thanks @o-l-a-v!
- Add trace log message when failing to find Env Var (#13777) - thanks @SimonWahlin!
- Correctly decompile negative numbers in TLEs (#14317)
- Remove experimental flag for JSONRPC command group (#14368)
- Avoid putting URLs into 'code' field in diagnostics (#14583)
- Escape strings correctly in snippets (#14582)
- Update Microsoft Graph Bicep types (#14382)
- Fix UDT syntax highlighting (#14372)
- Ensure \n is used when emitting template (#14581)
- Fix Intellisense and other features of Bicep in Visual Studio that were broken by VS 17.10 (#14532)
Refactoring
- Use string.Method(char) instead of string.Method(string) when possible (#14255) - thanks @Meir017!
- Use collection expression (#14318) - thanks @Meir017!

Bicep Team
- MS Graph Extensibility is now in Public Preview!
- Support spread completions inside ternary and parenthesized expressions (#14058)
- Allow dot property access on union of objects with undeclared property (#14060)
- Allow importing from Bicep templates with required parameters (#14070)
Bugs and Features
Bicep Team
- Improve BCP395 error message (#14094)
- Fix index out of range for bicep format with --insert-final-newline (#14193)

Highlights
Bicep Team:
- "publishSource" is now GA! (#13899)
- Implement the spread ... operator, other new functions, and indices on lambdas (#13658)
- Support completions inside object spread (#14000)
- Normalize indenting for multi-line descriptions (#14013)
- Default levels for linting rules finalized (#13847)
- Permit validation for property access on union types (#14017)
Bugs and Features
Bicep Team:
- Clarify on JSONRPC format (#13825)
- Support --outdir param with build-params (#13890)
- Create 'use-secure-value-for-secure-inputs' linter rule (#13905)
- Add detailed validation for UDFs with UDTs (#14011)
- Fix for stack overflow issue (#14049)
- Check namespaces in prefer-interpolation linter rule (#14050)
- Support codefix for missing Bicep params (#14012)
- Formatting rule improvements (#13945)
- Recognize common keywords for resource type completions (#13721)
- Show full path of built JSON file so it's clickable in vscode (#13787)
- Try to fix 13333 (#13788)
- Make some minor improvements to resource filter keywords and add filter keyword support for resource snippets (#13731)
- 13842 Bicep linter doesn't recognise managementGroupResourceId as a r… (#13889)

Features and Bug Fixes
Bicep Team:
- Support including imported types in user-defined tagged unions (#13728)
- Preserve distinction between {} and object in compiled JSON (#13597)
- Distinguish between type syntax vs expression syntax in the parser (#13671)
- Fix bug with parsing expressions in object keys from ARM templates (#13665)
- Avoid running no-hardcoded-env-urls linter rule in .bicepparam files (#13608)
- Fix importing tagged unions from compiled JSON (#13733)
- Fix importing tuples from JSON (#13736)
- Clarify wording for BCP081 warning (#13739)
@davidlloyduk- #13619 secure parameter linter fix (#13717)
@itpropro- Update grammar (#13668)

Highlights
Bicep Team:- User Defined Functions are now GA! (#13458)
- Allow function imports in .bicepparam files (#13459)
- Handle single-member unions imported from JSON templates (#13464)
- Raise diagnostic when whole resource body is used as a type (#13494)
- Added support for recursive build and publish output (#13292)
- V1 Formatter Deprecated: new feature flag legacyFormatter (#13394)
- Support loading source dynamically for nested external modules (#13495)
Features and Bug Fixes
Bicep Team- Fix for issue 13531 (#13532)
- Fix for various issues noticed with provider syntax (#13542)
- Show tooltips on hover for type property definitions and type additional properties accesses (#13546)
- Remove v1 formatter (#13290)
- Allow dot in resource type version pattern (#13331)
- Fix formatting for comma-separated arguments list (#13504)
- Preserve nullability when loading resource-derived type from ARM JSON template (#13536)
@olegKoshmeliuk- Fix for issue #13558 (#13559)

Features and Bug Fixes
Bicep Team:- Fix an issue where use-recent-api-versions triggers unhandled exception (#13240)
- Make sure types from wildcard imports are assigned the correct type when pulling from ARM JSON models. (#13255)
- Don't raise missing properties diagnostic if assigned object value has an additional properties type (#13272)
- Fix for double-evaluation issue with compile-time imports (#13277)
- Ensure language server refreshes modules on force refresh (#13278)