Get deviceManagement

名前空間: microsoft.graph

大事な： Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。

注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

deviceManagement オブジェクトのプロパティとリレーションシップを読み取ります。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	✅	✅	✅

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 (ワークフロー別)	アクセス許可 (特権の大きいものから小さいものへ)
委任 (職場または学校のアカウント)
Android for Work	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
監査	DeviceManagementApps.ReadWrite.All、DeviceManagementApps.Read.All
会社の用語	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
デバイス構成	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
デバイスの意図	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
デバイスの管理	DeviceManagementManagedDevices.ReadWrite.All、DeviceManagementManagedDevices.Read.All
電子 SIM	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
登録	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
フェンシング	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
Notification	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
Odj	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
オンボーディング	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
ポリシー セット	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
Rbac	DeviceManagementRBAC.ReadWrite.All、DeviceManagementRBAC.Read.All
リモート アクセス	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
リモート アシスタンス	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
ソフトウェア更新プログラム	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
通信経費管理	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
トラブルシューティング	DeviceManagementManagedDevices.ReadWrite.All、DeviceManagementManagedDevices.Read.All
Windows 情報保護	DeviceManagementApps.ReadWrite.All、DeviceManagementApps.Read.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション
Android for Work	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
監査	DeviceManagementApps.ReadWrite.All、DeviceManagementApps.Read.All
会社の用語	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
デバイス構成	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
デバイスの意図	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
デバイスの管理	DeviceManagementManagedDevices.ReadWrite.All、DeviceManagementManagedDevices.Read.All
電子 SIM	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
登録	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
フェンシング	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
Notification	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
Odj	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
オンボーディング	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
ポリシー セット	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
Rbac	DeviceManagementRBAC.ReadWrite.All、DeviceManagementRBAC.Read.All
リモート アクセス	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementConfiguration.Read.All
リモート アシスタンス	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
ソフトウェア更新プログラム	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
通信経費管理	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementServiceConfig.Read.All
トラブルシューティング	DeviceManagementManagedDevices.ReadWrite.All、DeviceManagementManagedDevices.Read.All
Windows 情報保護	DeviceManagementApps.ReadWrite.All、DeviceManagementApps.Read.All

HTTP 要求

GET /deviceManagement

オプションのクエリ パラメーター

このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。

要求ヘッダー

ヘッダー	値
Authorization	ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
承諾	application/json

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で deviceManagement オブジェクトを返します。

例

要求

以下は、要求の例です。

GET https://graph.microsoft.com/beta/deviceManagement

応答

応答の例を次に示します。

注: ここに示されている応答オブジェクトは、簡潔にするために切り捨てられる場合があります。

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 130

{
  "value": {
    "@odata.type": "#microsoft.graph.deviceManagement",
    "id": "0b283420-3420-0b28-2034-280b2034280b"
  }
}

ワークフローに適したプロパティが返されます。

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 918

{
  "value": {
    "@odata.type": "#microsoft.graph.deviceManagement",
    "id": "0b283420-3420-0b28-2034-280b2034280b",
    "subscriptionState": "active",
    "subscriptions": "intune",
    "adminConsent": {
      "@odata.type": "microsoft.graph.adminConsent",
      "shareAPNSData": "granted"
    },
    "deviceProtectionOverview": {
      "@odata.type": "microsoft.graph.deviceProtectionOverview",
      "totalReportedDeviceCount": 8,
      "inactiveThreatAgentDeviceCount": 14,
      "unknownStateThreatAgentDeviceCount": 2,
      "pendingSignatureUpdateDeviceCount": 1,
      "cleanDeviceCount": 0,
      "pendingFullScanDeviceCount": 10,
      "pendingRestartDeviceCount": 9,
      "pendingManualStepsDeviceCount": 13,
      "pendingOfflineScanDeviceCount": 13,
      "criticalFailuresDeviceCount": 11
    },
    "accountMoveCompletionDateTime": "2017-01-01T00:01:17.9006709-08:00"
  }
}