You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/governance/policy/concepts/initiative-definition-structure.md
+5-7Lines changed: 5 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -128,23 +128,21 @@ there are some _common_ properties used by Azure Policy and in built-ins.
128
128
## Version (preview)
129
129
Built-in policy initiatives can host multiple versions with the same `definitionID`. If no version number is specified, all experiences will show the latest version of the definition. To see a specific version of a built-in, it must be specified in API, SDK or UI. To reference a specific version of a definition within an assignment, see [definition version within assignment](../concepts/assignment-structure.md#policy-definition-id-and-version-preview)
130
130
131
-
The Azure Policy service uses `version`, `preview`, and `deprecated` properties to convey level of
132
-
> change to a built-in policy definition or initiative and state. The format of `version` is:
133
-
> `{Major}.{Minor}.{Patch}`. Specific states, such as _deprecated_ or _preview_, are appended to the
134
-
> `version` property or in another property as a **boolean**.
131
+
The Azure Policy service uses `version`, `preview`, and `deprecated` properties to convey level of change to a built-in policy definition or initiative and state. The format of `version` is: `{Major}.{Minor}.{Patch}`. Specific states, such as _deprecated_ or _preview_, are appended to the `version` property or in another property as a **boolean**.
135
132
136
133
- Major Version (example: 2.0.0): introduce breaking changes such as major rule logic changes, removing parameters, adding an enforcement effect by default.
137
134
- Minor Version (example: 2.1.0): introduce changes such as minor rule logic changes, adding new parameter allowed values, change to role definitionIds, adding or removing definitions within an initiative.
138
135
- Patch Version (example: 2.1.4): introduce string or metadata changes and break glass security scenarios (rare).
139
136
137
+
Built-in initiatives themselves are versioned, and specific versions of built-in policy definitions can be referenced within builtin or custom initiatives as well. For more information, see [reference definition and versions](#policy-definition-properties).
138
+
139
+
> While in preview, when creating an initiative through the portal, you will not be able to specify versions for built-in policy definition references. All built-in policy references in custom initiatives created through the portal will instead default to the latest version of the policy definition.
> To learn more about what it means for a policy to be _deprecated_ or in _preview_, see [Preview and deprecated policies](https://github.com/Azure/azure-policy/blob/master/built-in-policies/README.md#preview-and-deprecated-policies).
144
145
145
-
Built-in initiatives themselves are versioned, but it's possible to reference a specific version of a built-in definition within a builtin or custom initiative. For more information, see [reference definition and versions.](#policy-definition-properties)
146
-
147
-
148
146
## Parameters
149
147
150
148
Parameters help simplify your policy management by reducing the number of policy definitions. Think
0 commit comments