device: delta
Namespace: microsoft.graph
Rufen Sie neu erstellte, aktualisierte oder gelöschte Geräte ab, ohne die gesamte Ressourcensammlung vollständig zu lesen. Weitere Informationen finden Sie unter Verwenden von Deltaabfragen.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Device.Read.All | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Device.Read.All | Nicht verfügbar. |
HTTP-Anforderung
Um mit der Nachverfolgung von Änderungen zu beginnen, stellen Sie eine Anforderung einschließlich der Delta-Funktion für die Geräteressource .
GET /devices/delta
Abfrageparameter
Das Nachverfolgen von Änderungen verursacht eine Runde von einem oder mehreren Deltafunktionsaufrufen. Um einen anderen Abfrageparameter als $deltatoken
und $skiptoken
zu verwenden, müssen Sie ihn in der anfänglichen Deltaanforderung angeben. Microsoft Graph codiert automatisch alle angegebenen Parameter in den $deltatoken
Teil der in der @odata.nextLink
Antwort angegebenen URL oder @odata.deltaLink
der URL.
Abfrageparameter | Typ | Beschreibung |
---|---|---|
$deltatoken | string | Ein Zustandstoken, das in der @odata.deltaLink URL des vorherigen Delta-Funktionsaufrufs für dieselbe Ressourcensammlung zurückgegeben wird und den Abschluss dieser Änderungsnachverfolgungsrunde angibt. Speichern Sie die gesamte @odata.deltaLink -URL einschließlich dieses Tokens, und wenden Sie sie in der ersten Anforderung der nächsten Änderungsnachverfolgungsrunde für diese Sammlung an. |
$skiptoken | string | Ein Zustandstoken, das in der @odata.nextLink URL des vorherigen Delta-Funktionsaufrufs zurückgegeben wird und angibt, dass weitere Änderungen in derselben Ressourcensammlung nachverfolgt werden müssen. |
Optionale Abfrageparameter
Diese Methode unterstützt OData-Abfrageparameter zur Anpassung der Antwort.
- Sie können den
$select
Abfrageparameter verwenden, um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die Eigenschaft id wird immer zurückgegeben. - Es gibt eingeschränkte Unterstützung für
$filter
. Der einzige unterstützte$filter
Ausdruck ist für die Nachverfolgung von Änderungen für bestimmte Ressourcen anhand ihrer ID:$filter=id+eq+'{value}'
oder$filter=id+eq+'{value1}'+or+id+eq+'{value2}'
. Die Anzahl der IDs, die Sie angeben können, ist durch die maximale URL-Länge begrenzt.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, werden der 200 OK
Antwortcode und eine Sammlung von Geräteobjekten im Antworttext zurückgegeben. Die Antwort enthält auch eine @odata.nextLink
-URL oder eine @odata.deltaLink
-URL.
- Wenn eine
@odata.nextLink
-URL zurückgegeben wird, gibt es zusätzliche Seiten mit Daten, die in der Sitzung abgerufen werden müssen. Das Gerät stellt weiterhin Anforderungen mithilfe der@odata.nextLink
URL, bis eine@odata.deltaLink
URL in der Antwort enthalten ist. - Wenn eine
@odata.deltaLink
-URL zurückgegeben wird, gibt es keine weiteren Daten über den derzeitigen Status der zurückzugebenden Ressource. Speichern Sie die@odata.deltaLink
URL, und verwenden Sie sie, um sich über zukünftige Änderungen an der Ressource zu informieren.
Weitere Informationen finden Sie unter Verwenden von Deltaabfragen. Beispielanforderungen finden Sie unter Abrufen inkrementeller Änderungen für Benutzer.
Beispiel
Anforderung
GET https://graph.microsoft.com/v1.0/devices/delta
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
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=="
}
]
}
]
}