Abrufen des Gerätebefehlsstatus (veraltet)

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Rufen Sie den Status eines Befehls auf einem Gerät ab. Eine vollständige Liste der Statuscodes finden Sie unter "Liste der Aktionsstatus".

Achtung

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

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema 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
Application	Nicht unterstützt

HTTP-Anforderung

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

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich.
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 der actionStatus

• anfordern, / Befehl wurde erstellt und wartet darauf, verarbeitet zu werden
• sentToTarget, / Befehl wurde an das Zielgerät gesendet
• executing, / Target device acknowledged receipt of the command and is executing it
• abgeschlossen, / Befehlsausführung abgeschlossen
• failedToSend, / Dienst konnte Befehl nicht an Zielgerät senden
• executionFailed, / Befehlsausführung fehlgeschlagen
• commandDropped, / Command dropped by client if device is in ConnectedStandby state
• cancel, / Cancel the command
• cancelling, / Cancelling the command
• canceled, / Command has been cancelled
• retry, / Service is retrying to send command to target
• expired, / Command processing exceeded expiry time
• error, / Interner Fehler während der Verarbeitung des Befehls
• custom / Benutzerdefinierter Status

Beispiel

In diesem Beispiel benötigen Sie die ID des Geräts und die ID des Befehls, der an ein Gerät ausgegeben wurde. Die Geräte-ID wird zurückgegeben, wenn ein GET-Aufruf gesendet /me/devices wird, und die Befehls-ID wird zurückgegeben, wenn ein POST-Aufruf ausgeführt /me/devices/{id}/command 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

Rufen Sie eine Antwortnutzlast für eine bestimmte Aktion auf einem Gerät ab. Die Antwortnutzlast wird beim Abfragen eines App-Diensts zum Übertragen 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 im Artikel zum Thema 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
Application	Nicht unterstützt

HTTP-Anforderung

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

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich.
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 an ein Gerät ausgegeben wurde. Die Geräte-ID wird zurückgegeben, wenn ein GET-Aufruf ausgegeben /me/devices wird, und die Befehls-ID wird zurückgegeben, wenn ein POST-Aufruf ausgeführt /me/devices/{id}/command 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"
}