Updates - Get Update

Dienst:

Device Update

API-Version:

2020-09-01

Rufen Sie eine bestimmte Updateversion ab.

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/providers/{provider}/names/{name}/versions/{version}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountEndpoint	path	True	string	Kontoendpunkt.
instanceId	path	True	string	Konto instance Bezeichner.
name	path	True	string	Aktualisieren Sie den Namen.
provider	path	True	string	Aktualisieren des Anbieters.
version	path	True	string	Aktualisieren Sie die Version.

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	Update	Die angeforderte Updateversion.
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_GetUpdate

Beispielanforderung

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0

Beispiel für eine Antwort

Statuscode:

200

{
  "updateId": {
    "provider": "microsoft",
    "name": "adu",
    "version": "1.0.0.0"
  },
  "updateType": "image",
  "installedCriteria": "SwVer=5",
  "compatibility": [
    {
      "deviceManufacturer": "Microsoft",
      "deviceModel": "Toaster"
    }
  ],
  "manifestVersion": "0.1",
  "importedDateTime": "2020-04-22T21:01:43.8408797+00:00",
  "createdDateTime": "2019-09-12T00:00:00.0000000+00:00",
  "etag": "\"3fed3378-0c67-47d2-b796-296962c66cbb\""
}

Statuscode:

304

Statuscode:

404

Statuscode:

429

Definitionen

Name	Beschreibung
Compatibility	Aktualisieren der Kompatibilitätsinformationen.
Update	Metadaten aktualisieren.
UpdateId	Aktualisieren Sie den Bezeichner.

Compatibility

Aktualisieren der Kompatibilitätsinformationen.

Name	Typ	Beschreibung
deviceManufacturer	string	Der Hersteller des Geräts, mit dem das Update kompatibel ist.
deviceModel	string	Das Modell des Geräts, mit dem das Update kompatibel ist.

Update

Metadaten aktualisieren.

Name	Typ	Beschreibung
compatibility	Compatibility[]	Liste der Updatekompatibilitätsinformationen.
createdDateTime	string	Datum und Uhrzeit in UTC, wann das Update erstellt wurde.
etag	string	ETag aktualisieren.
importedDateTime	string	Datum und Uhrzeit in UTC, wann das Update importiert wurde.
installedCriteria	string	Zeichenfolge, die vom Device Update-Client interpretiert wird, um zu bestimmen, ob das Update auf dem Gerät installiert ist.
manifestVersion	string	Schemaversion des Manifests, das zum Importieren des Updates verwendet wird.
updateId	UpdateId	Update-Identität.
updateType	string	Updatetyp.

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.