获取设备

获取 device 对象的属性和关系。

先决条件

要执行此 API,需要以下范围之一:Directory.Read.AllDirectory.ReadWrite.AllDirectory.AccessAsUser.AllDevice.ReadWrite.All

HTTP 请求

GET /devices/{id}

注意:请求中的“id”是设备的“id”属性,不是“deviceId”属性。

可选的查询参数

此方法支持 OData 查询参数 来帮助自定义响应。

请求标头

名称 类型 说明
Authorization string Bearer . Required.

请求正文

请勿提供此方法的请求正文。

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和 device 对象。

示例

请求

下面是一个请求示例。

GET https://graph.microsoft.com/v1.0/devices/{id}
响应

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

HTTP/1.1 200 OK
Content-type: application/json

{
  "accountEnabled":false,
  "alternativeSecurityIds":
  [
    {
      "type": 2,
      "key":"Y3YxN2E1MWFlYw==",
      "identityProvider": null
    }
  ],
  "deviceId":"4c299165-6e8f-4b45-a5ba-c5d250a707ff",
  "displayName":"Test device",
  "id": "id-value",
  "operatingSystem":"linux",
  "operatingSystemVersion":"1"
}