|
2 | 2 | title: Template deployment what-if
|
3 | 3 | description: Determine what changes will happen to your resources before deploying an Azure Resource Manager template.
|
4 | 4 | ms.topic: conceptual
|
5 |
| -ms.date: 02/15/2023 |
| 5 | +ms.date: 09/06/2023 |
6 | 6 | ms.custom: devx-track-azurepowershell, devx-track-azurecli, devx-track-arm-template
|
7 | 7 | ms.devlang: azurecli
|
8 | 8 | ---
|
@@ -136,18 +136,14 @@ For REST API, use:
|
136 | 136 |
|
137 | 137 | ## Change types
|
138 | 138 |
|
139 |
| -The what-if operation lists six different types of changes: |
| 139 | +The what-if operation lists seven different types of changes: |
140 | 140 |
|
141 | 141 | - **Create**: The resource doesn't currently exist but is defined in the template. The resource will be created.
|
142 |
| - |
143 | 142 | - **Delete**: This change type only applies when using [complete mode](deployment-modes.md) for deployment. The resource exists, but isn't defined in the template. With complete mode, the resource will be deleted. Only resources that [support complete mode deletion](./deployment-complete-mode-deletion.md) are included in this change type.
|
144 |
| - |
145 | 143 | - **Ignore**: The resource exists, but isn't defined in the template. The resource won't be deployed or modified. When you reach the limits for expanding nested templates, you will encounter this change type. See [What-if limits](#what-if-limits).
|
146 |
| - |
147 | 144 | - **NoChange**: The resource exists, and is defined in the template. The resource will be redeployed, but the properties of the resource won't change. This change type is returned when [ResultFormat](#result-format) is set to `FullResourcePayloads`, which is the default value.
|
148 |
| - |
| 145 | +- **NoEffect**: The property is ready-only and will be ignored by the service. For example, the `sku.tier` property is always set to match `sku.name` in the [`Microsoft.ServiceBus`](/azure/templates/microsoft.servicebus/namespaces) namespace. |
149 | 146 | - **Modify**: The resource exists, and is defined in the template. The resource will be redeployed, and the properties of the resource will change. This change type is returned when [ResultFormat](#result-format) is set to `FullResourcePayloads`, which is the default value.
|
150 |
| - |
151 | 147 | - **Deploy**: The resource exists, and is defined in the template. The resource will be redeployed. The properties of the resource may or may not change. The operation returns this change type when it doesn't have enough information to determine if any properties will change. You only see this condition when [ResultFormat](#result-format) is set to `ResourceIdOnly`.
|
152 | 148 |
|
153 | 149 | ## Result format
|
@@ -185,7 +181,6 @@ The following results show the two different output formats:
|
185 | 181 | ]
|
186 | 182 | ~ properties.subnets: [
|
187 | 183 | - 0:
|
188 |
| -
|
189 | 184 | name: "subnet001"
|
190 | 185 | properties.addressPrefix: "10.0.0.0/24"
|
191 | 186 |
|
|
0 commit comments