次の方法で共有

device: delta

名前空間: microsoft.graph

リソース コレクション全体の完全な読み取りを実行せずに、新しく作成、更新、または削除されたデバイスを取得します。 詳細については、「 デルタ クエリを使用して Microsoft Graph データの変更を追跡する 」を参照してください。

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

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

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) Device.Read.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Device.Read.All 注意事項なし。

重要

職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、サポートされているMicrosoft Entraロールまたはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。 この操作では、次の最小特権ロールがサポートされています。

  • ユーザー
  • ディレクトリ リーダー
  • ディレクトリ製作者
  • コンプライアンス管理者
  • デバイス マネージャー
  • アプリケーション管理者
  • セキュリティ閲覧者
  • セキュリティ管理者
  • 特権ロール管理者
  • クラウド アプリケーション管理者
  • カスタマー ロックボックス アクセス承認者
  • Dynamics 365管理者
  • Power BI 管理者
  • Desktop Analytics管理者
  • Microsoft マネージド デスクトップ管理者
  • Teams 通信管理者
  • Teams 通信サポート エンジニア
  • Teams 通信サポート スペシャリスト
  • Teams 管理者
  • コンプライアンス データ管理者
  • セキュリティ オペレーター
  • Kaizala 管理者
  • グローバル閲覧者
  • ディレクトリレビュー担当者
  • Windows 365 管理者

HTTP 要求

変更の追跡を開始するには、 デバイス リソースの delta 関数を含む要求を行います。

GET /devices/delta

クエリ パラメーター

変更を追跡すると、1 つ以上の デルタ 関数呼び出しのラウンドが発生します。 $deltatokenおよび$skiptoken以外のクエリ パラメーターを使用するには、最初のデルタ要求で指定する必要があります。Microsoft Graph は、指定したパラメーターを応答で指定された@odata.nextLinkまたは@odata.deltaLink URL の$deltatoken部分に自動的にエンコードします。

クエリ パラメーター 種類 説明
$deltatoken string 同じリソース コレクションに対する前のデルタ関数呼び出しの@odata.deltaLink URL で返された状態トークン。変更追跡のラウンドの完了を示します。 このコレクションについて、このトークンを含む、@odata.deltaLink URL 全体を次の変更追跡のラウンドの最初の要求に保存し、適用します。
$skiptoken string 前のデルタ関数呼び出しの@odata.nextLink URL で返された状態トークン。同じリソース コレクションで追跡する変更が追加されていることを示します。

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

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

  • $select クエリ パラメーターを使用して、最適なパフォーマンスを得るために必要なプロパティのみを指定できます。 id プロパティは常に返されます。
  • $filterのサポートは限られています。 サポートされている $filter 式は、ID ( $filter=id+eq+'{value}' または $filter=id+eq+'{value1}'+or+id+eq+'{value2}') によって、特定のリソースの変更を追跡することです。 指定できる ID の数は、URL の最大長によって制限されます。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。

要求本文

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

応答

成功した場合、このメソッドは 200 OK 応答コードと応答本文内の デバイス オブジェクトのコレクションを返します。 応答には @odata.nextLink URL または @odata.deltaLink URLも含まれます。

  • URL が返される場合は、セッションに取得するデータの追加ページがあります。@odata.nextLink デバイスは、応答に@odata.deltaLink URL が含まれるまで、@odata.nextLink URL を使用して要求を行い続けます。
  • URL が返される場合、返されるリソースの既存の状態に関するデータはありません。 @odata.deltaLink URL を永続化して使用して、今後のリソースの変更について学習します。

情報の詳細については、「 デルタ クエリの使用」を参照してください。 要求の例については、「 ユーザーの増分変更を取得する」を参照してください。

例

要求

GET https://graph.microsoft.com/v1.0/devices/delta

応答

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#devices",
  "@odata.nextLink":"https://graph.microsoft.com/v1.0/devices/delta?$skiptoken=pqwSUjGYvb3jQpbwVAwEL7yuI3dU1LecfkkfLPtnIjsXoYQp_dpA3cNJWc",
  "value": [
    {
      "accountEnabled": false,
      "createdDateTime": "2022-05-05T20:56:06Z",
      "deviceId": "4c299165-6e8f-4b45-a5ba-c5d250a707ff",
      "displayName": "Test device",
      "operatingSystem": "linux",
      "operatingSystemVersion": "1",
      "id": "c9d9f9b3-0c91-4080-b392-78f775903b3a",
      "alternativeSecurityIds": [
        {
          "type": 2,
          "identityProvider": null,
          "key": "base64Y3YxN2E1MWFlYw=="
        }
      ]
    }
  ]
}
  • Last updated on