Skip to content

Commit 1e3fa09

Browse files
Merge pull request #250489 from mumian/0906-whatif-noeffect
add a new change type
2 parents a88e812 + edc6e64 commit 1e3fa09

File tree

2 files changed

+6
-10
lines changed

2 files changed

+6
-10
lines changed

articles/azure-resource-manager/bicep/deploy-what-if.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Bicep deployment what-if
33
description: Determine what changes will happen to your resources before deploying a Bicep file.
44
ms.topic: conceptual
55
ms.custom: devx-track-bicep, devx-track-azurecli, devx-track-azurepowershell
6-
ms.date: 06/28/2023
6+
ms.date: 09/06/2023
77
---
88

99
# Bicep deployment what-if operation
@@ -136,12 +136,13 @@ For REST API, use:
136136

137137
## Change types
138138

139-
The what-if operation lists six different types of changes:
139+
The what-if operation lists seven different types of changes:
140140

141141
- **Create**: The resource doesn't currently exist but is defined in the Bicep file. The resource will be created.
142142
- **Delete**: This change type only applies when using [complete mode](../templates/deployment-modes.md) for JSON template deployment. The resource exists, but isn't defined in the Bicep file. With complete mode, the resource will be deleted. Only resources that [support complete mode deletion](../templates/deployment-complete-mode-deletion.md) are included in this change type.
143143
- **Ignore**: The resource exists, but isn't defined in the Bicep file. 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).
144144
- **NoChange**: The resource exists, and is defined in the Bicep file. 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.
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.
145146
- **Modify**: The resource exists, and is defined in the Bicep file. 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.
146147
- **Deploy**: The resource exists, and is defined in the Bicep file. 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`.
147148

articles/azure-resource-manager/templates/deploy-what-if.md

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Template deployment what-if
33
description: Determine what changes will happen to your resources before deploying an Azure Resource Manager template.
44
ms.topic: conceptual
5-
ms.date: 02/15/2023
5+
ms.date: 09/06/2023
66
ms.custom: devx-track-azurepowershell, devx-track-azurecli, devx-track-arm-template
77
ms.devlang: azurecli
88
---
@@ -136,18 +136,14 @@ For REST API, use:
136136

137137
## Change types
138138

139-
The what-if operation lists six different types of changes:
139+
The what-if operation lists seven different types of changes:
140140

141141
- **Create**: The resource doesn't currently exist but is defined in the template. The resource will be created.
142-
143142
- **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-
145143
- **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-
147144
- **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.
149146
- **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-
151147
- **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`.
152148

153149
## Result format
@@ -185,7 +181,6 @@ The following results show the two different output formats:
185181
]
186182
~ properties.subnets: [
187183
- 0:
188-
189184
name: "subnet001"
190185
properties.addressPrefix: "10.0.0.0/24"
191186

0 commit comments

Comments
 (0)