Add assesments & assessment metadata new API versions

specification/security/resource-manager/Microsoft.Security/stable/2021-06-01/examples/Assessments/DeleteAssessment_example.json

@@ -0,0 +1,11 @@
+{
+  "parameters": {
+    "api-version": "2021-06-01",
+    "resourceId": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2",
+    "assessmentName": "8bb8be0a-6010-4789-812f-e4d661c4ed0e"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}

specification/security/resource-manager/Microsoft.Security/stable/2021-06-01/examples/Assessments/GetAssessmentWithExpand_example.json

@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "api-version": "2021-06-01",
+    "resourceId": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2",
+    "assessmentName": "21300918-b2e3-0346-785f-c77ff57d243b",
+    "$expand": "links"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
+        "name": "21300918-b2e3-0346-785f-c77ff57d243b",
+        "type": "Microsoft.Security/assessments",
+        "properties": {
+          "resourceDetails": {
+            "source": "Azure",
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2"
+          },
+          "displayName": "Install endpoint protection solution on virtual machine scale sets",
+          "status": {
+            "code": "NotApplicable",
+            "cause": "OffByPolicy",
+            "description": "The effective policy for the assessment was evaluated to off - use Microsoft.Authorization/policyAssignments to turn this assessment on",
+            "statusChangeDate": "2021-04-12T09:07:18.6759138Z",
+            "firstEvaluationDate": "2021-04-12T09:07:18.6759138Z"
+          },
+          "additionalData": {
+            "linkedWorkspaceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"
+          },
+          "links": {
+            "azurePortalUri": "https://www.portal.azure.com/?fea#blade/Microsoft_Azure_Security/RecommendationsBlade/assessmentKey/21300918-b2e3-0346-785f-c77ff57d243b"
+          }
+        }
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/stable/2021-06-01/examples/Assessments/GetAssessment_example.json

@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "api-version": "2021-06-01",
+    "resourceId": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2",
+    "assessmentName": "21300918-b2e3-0346-785f-c77ff57d243b"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
+        "name": "21300918-b2e3-0346-785f-c77ff57d243b",
+        "type": "Microsoft.Security/assessments",
+        "properties": {
+          "resourceDetails": {
+            "source": "Azure",
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2"
+          },
+          "displayName": "Install endpoint protection solution on virtual machine scale sets",
+          "status": {
+            "code": "NotApplicable",
+            "cause": "OffByPolicy",
+            "description": "The effective policy for the assessment was evaluated to off - use Microsoft.Authorization/policyAssignments to turn this assessment on",
+            "statusChangeDate": "2021-04-12T09:07:18.6759138Z",
+            "firstEvaluationDate": "2021-04-12T09:07:18.6759138Z"
+          },
+          "additionalData": {
+            "linkedWorkspaceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"
+          }
+        }
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/stable/2021-06-01/examples/Assessments/ListAssessments_example.json

@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "api-version": "2021-06-01",
+    "scope": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
+            "name": "21300918-b2e3-0346-785f-c77ff57d243b",
+            "type": "Microsoft.Security/assessments",
+            "properties": {
+              "resourceDetails": {
+                "source": "Azure",
+                "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1"
+              },
+              "displayName": "Install endpoint protection solution on virtual machine scale sets",
+              "status": {
+                "code": "Healthy",
+                "statusChangeDate": "2021-04-12T09:07:18.6759138Z",
+                "firstEvaluationDate": "2021-04-12T09:07:18.6759138Z"
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
+            "name": "21300918-b2e3-0346-785f-c77ff57d243b",
+            "type": "Microsoft.Security/assessments",
+            "properties": {
+              "resourceDetails": {
+                "source": "Azure",
+                "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2"
+              },
+              "displayName": "Install endpoint protection solution on virtual machine scale sets",
+              "status": {
+                "code": "NotApplicable",
+                "cause": "OffByPolicy",
+                "description": "The effective policy for the assessment was evaluated to off - use Microsoft.Authorization/policyAssignments to turn this assessment on",
+                "statusChangeDate": "2021-04-12T09:07:18.6759138Z",
+                "firstEvaluationDate": "2021-04-12T09:07:18.6759138Z"
+              },
+              "additionalData": {
+                "linkedWorkspaceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/stable/2021-06-01/examples/Assessments/PutAssessment_example.json

@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "api-version": "2021-06-01",
+    "resourceId": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2",
+    "assessmentName": "8bb8be0a-6010-4789-812f-e4d661c4ed0e",
+    "assessment": {
+      "properties": {
+        "resourceDetails": {
+          "source": "Azure"
+        },
+        "status": {
+          "code": "Healthy"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/8bb8be0a-6010-4789-812f-e4d661c4ed0e",
+        "name": "8bb8be0a-6010-4789-812f-e4d661c4ed0e",
+        "type": "Microsoft.Security/assessments",
+        "properties": {
+          "resourceDetails": {
+            "source": "Azure",
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/8bb8be0a-6010-4789-812f-e4d661c4ed0e"
+          },
+          "displayName": "Install internal agent on VM",
+          "status": {
+            "code": "Healthy"
+          }
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/8bb8be0a-6010-4789-812f-e4d661c4ed0e",
+        "name": "8bb8be0a-6010-4789-812f-e4d661c4ed0e",
+        "type": "Microsoft.Security/assessments",
+        "properties": {
+          "resourceDetails": {
+            "source": "Azure",
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/8bb8be0a-6010-4789-812f-e4d661c4ed0e"
+          },
+          "displayName": "Install internal agent on VM",
+          "status": {
+            "code": "Healthy"
+          }
+        }
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/stable/2021-06-01/examples/AssessmentsMetadata/CreateAssessmentsMetadata_subscription_example.json

@@ -0,0 +1,52 @@
+{
+  "parameters": {
+    "api-version": "2021-06-01",
+    "subscriptionId": "0980887d-03d6-408c-9566-532f3456804e",
+    "assessmentMetadataName": "ca039e75-a276-4175-aebc-bcd41e4b14b7",
+    "assessmentMetadata": {
+      "properties": {
+        "displayName": "Install endpoint protection solution on virtual machine scale sets",
+        "description": "Install an endpoint protection solution on your virtual machines scale sets, to protect them from threats and vulnerabilities.",
+        "remediationDescription": "To install an endpoint protection solution: 1.  <a href=\"https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-faq#how-do-i-turn-on-antimalware-in-my-virtual-machine-scale-set\">Follow the instructions in How do I turn on antimalware in my virtual machine scale set</a>",
+        "categories": [
+          "Compute"
+        ],
+        "severity": "Medium",
+        "userImpact": "Low",
+        "implementationEffort": "Low",
+        "threats": [
+          "dataExfiltration",
+          "dataSpillage",
+          "maliciousInsider"
+        ],
+        "assessmentType": "CustomerManaged"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/providers/Microsoft.Security/assessmentMetadata/ca039e75-a276-4175-aebc-bcd41e4b14b7",
+        "name": "ca039e75-a276-4175-aebc-bcd41e4b14b7",
+        "type": "Microsoft.Security/assessmentMetadata",
+        "properties": {
+          "displayName": "My organization security assessment",
+          "description": "Assessment that my organization created to view our security assessment in Azure Security Center",
+          "remediationDescription": "Fix it with these remediation instructions",
+          "categories": [
+            "Compute"
+          ],
+          "severity": "Medium",
+          "userImpact": "Low",
+          "implementationEffort": "Low",
+          "threats": [
+            "dataExfiltration",
+            "dataSpillage",
+            "maliciousInsider"
+          ],
+          "assessmentType": "CustomerManaged"
+        }
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/stable/2021-06-01/examples/AssessmentsMetadata/DeleteAssessmentsMetadata_subscription_example.json

@@ -0,0 +1,10 @@
+{
+  "parameters": {
+    "api-version": "2021-06-01",
+    "subscriptionId": "0980887d-03d6-408c-9566-532f3456804e",
+    "assessmentMetadataName": "ca039e75-a276-4175-aebc-bcd41e4b14b7"
+  },
+  "responses": {
+    "200": {}
+  }
+}

specification/security/resource-manager/Microsoft.Security/stable/2021-06-01/examples/AssessmentsMetadata/GetAssessmentsMetadata_example.json

@@ -0,0 +1,47 @@
+{
+  "parameters": {
+    "api-version": "2021-06-01",
+    "assessmentMetadataName": "21300918-b2e3-0346-785f-c77ff57d243b"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/providers/Microsoft.Security/assessmentMetadata/21300918-b2e3-0346-785f-c77ff57d243b",
+        "name": "21300918-b2e3-0346-785f-c77ff57d243b",
+        "type": "Microsoft.Security/assessmentMetadata",
+        "properties": {
+          "displayName": "Install endpoint protection solution on virtual machine scale sets",
+          "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/26a828e1-e88f-464e-bbb3-c134a282b9de",
+          "description": "Install an endpoint protection solution on your virtual machines scale sets, to protect them from threats and vulnerabilities.",
+          "remediationDescription": "To install an endpoint protection solution: 1.  <a href=\"https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-faq#how-do-i-turn-on-antimalware-in-my-virtual-machine-scale-set\">Follow the instructions in How do I turn on antimalware in my virtual machine scale set</a>",
+          "categories": [
+            "Compute"
+          ],
+          "severity": "Medium",
+          "userImpact": "Low",
+          "implementationEffort": "Low",
+          "threats": [
+            "dataExfiltration",
+            "dataSpillage",
+            "maliciousInsider"
+          ],
+          "publishDates": {
+            "GA": "06/01/2021",
+            "public": "06/01/2021"
+          },
+          "plannedDeprecationDate": "03/2022",
+          "tactics": [
+            "credentialAccess",
+            "persistence",
+            "execution",
+            "defenseEvasion",
+            "collection",
+            "discovery",
+            "privilegeEscalation"
+          ],
+          "assessmentType": "BuiltIn"
+        }
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/stable/2021-06-01/examples/AssessmentsMetadata/GetAssessmentsMetadata_subscription_example.json

@@ -0,0 +1,48 @@
+{
+  "parameters": {
+    "api-version": "2021-06-01",
+    "subscriptionId": "0980887d-03d6-408c-9566-532f3456804e",
+    "assessmentMetadataName": "21300918-b2e3-0346-785f-c77ff57d243b"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/providers/Microsoft.Security/assessmentMetadata/21300918-b2e3-0346-785f-c77ff57d243b",
+        "name": "21300918-b2e3-0346-785f-c77ff57d243b",
+        "type": "Microsoft.Security/assessmentMetadata",
+        "properties": {
+          "displayName": "Install endpoint protection solution on virtual machine scale sets",
+          "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/26a828e1-e88f-464e-bbb3-c134a282b9de",
+          "description": "Install an endpoint protection solution on your virtual machines scale sets, to protect them from threats and vulnerabilities.",
+          "remediationDescription": "To install an endpoint protection solution: 1.  <a href=\"https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-faq#how-do-i-turn-on-antimalware-in-my-virtual-machine-scale-set\">Follow the instructions in How do I turn on antimalware in my virtual machine scale set</a>",
+          "categories": [
+            "Compute"
+          ],
+          "severity": "Medium",
+          "userImpact": "Low",
+          "implementationEffort": "Low",
+          "threats": [
+            "dataExfiltration",
+            "dataSpillage",
+            "maliciousInsider"
+          ],
+          "publishDates": {
+            "GA": "06/01/2021",
+            "public": "06/01/2021"
+          },
+          "plannedDeprecationDate": "03/2022",
+          "tactics": [
+            "credentialAccess",
+            "persistence",
+            "execution",
+            "defenseEvasion",
+            "collection",
+            "discovery",
+            "privilegeEscalation"
+          ],
+          "assessmentType": "BuiltIn"
+        }
+      }
+    }
+  }
+}