Skip to content

Commit 1a2b88c

Browse files
committed
update
1 parent e919f6c commit 1a2b88c

File tree

2 files changed

+9
-9
lines changed

2 files changed

+9
-9
lines changed

articles/azure-resource-manager/bicep/bicep-using.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ ms.custom: devx-track-bicep
1010

1111
A `using` or a `using none` declaration must be present in all Bicep parameters files.
1212

13-
A Bicep parameter file typically uses a `using` statement to ties the file to a [Bicep file](./file.md), a [JSON Azure Resource Manager template (ARM template)](../templates/syntax.md), a [Bicep module](./modules.md), or a [template spec](./template-specs.md). This linkage allows the Bicep language server and compiler to validate the parameter file—checking for correct names, types, and required values based on the template’s inputs.
13+
A Bicep parameter file typically uses a `using` statement to tie the file to a [Bicep file](./file.md), a [JSON Azure Resource Manager template (ARM template)](../templates/syntax.md), a [Bicep module](./modules.md), or a [template spec](./template-specs.md). This linkage allows the Bicep language server and compiler to validate the parameter file—checking for correct names, types, and required values based on the template’s inputs.
1414

15-
In contrast, the `using none` statement explicitly indicates that the parameter file is not tied to any particular template at compile time. This means the parameters are not validated against a specific template and are instead intended for more general use—such as being consumed by external tools or serving as shared, reusable parameter sets.
15+
In contrast, the `using none` statement explicitly indicates that the parameter file isn't tied to any particular template at compile time. This means the parameters aren't validated against a specific template and are instead intended for more general use—such as being consumed by external tools or serving as shared, reusable parameter sets.
1616

1717
> [!NOTE]
1818
> Bicep parameters files are supported only in [Bicep CLI version 0.18.4](https://github.com/Azure/bicep/releases/tag/v0.18.4) or later, [Azure CLI](/cli/azure/install-azure-cli) version 2.47.0 or later, and [Azure PowerShell](/powershell/azure/install-azure-powershell) version 9.7.1 or later. The `using none` feature is supported in [Bicep CLI version 0.31.0](https://github.com/Azure/bicep/releases/tag/v0.31.92) or later.
@@ -99,23 +99,23 @@ The syntax of the `using` statement:
9999

100100
## The using none statement
101101

102-
The `using none` statement in a Bicep parameter file (.bicepparam) indicates that the file is not tied to a specific Bicep template during authoring or compilation. This decouples the parameter file from a particular template, enabling greater flexibility in how parameters are defined and used across deployments.
102+
The `using none` statement in a Bicep parameters file (.bicepparam) indicates that the file isn't tied to a specific Bicep template during authoring or compilation. This decouples the parameter file from a particular template, enabling greater flexibility in how parameters are defined and used across deployments.
103103

104104
The syntax of the `using none` statement:
105105

106106
```bicep
107107
using none
108108
```
109109

110-
This statement is placed at the beginning of a .bicepparam file to signal that no specific template is referenced.
110+
This statement is placed at the beginning of a Bicep parameters file to signal that no specific template is referenced.
111111

112112
The primary benefit of `using none` in Bicep lies in scenarios where parameter files are generalized, shared, or dynamically integrated with templates. Common use cases include:
113113

114114
- **Centralized Parameter Repositories**
115115

116-
Organizations often maintain standard parameter values—such as default regions, naming conventions, or global tags—used across multiple Bicep deployments. A .bicepparam file with using none can act as a central store for these shared values, improving consistency and minimizing duplication. These parameters can then be programmatically merged with template-specific values at deployment time.
116+
Organizations often maintain standard parameter values—such as default regions, naming conventions, or global tags—used across multiple Bicep deployments. A Bicep parameters file with using none can act as a central store for these shared values, improving consistency and minimizing duplication. These parameters can then be programmatically merged with template-specific values at deployment time.
117117

118-
For example, a shared .bicepparam file might define:
118+
For example, a shared Bicep parameters file might define:
119119

120120
```bicepparam
121121
using none
@@ -129,7 +129,7 @@ The primary benefit of `using none` in Bicep lies in scenarios where parameter f
129129

130130
In CI/CD pipelines or automation scripts, parameter files may be created on-the-fly or associated with templates at runtime. By omitting a fixed template reference, `using none` allows these files to remain flexible and adaptable to different deployment contexts.
131131

132-
When `using none` is specified in a Bicep parameter file, the compiler does not validate the parameters against a specific Bicep template, meaning no compile-time warnings or errors are raised for mismatched names or types due to the absence of a linked template. However, this decoupling applies only during authoring and compilation—at deployment time, Azure Resource Manager (ARM) still requires both a Bicep template and a parameter file. The ARM engine performs validation during deployment by resolving the parameters in the file against those defined in the target template.
132+
When `using none` is specified in a Bicep parameter file, the compiler doesn't validate the parameters against a specific Bicep template, meaning no compile-time warnings or errors are raised for mismatched names or types due to the absence of a linked template. However, this decoupling applies only during authoring and compilation—at deployment time, Azure Resource Manager (ARM) still requires both a Bicep template and a parameter file. The ARM engine performs validation during deployment by resolving the parameters in the file against those defined in the target template.
133133

134134
## Next steps
135135

articles/azure-resource-manager/bicep/parameter-files.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,9 +61,9 @@ using 'ts:00000000-0000-0000-0000-000000000000/myResourceGroup/storageSpec:1.0'
6161
...
6262
```
6363

64-
For more information, see [Using statement](./bicep-using.md/#the-using-statement).
64+
For more information, see [Using statement](./bicep-using.md#the-using-statement).
6565

66-
You can apply the `using none` statement to indicate that the parameters file is not tied to a specific Bicep template during authoring or compilation. This decouples the parameter file from a particular template, enabling greater flexibility in how parameters are defined and used across deployments. For more information, see [Using none statement](./bicep-using.md/#the-using-none-statement).
66+
You can apply the `using none` statement to indicate that the parameters file is not tied to a specific Bicep template during authoring or compilation. This decouples the parameter file from a particular template, enabling greater flexibility in how parameters are defined and used across deployments. For more information, see [Using none statement](./bicep-using.md#the-using-none-statement).
6767

6868
```bicep
6969
You can use expressions with the default value. For example:

0 commit comments

Comments
 (0)