device: delta

  • [アーティクル]

名前空間: microsoft.graph

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

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

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

アクセス許可

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

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

HTTP 要求

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

GET /devices/delta

クエリ パラメーター

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

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

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

このメソッドは、応答をカスタマイズするための 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 応答に URL が含まれるまで@odata.deltaLink、@odata.nextLinkデバイスは URL を使用して要求を行い続けます。
  • URL が返される場合、返されるリソースの既存の状態に関するデータはありません。 URL を @odata.deltaLink 永続化して使用して、今後のリソースの変更について学習します。

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

例

要求

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=="
        }
      ]
    }
  ]
}