Freigeben über

Abrufen des Gerätebefehls status (veraltet)

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Ruft die status eines Befehls auf einem Gerät ab. Eine vollständige Liste der status Codes finden Sie unter Liste von actionStatus.

Achtung

Diese API ist veraltet und gibt am 30. September 2020 keine Daten mehr zurück.

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) Nicht unterstützt Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Device.Command Nicht verfügbar.
Anwendung Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

GET me/devices/{id}/commands/{id}

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Annehmen application/json

Antwort

HTTP/1.1 200 OK

  {
    "id": "0",
    "status": "requesting",
    "type": "null",
    "appServiceName": "null",
    "packageFamilyName": "null",
    "error": "null",
    "responsepayload": "null",
    "payload": "null",
    "permissionTicket": "null",
    "postBackUri": "null"
  }

Liste von actionStatus

  • wird angefordert, // Der Befehl wurde erstellt und wartet auf die Verarbeitung.
  • sentToTarget, // Befehl wurde an das Zielgerät gesendet
  • wird ausgeführt, // Das Zielgerät hat den Empfang des Befehls bestätigt und führt ihn aus.
  • completed, // Befehlsausführung abgeschlossen
  • failedToSend, // Fehler beim Senden des Befehls an das Zielgerät
  • executionFailed, // Fehler bei der Befehlsausführung
  • commandDropped, // Befehl vom Client gelöscht, wenn sich das Gerät im Zustand ConnectedStandby befindet
  • cancel, // Abbrechen des Befehls
  • cancelling, // Abbrechen des Befehls
  • canceled, // Befehl wurde abgebrochen
  • wiederholen, // Der Dienst versucht erneut, den Befehl an das Ziel zu senden.
  • abgelaufen, // Ablaufzeit der Befehlsverarbeitung überschritten
  • error, // Interner Fehler beim Verarbeiten des Befehls
  • custom // Custom status

Beispiel

In diesem Beispiel benötigen Sie die ID des Geräts und die ID des Befehls, der für das Gerät ausgegeben wurde. Die Geräte-ID wird zurückgegeben, wenn ein GET-Aufruf von /me/devicesausgegeben wird, und die Befehls-ID wird zurückgegeben, wenn ein POST-Aufruf für /me/devices/{id}/commandausgeführt wird.

Anforderung

Das folgende Beispiel zeigt die Antwort.

GET me/devices/{id}/commands/{id}
Authorization: Bearer Eaeou....
Content-Type: application/json; charset=utf-8

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK

{
  "value":
  {
    "id": "0158355AD4D680CC4E2994CC009EFFD7337D1335FCA6ED266…",
    "status": "completed",
    "type": null,
    "appServiceName": null,
    "packageFamilyName": null,
    "error": null,
    "permissionTicket": null,
    "postBackUri": null,
    "payload": null
  }
}

Abrufen der Befehlsnutzlast

Ruft eine Antwortnutzlast für eine bestimmte Aktion auf einem Gerät ab. Die Antwortnutzlast wird beim Abfragen eines App-Diensts zum Zurückführen von Daten verwendet.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Device.Command
Anwendung Nicht unterstützt

HTTP-Anforderung

GET me/devices/{id}/commands/{id}/responsePayload

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Annehmen application/json

Antwort

HTTP/1.1 200 OK

{
  "@odata.context": "https://graph.microsoft.com/devices/$metadata#microsoft.graph.PayloadResponse",
  "MsIgnoredParameter":0,
  "CreationDate":"date-time",
  "Type":"Ok"
}

Beispiel

In diesem Beispiel benötigen Sie die ID des Geräts und die ID des Befehls, der für das Gerät ausgegeben wurde. Die Geräte-ID wird zurückgegeben, wenn ein GET-Aufruf auf /me/devicesausgegeben wird, und die Befehls-ID wird zurückgegeben, wenn ein POST-Aufruf auf /me/devices/{id}/commandausgeführt wird.

Anforderung

Das folgende Beispiel zeigt die Antwort.

GET me/devices/{id}/commands/{id}
Authorization: Bearer Eaeou....
Content-Type: application/json; charset=utf-8

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK

{
  "@odata.context": "https://graph.microsoft.com/devices/$metadata#microsoft.graph.PayloadResponse",
  "MsIgnoredParameter":0,
  "CreationDate":"04/27/2017",
  "Type":"Ok"
}