Updates - Get Operations

Dienst:

Device Update

API-Version:

2020-09-01

Ruft eine Liste aller Importupdatevorgänge ab. Abgeschlossene Vorgänge werden 7 Tage lang aufbewahrt, bevor sie automatisch gelöscht werden. Löschvorgänge werden von dieser API-Version nicht zurückgegeben.

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

Mit optionalen Parametern:

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations?$filter={$filter}&$top={$top}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountEndpoint	path	True	string	Kontoendpunkt.
instanceId	path	True	string	Konto instance Bezeichner.
$filter	query		string	Schränkt den zurückgegebenen Vorgangssatz ein. Es wird nur ein bestimmter Filter unterstützt: "status eq 'NotStarted' oder status eq 'Running'"
$top	query		integer int32	Gibt eine nicht negative ganze Zahl n an, die die Anzahl der elemente begrenzt, die von einer Auflistung zurückgegeben werden. Der Dienst gibt die Anzahl der verfügbaren Elemente zurück, die bis zu, aber nicht größer als der angegebene Wert n ist.

Antworten

Name	Typ	Beschreibung
200 OK	PageableListOfOperations	Vorgangsdetails.
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.

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_GetOperations

Beispielanforderung

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/operations

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "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:

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
PageableListOfOperations	Die Liste der Vorgänge mit Server paging-Unterstützung.
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.

PageableListOfOperations

Die Liste der Vorgänge mit Server paging-Unterstützung.

Name	Typ	Beschreibung
nextLink	string	Der Link zur nächsten Seite von Elementen.
value	Operation[]	Die Auflistung von auslagerungsfähigen Elementen.

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.