Updates - Get Operation

Dienst:

Device Update

API-Version:

2020-09-01

Abrufvorgang status.

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations/{operationId}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountEndpoint	path	True	string	Kontoendpunkt.
instanceId	path	True	string	Konto instance Bezeichner.
operationId	path	True	string	Vorgangsbezeichner.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
If-None-Match		string	Definiert die Bedingung If-None-Match. Der Vorgang wird nur ausgeführt, wenn das ETag auf dem Server nicht mit diesem Wert übereinstimmt.

Antworten

Name	Typ	Beschreibung
200 OK	Operation	Vorgangsstatus Header Retry-After: string
404 Not Found		Nicht gefunden:
429 Too Many Requests		Zu viele Anfragen; es gibt eine Ratenbegrenzung für die Anzahl von Vorgängen, die innerhalb eines Zeitraums ausgeführt werden können.
Other Status Codes		Nicht geändert.

Sicherheit

azure_auth_implicit

Impliziter Azure Active Directory OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

azure_auth_code

Azure Active Directory OAuth2 AccessCode-Flow

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token-URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

azure_auth_application

Azure Active Directory OAuth2-Anwendungsflow

Typ: oauth2
Ablauf: application
Token-URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Bereiche

Name	Beschreibung
.default	Clientanmeldeinformationsbereich

azure_auth_password

Azure Active Directory OAuth2-Kennwortfluss

Typ: oauth2
Ablauf: password
Token-URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Updates_GetOperation

Beispielanforderung

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f

Beispiel für eine Antwort

Statuscode:

200

{
  "operationId": "e4491c54-916f-443d-9094-bcca546ace2f",
  "status": "Succeeded",
  "resourceLocation": "/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0",
  "traceId": "2b881ef9deaf5d45b0a716ca5b4145ec",
  "createdDateTime": "2020-04-22T21:00:53.2548897+00:00",
  "lastActionDateTime": "2020-04-22T21:01:43.9401420+00:00",
  "etag": "\"a0f7b6f2-3f6c-4eb6-8a59-2f5411c23888\""
}

Statuscode:

304

Statuscode:

404

Statuscode:

429

Definitionen

Name	Beschreibung
Error	Fehlerdetails.
InnerError	Ein -Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
Operation	Vorgangsmetadaten.
OperationStatus	Vorgangsstatus
UpdateId	Aktualisieren Sie den Bezeichner.

Error

Fehlerdetails.

Name	Typ	Beschreibung
code	string	Serverdefinierter Fehlercode.
details	Error[]	Ein Array von Fehlern, die zum gemeldeten Fehler geführt haben.
innererror	InnerError	Ein -Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.
occurredDateTime	string	Datum und Uhrzeit in UTC, wann der Fehler aufgetreten ist.
target	string	Das Ziel des Fehlers.

InnerError

Ein -Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.

Name	Typ	Beschreibung
code	string	Ein spezifischerer Fehlercode als der, der vom enthaltenden Fehler bereitgestellt wurde.
errorDetail	string	Die interne Fehler- oder Ausnahmemeldung.
innerError	InnerError	Ein -Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.

Operation

Vorgangsmetadaten.

Name	Typ	Beschreibung
createdDateTime	string	Datum und Uhrzeit in UTC, als der Vorgang erstellt wurde.
error	Error	Vorgangsfehler, falls vorhanden.
etag	string	Vorgang ETag.
lastActionDateTime	string	Datum und Uhrzeit in UTC, zu dem der Vorgang status zuletzt aktualisiert wurde.
operationId	string	Vorgangs-ID.
resourceLocation	string	Speicherort des importierten Updates, wenn der Vorgang erfolgreich ist.
status	OperationStatus	Vorgangsstatus
traceId	string	Vorgangskorrelationsidentität, die von Microsoft-Support für die Problembehandlung verwendet werden kann.
updateId	UpdateId	Die Identität des Updates, das importiert oder gelöscht wird. Beim Import wird diese Eigenschaft erst aufgefüllt, nachdem das Importmanifest erfolgreich verarbeitet wurde.

OperationStatus

Vorgangsstatus

Name	Typ	Beschreibung
Failed	string	Der Hintergrundvorgang wurde mit einem Fehler abgeschlossen.
NotStarted	string	Hintergrundvorgang erstellt, aber noch nicht gestartet.
Running	string	Der Hintergrundvorgang wird derzeit ausgeführt.
Succeeded	string	Der Hintergrundvorgang wurde erfolgreich abgeschlossen.
Undefined	string	Undefined operation status.

UpdateId

Aktualisieren Sie den Bezeichner.

Name	Typ	Beschreibung
name	string	Aktualisieren Sie den Namen.
provider	string	Aktualisieren des Anbieters.
version	string	Aktualisieren Sie die Version.