Explicitly model parameter definitions and values

Azure · zikalino · Oct 30, 2019 · Oct 1, 2019 · Oct 1, 2019 · Oct 4, 2019
commit 02982f50be31f11aa42805fc356998e907e2f0ed
diff --git a/...Microsoft.Authorization/stable/2019-09-01/examples/createOrUpdatePolicySetDefinition.json b/...Microsoft.Authorization/stable/2019-09-01/examples/createOrUpdatePolicySetDefinition.json
@@ -10,6 +10,15 @@
         "metadata": {
           "category": "Cost Management"
         },
+        "parameters": {
+          "namePrefix": {
+            "type": "String",
+            "defaultValue": "myPrefix",
+            "metadata": {
+              "displayName": "Prefix to enforce on resource names"
+            }
+          }
+        },
         "policyDefinitions": [
           {
             "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
@@ -28,7 +37,7 @@
             "policyDefinitionReferenceId": "Resource_Naming",
             "parameters": {
               "prefix": {
-                "value": "DeptA"
+                "value": "[parameters('namePrefix')]"
               },
               "suffix": {
                 "value": "-LC"
@@ -52,6 +61,15 @@
           "metadata": {
             "category": "Cost Management"
           },
+          "parameters": {
+            "namePrefix": {
+              "type": "String",
+              "defaultValue": "myPrefix",
+              "metadata": {
+                "displayName": "Prefix to enforce on resource names"
+              }
+            }
+          },
           "policyDefinitions": [
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
@@ -70,7 +88,7 @@
               "policyDefinitionReferenceId": "Resource_Naming",
               "parameters": {
                 "prefix": {
-                  "value": "DeptA"
+                  "value": "[parameters('namePrefix')]"
                 },
                 "suffix": {
                   "value": "-LC"
@@ -93,6 +111,15 @@
           "metadata": {
             "category": "Cost Management"
           },
+          "parameters": {
+            "namePrefix": {
+              "type": "String",
+              "defaultValue": "myPrefix",
+              "metadata": {
+                "displayName": "Prefix to enforce on resource names"
+              }
+            }
+          },
           "policyDefinitions": [
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
@@ -111,7 +138,7 @@
               "policyDefinitionReferenceId": "Resource_Naming",
               "parameters": {
                 "prefix": {
-                  "value": "DeptA"
+                  "value": "[parameters('namePrefix')]"
                 },
                 "suffix": {
                   "value": "-LC"

diff --git a/...Authorization/stable/2019-09-01/examples/createOrUpdatePolicySetDefinitionWithGroups.json b/...Authorization/stable/2019-09-01/examples/createOrUpdatePolicySetDefinitionWithGroups.json
@@ -26,7 +26,9 @@
           {
             "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
             "policyDefinitionReferenceId": "Limit_Skus",
-            "groupNames": [ "CostSaving" ],
+            "groupNames": [
+              "CostSaving"
+            ],
             "parameters": {
               "listOfAllowedSKUs": {
                 "value": [
@@ -39,7 +41,9 @@
           {
             "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
             "policyDefinitionReferenceId": "Resource_Naming",
-            "groupNames": [ "Organizational" ],
+            "groupNames": [
+              "Organizational"
+            ],
             "parameters": {
               "prefix": {
                 "value": "DeptA"
@@ -82,7 +86,9 @@
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
               "policyDefinitionReferenceId": "Limit_Skus",
-              "groupNames": [ "CostSaving" ],
+              "groupNames": [
+                "CostSaving"
+              ],
               "parameters": {
                 "listOfAllowedSKUs": {
                   "value": [
@@ -95,7 +101,9 @@
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
               "policyDefinitionReferenceId": "Resource_Naming",
-              "groupNames": [ "Organizational" ],
+              "groupNames": [
+                "Organizational"
+              ],
               "parameters": {
                 "prefix": {
                   "value": "DeptA"
@@ -137,7 +145,9 @@
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
               "policyDefinitionReferenceId": "Limit_Skus",
-              "groupNames": [ "CostSaving" ],
+              "groupNames": [
+                "CostSaving"
+              ],
               "parameters": {
                 "listOfAllowedSKUs": {
                   "value": [
@@ -150,7 +160,9 @@
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
               "policyDefinitionReferenceId": "Resource_Naming",
-              "groupNames": [ "Organizational" ],
+              "groupNames": [
+                "Organizational"
+              ],
               "parameters": {
                 "prefix": {
                   "value": "DeptA"

diff --git a/...ble/2019-09-01/examples/createOrUpdatePolicySetDefinitionWithGroupsAtManagementGroup.json b/...ble/2019-09-01/examples/createOrUpdatePolicySetDefinitionWithGroupsAtManagementGroup.json
@@ -26,7 +26,9 @@
           {
             "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
             "policyDefinitionReferenceId": "Limit_Skus",
-            "groupNames": [ "CostSaving" ],
+            "groupNames": [
+              "CostSaving"
+            ],
             "parameters": {
               "listOfAllowedSKUs": {
                 "value": [
@@ -39,7 +41,9 @@
           {
             "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
             "policyDefinitionReferenceId": "Resource_Naming",
-            "groupNames": [ "Organizational" ],
+            "groupNames": [
+              "Organizational"
+            ],
             "parameters": {
               "prefix": {
                 "value": "DeptA"
@@ -82,7 +86,9 @@
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
               "policyDefinitionReferenceId": "Limit_Skus",
-              "groupNames": [ "CostSaving" ],
+              "groupNames": [
+                "CostSaving"
+              ],
               "parameters": {
                 "listOfAllowedSKUs": {
                   "value": [
@@ -95,7 +101,9 @@
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
               "policyDefinitionReferenceId": "Resource_Naming",
-              "groupNames": [ "Organizational" ],
+              "groupNames": [
+                "Organizational"
+              ],
               "parameters": {
                 "prefix": {
                   "value": "DeptA"
@@ -137,7 +145,9 @@
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
               "policyDefinitionReferenceId": "Limit_Skus",
-              "groupNames": [ "CostSaving" ],
+              "groupNames": [
+                "CostSaving"
+              ],
               "parameters": {
                 "listOfAllowedSKUs": {
                   "value": [
@@ -150,7 +160,9 @@
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
               "policyDefinitionReferenceId": "Resource_Naming",
-              "groupNames": [ "Organizational" ],
+              "groupNames": [
+                "Organizational"
+              ],
               "parameters": {
                 "prefix": {
                   "value": "DeptA"

diff --git a/...ce-manager/Microsoft.Authorization/stable/2019-09-01/examples/getPolicySetDefinition.json b/...ce-manager/Microsoft.Authorization/stable/2019-09-01/examples/getPolicySetDefinition.json
@@ -33,7 +33,9 @@
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
               "policyDefinitionReferenceId": "Limit_Skus",
-              "groupNames": [ "CostSaving" ],
+              "groupNames": [
+                "CostSaving"
+              ],
               "parameters": {
                 "listOfAllowedSKUs": {
                   "value": [
@@ -46,7 +48,9 @@
             {
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
               "policyDefinitionReferenceId": "Resource_Naming",
-              "groupNames": [ "Organizational" ],
+              "groupNames": [
+                "Organizational"
+              ],
               "parameters": {
                 "prefix": {
                   "value": "DeptA"

diff --git a/...rce-manager/Microsoft.Authorization/stable/2019-09-01/examples/listPolicyAssignments.json b/...rce-manager/Microsoft.Authorization/stable/2019-09-01/examples/listPolicyAssignments.json
@@ -28,7 +28,7 @@
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/storageSkus",
               "parameters": {
                 "allowedSkus": {
-                  "type": "Array"
+                  "value": "Standard_A1"
                 }
               },
               "scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2",

diff --git a/.../Microsoft.Authorization/stable/2019-09-01/examples/listPolicyAssignmentsForResource.json b/.../Microsoft.Authorization/stable/2019-09-01/examples/listPolicyAssignmentsForResource.json
@@ -32,7 +32,7 @@
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/vmSkus",
               "parameters": {
                 "allowedSkus": {
-                  "type": "Array"
+                  "value": "Standard_A1"
                 }
               },
               "scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup",

diff --git a/...osoft.Authorization/stable/2019-09-01/examples/listPolicyAssignmentsForResourceGroup.json b/...osoft.Authorization/stable/2019-09-01/examples/listPolicyAssignmentsForResourceGroup.json
@@ -29,7 +29,7 @@
               "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/storageSkus",
               "parameters": {
                 "allowedSkus": {
-                  "type": "Array"
+                  "value": "Standard_A1"
                 }
               },
               "scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup",

diff --git a/...sources/resource-manager/Microsoft.Authorization/stable/2019-09-01/policyAssignments.json b/...sources/resource-manager/Microsoft.Authorization/stable/2019-09-01/policyAssignments.json
@@ -566,16 +566,16 @@
           "description": "The policy's excluded scopes."
         },
         "parameters": {
-          "type": "object",
-          "description": "Required if a parameter is used in policy rule."
+          "description": "The parameter values for the assigned policy rule. The keys are the parameter names.",
+          "$ref": "#/definitions/ParameterValues"
         },
         "description": {
           "type": "string",
           "description": "This message will be part of response in case of policy violation."
         },
         "metadata": {
           "type": "object",
-          "description": "The policy assignment metadata."
+          "description": "The policy assignment metadata. Metadata is an open ended object and is typically a collection of key value pairs."
         },
         "enforcementMode": {
           "type": "string",
@@ -602,6 +602,19 @@
       },
       "description": "The policy assignment properties."
     },
+    "ParameterValues": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "value": {
+            "description": "The value of the parameter.",
+            "type": "object"
+          }
+        }
+      },
+      "description": "The parameter values for the policy rule. The keys are the parameter names."
+    },
     "PolicySku": {
       "properties": {
         "name": {

diff --git a/...sources/resource-manager/Microsoft.Authorization/stable/2019-09-01/policyDefinitions.json b/...sources/resource-manager/Microsoft.Authorization/stable/2019-09-01/policyDefinitions.json
@@ -511,15 +511,69 @@
         },
         "metadata": {
           "type": "object",
-          "description": "The policy definition metadata."
+          "description": "The policy definition metadata.  Metadata is an open ended object and is typically a collection of key value pairs."
         },
         "parameters": {
-          "type": "object",
-          "description": "Required if a parameter is used in policy rule."
+          "description": "The parameter definitions for parameters used in the policy rule. The keys are the parameter names.",
+          "$ref": "#/definitions/ParameterDefinitions"
         }
       },
       "description": "The policy definition properties."
     },
+    "ParameterDefinitions": {
+      "description": "The parameter definitions for parameters used in the policy. The keys are the parameter names.",
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "description": "The data type of the parameter.",
+            "type": "string",
+            "enum": [
+              "String",
+              "Array",
+              "Object",
+              "Boolean",
+              "Integer",
+              "Float",
+              "DateTime"
+            ],
+            "x-ms-enum": {
+              "name": "parameterType",
+              "modelAsString": true
+            }
+          },
+          "allowedValues": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            },
+            "description": "The allowed values for the parameter."
+          },
+          "defaultValue": {
+            "type": "object",
+            "description": "The default value for the parameter if no value is provided."
+          },
+          "metadata": {
+            "type": "object",
+            "properties": {
+              "displayName": {
+                "type": "string",
+                "description": "The display name for the parameter."
+              },
+              "description": {
+                "type": "string",
+                "description": "The description of the parameter."
+              }
+            },
+            "additionalProperties": {
+              "type": "object"
+            },
+            "description": "General metadata for the parameter."
+          }
+        }
+      }
+    },
     "PolicyDefinition": {
       "properties": {
         "properties": {