Devices new api (#11368)

* Added new API for devices in IoT Security

* Fixed validation errors

* updated security readme

* changed operation id in devices api

* 1. Added parameter to the query section in the URI of the security devices.
2. Added new properties to the security device resource

* 1. added new properties to security devices.
2. added filter of Managed type to security devices

* changed naming of parameter in security devices

* Changed properties in security devices

Author: MichalHel

specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/devices.json

@@ -420,20 +420,17 @@
           "maximum": 100,
           "description": "risk score of the device."
         },
-        "sensorName": {
+        "sensors": {
           "readOnly": true,
-          "type": "string",
-          "description": "When the device is unmanaged, the sensor that scanned this device."
-        },
-        "siteName": {
-          "readOnly": true,
-          "type": "string",
-          "description": "The sensor site name."
+          "type": "array",
+          "description": "List of sensors that scanned this device.",
+          "items": {
+            "$ref": "#/definitions/Sensor"
+          }
         },
-        "zoneName": {
+        "site": {
           "readOnly": true,
-          "type": "string",
-          "description": "The sensor zone name."
+          "$ref": "#/definitions/Site"
         },
         "deviceStatus": {
           "readOnly": true,
@@ -601,6 +598,33 @@
           "description": "list of protocol identifiers."
         }
       }
+    },
+    "Sensor": {
+      "type": "object",
+      "description": "Sensor data",
+      "properties": {
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Sensor name"
+        },
+        "zone": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Zone Name."
+        }
+      }
+    },
+    "Site": {
+      "type": "object",
+      "description": "Site data",
+      "properties": {
+        "displayName": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Site display name"
+        }
+      }
     }
   },
   "parameters": {

specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevice.json

@@ -62,9 +62,15 @@
           "programmingState": "NotProgrammingDevice",
           "scanningFunctionality": "NotScannerDevice",
           "riskScore": 100,
-          "sensorName": "mySensor",
-          "siteName": "mySite",
-          "zoneName": "myZone",
+          "sensors": [
+            {
+              "name": "mySensorName",
+              "zone": "myZoneName"
+            }
+          ],
+          "site": {
+            "displayName": "mySite"
+          },
           "deviceStatus": "Active"
         }
       }

specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevicesListForHub.json

@@ -63,9 +63,15 @@
               "programmingState": "NotProgrammingDevice",
               "scanningFunctionality": "NotScannerDevice",
               "riskScore": 100,
-              "sensorName": "mySensor",
-              "siteName": "mySite",
-              "zoneName": "myZone",
+              "sensors": [
+                {
+                  "name": "mySensorName",
+                  "zone": "myZoneName"
+                }
+              ],
+              "site": {
+                "displayName": "mySite"
+              },
               "deviceStatus": "Active"
             }
           }

specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevicesListForSubscription.json

@@ -63,9 +63,15 @@
               "programmingState": "NotProgrammingDevice",
               "scanningFunctionality": "NotScannerDevice",
               "riskScore": 100,
-              "sensorName": "mySensor",
-              "siteName": "mySite",
-              "zoneName": "myZone",
+              "sensors": [
+                {
+                  "name": "mySensorName",
+                  "zone": "myZoneName"
+                }
+              ],
+              "site": {
+                "displayName": "mySite"
+              },
               "deviceStatus": "Active"
             }
           }