Skip to content

Commit 5fbfb21

Browse files
Merge pull request #269875 from davidsmatlak/ds-update-policy-definition-20240321
Edits Policy definition structure property name
2 parents 783033d + 8c55273 commit 5fbfb21

File tree

2 files changed

+12
-12
lines changed

2 files changed

+12
-12
lines changed

articles/governance/policy/concepts/definition-structure.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Details of the policy definition structure
33
description: Describes how policy definitions are used to establish conventions for Azure resources in your organization.
4-
ms.date: 08/15/2023
4+
ms.date: 03/21/2024
55
ms.topic: conceptual
66
---
77

@@ -76,19 +76,19 @@ Azure Policy built-ins and patterns are at [Azure Policy samples](../samples/ind
7676

7777
## Display name and description
7878

79-
You use **displayName** and **description** to identify the policy definition and provide context
80-
for when it's used. **displayName** has a maximum length of _128_ characters and **description**
79+
You use `displayName` and `description` to identify the policy definition and provide context
80+
for when it's used. `displayName` has a maximum length of _128_ characters and `description`
8181
a maximum length of _512_ characters.
8282

8383
> [!NOTE]
84-
> During the creation or updating of a policy definition, **id**, **type**, and **name** are defined
84+
> During the creation or updating of a policy definition, `id`, `type`, and `name` are defined
8585
> by properties external to the JSON and aren't necessary in the JSON file. Fetching the policy
86-
> definition via SDK returns the **id**, **type**, and **name** properties as part of the JSON, but
86+
> definition via SDK returns the `id`, `type`, and `name` properties as part of the JSON, but
8787
> each are read-only information related to the policy definition.
8888
89-
## Type
89+
## Policy type
9090

91-
While the **type** property can't be set, there are three values that are returned by SDK and
91+
While the `policyType` property can't be set, there are three values that are returned by SDK and
9292
visible in the portal:
9393

9494
- `Builtin`: These policy definitions are provided and maintained by Microsoft.
@@ -143,7 +143,7 @@ The following Resource Provider modes are fully supported:
143143
[Integrate Azure Key Vault with Azure Policy](../../../key-vault/general/azure-policy.md).
144144
- `Microsoft.Network.Data` for managing [Azure Virtual Network Manager](../../../virtual-network-manager/overview.md) custom membership policies using Azure Policy.
145145

146-
The following Resource Provider modes are currently supported as a **[preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/)**:
146+
The following Resource Provider modes are currently supported as a [preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/):
147147

148148
- `Microsoft.ManagedHSM.Data` for managing [Managed HSM](../../../key-vault/managed-hsm/azure-policy.md) keys using Azure Policy.
149149
- `Microsoft.DataFactory.Data` for using Azure Policy to deny [Azure Data Factory](../../../data-factory/introduction.md) outbound traffic domain names not specified in an allow list. This RP mode is enforcement only and does not report compliance in public preview.

articles/governance/policy/concepts/regulatory-compliance.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
11
---
22
title: Regulatory Compliance in initiative definitions
33
description: Describes how to use an initiative definition to group policies by regulatory domain such as Access Control, Configuration Management, and others.
4-
ms.date: 08/17/2021
4+
ms.date: 03/21/2024
55
ms.topic: conceptual
66
---
7+
78
# Regulatory Compliance in Azure Policy
89

910
Regulatory Compliance in Azure Policy provides built-in initiative definitions to view a list of the
1011
**controls** and **compliance domains** based on responsibility (_Customer_, _Microsoft_, _Shared_).
1112
For Microsoft-responsible controls, we provide additional details of our audit results based on
1213
third-party attestation and our implementation details to achieve that compliance.
13-
Microsoft-responsible controls are of `type` [static](./definition-structure.md#type).
14+
Microsoft-responsible controls are of `policyType` [static](./definition-structure.md#policy-type).
1415

1516
> [!NOTE]
1617
> Regulatory Compliance is a Preview feature. For updated built-ins, the initiatives
@@ -59,8 +60,7 @@ compliance** tab provides a granular view of each resource that's evaluated by a
5960
the currently viewed **control**.
6061

6162
> [!NOTE]
62-
> An evaluation type of **Microsoft managed** is for a [static](./definition-structure.md#type)
63-
> policy definition `type`.
63+
> An evaluation type of **Microsoft managed** is for a [static](./definition-structure.md#policy-type) policy definition `policyType`.
6464
6565
:::image type="content" source="../media/regulatory-compliance/regulatory-compliance-policies.png" alt-text="Screenshot of the Regulatory Compliance details for the Boundary Protection control of the NIST SP 800-53 R4 built-in definition.":::
6666

0 commit comments

Comments
 (0)