Updated get-machinesecuritystates-collection-windows-defender-advanced-threat-protection.md

windows/security/threat-protection/windows-defender-atp/get-machinesecuritystates-collection-windows-defender-advanced-threat-protection.md

@@ -0,0 +1,83 @@
+---
+title: Get machines security states collection API
+description: Retrieves a collection of machines security states.
+keywords: apis, graph api, supported apis, get, machine, security, state
+search.product: eADQiWindows 10XVcnh
+ms.prod: w10
+ms.mktglfcycl: deploy
+ms.sitesec: library
+ms.pagetype: security
+ms.author: leonidzh
+author: mjcaparas
+ms.localizationpriority: medium
+ms.date: 10/07/2018
+---
+
+# Get Machines security states collection API
+
+**Applies to:**
+
+- Windows Defender Advanced Threat Protection (Windows Defender ATP)
+
+Retrieves a collection of machines security states.
+
+## Permissions
+User needs read permissions.
+
+## HTTP request
+```
+GET /testwdatppreview/machinesecuritystates
+```
+
+## Request headers
+
+Header | Value 
+:---|:---
+Authorization | Bearer {token}. **Required**.
+Content type | application/json
+
+## Request body
+Empty
+
+## Response
+If successful - 200 OK.
+
+## Example
+
+**Request**
+
+Here is an example of the request.
+
+```
+GET https://graph.microsoft.com/testwdatppreview/machinesecuritystates
+Content-type: application/json
+```
+
+**Response**
+
+Here is an example of the response.
+Field *id* contains machine id and equal to the field *id** in machines info. 
+
+```
+HTTP/1.1 200 OK
+Content-type: application/json
+{
+    "@odata.context":"https://graph.microsoft-ppe.com/testwdatppreview/$metadata#MachineSecurityStates",
+    "@odata.count":444,
+    "@odata.nextLink":"https://graph.microsoft-ppe.com/testwdatppreview/machinesecuritystates?$skiptoken=[continuation token]",
+    "value":[
+        {
+            "id":"000050e1b4afeee3742489ede9ad7a3e16bbd9c4",
+            "build":14393,
+            "revision":2485,
+            "architecture":"Amd64",
+            "osVersion":"10.0.14393.2485.amd64fre.rs1_release.180827-1809",
+            "propertiesRequireAttention":[
+                "AntivirusNotReporting",
+                "EdrImpairedCommunications"
+            ]
+        },
+        …
+    ]
+}
+```