Updates - Get Update

Usługa:

Device Update

Wersja interfejsu API:

2020-09-01

Pobierz określoną wersję aktualizacji.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountEndpoint	path	True	string	Punkt końcowy konta.
instanceId	path	True	string	Identyfikator wystąpienia konta.
name	path	True	string	Zaktualizuj nazwę.
provider	path	True	string	Aktualizuj dostawcę.
version	path	True	string	Aktualizacja wersji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
If-None-Match		string	Definiuje warunek If-None-Match. Operacja zostanie wykonana tylko wtedy, gdy element ETag na serwerze nie jest zgodny z tą wartością.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Update	Żądana wersja aktualizacji.
404 Not Found		Nie znaleziono.
429 Too Many Requests		Zbyt wiele żądań; Istnieje limit liczby operacji, które można wykonać w danym okresie.
Other Status Codes		Nie zmodyfikowano.

Zabezpieczenia

azure_auth_implicit

Przepływ niejawny OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

azure_auth_code

Przepływ kodu dostępu OAuth2 w usłudze Azure Active Directory

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Adres URL tokenu: https://login.microsoftonline.com/common/oauth2/v2.0/token

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

azure_auth_application

Przepływ aplikacji OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: application
Adres URL tokenu: https://login.microsoftonline.com/common/oauth2/v2.0/token

Zakresy

Nazwa	Opis
.default	zakres poświadczeń klienta

azure_auth_password

Przepływ haseł OAuth2 w usłudze Azure Active Directory

Typ: oauth2
Flow: password
Adres URL tokenu: https://login.microsoftonline.com/common/oauth2/v2.0/token

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Updates_GetUpdate

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

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\""
}

Kod stanu:

304

Kod stanu:

404

Kod stanu:

429

Definicje

Nazwa	Opis
Compatibility	Aktualizowanie informacji o zgodności.
Update	Aktualizowanie metadanych.
UpdateId	Aktualizowanie identyfikatora.

Compatibility

Aktualizowanie informacji o zgodności.

Nazwa	Typ	Opis
deviceManufacturer	string	Producent urządzenia, z który aktualizacja jest zgodna.
deviceModel	string	Model urządzenia, z który aktualizacja jest zgodna.

Update

Aktualizowanie metadanych.

Nazwa	Typ	Opis
compatibility	Compatibility[]	Lista informacji o zgodności aktualizacji.
createdDateTime	string	Data i godzina w formacie UTC utworzenia aktualizacji.
etag	string	Zaktualizuj element ETag.
importedDateTime	string	Data i godzina w formacie UTC podczas importowania aktualizacji.
installedCriteria	string	Ciąg interpretowany przez klienta usługi Device Update w celu określenia, czy aktualizacja jest zainstalowana na urządzeniu.
manifestVersion	string	Wersja schematu manifestu używana do importowania aktualizacji.
updateId	UpdateId	Aktualizowanie tożsamości.
updateType	string	Typ aktualizacji.

UpdateId

Aktualizowanie identyfikatora.

Nazwa	Typ	Opis
name	string	Zaktualizuj nazwę.
provider	string	Aktualizuj dostawcę.
version	string	Aktualizacja wersji.