Updates - Get Update

Tjänst:

Device Update

API-version:

2020-09-01

Hämta en specifik uppdateringsversion.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountEndpoint	path	True	string	Kontoslutpunkt.
instanceId	path	True	string	Kontoinstansidentifierare.
name	path	True	string	Uppdateringsnamn.
provider	path	True	string	Uppdatera provider.
version	path	True	string	Uppdatera version.

Begärandehuvud

Name	Obligatorisk	Typ	Description
If-None-Match		string	Definierar villkoret If-None-Match. Åtgärden utförs endast om ETag på servern inte matchar det här värdet.

Svar

Name	Typ	Description
200 OK	Update	Den begärda uppdateringsversionen.
404 Not Found		Hittades inte.
429 Too Many Requests		För många begäranden; det finns en hastighetsgräns för hur många åtgärder som kan utföras inom en tidsperiod.
Other Status Codes		Har inte ändrats.

Säkerhet

azure_auth_implicit

Implicit flöde i Azure Active Directory OAuth2

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

azure_auth_code

Azure Active Directory OAuth2 AccessCode Flow

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token-webbadress: https://login.microsoftonline.com/common/oauth2/v2.0/token

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

azure_auth_application

Azure Active Directory OAuth2-programflöde

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

Omfattningar

Name	Description
.default	omfång för klientautentiseringsuppgifter

azure_auth_password

Azure Active Directory OAuth2-lösenordsflöde

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

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Updates_GetUpdate

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:

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

Statuskod:

304

Statuskod:

404

Statuskod:

429

Definitioner

Name	Description
Compatibility	Uppdatera kompatibilitetsinformation.
Update	Uppdatera metadata.
UpdateId	Uppdateringsidentifierare.

Compatibility

Uppdatera kompatibilitetsinformation.

Name	Typ	Description
deviceManufacturer	string	Tillverkaren av enheten som uppdateringen är kompatibel med.
deviceModel	string	Enhetsmodellen som uppdateringen är kompatibel med.

Update

Uppdatera metadata.

Name	Typ	Description
compatibility	Compatibility[]	Lista över uppdateringskompatibilitetsinformation.
createdDateTime	string	Datum och tid i UTC när uppdateringen skapades.
etag	string	Uppdatera ETag.
importedDateTime	string	Datum och tid i UTC när uppdateringen importerades.
installedCriteria	string	Sträng som tolkas av enhetsuppdateringsklienten för att avgöra om uppdateringen är installerad på enheten.
manifestVersion	string	Schemaversion av manifestet som används för att importera uppdateringen.
updateId	UpdateId	Uppdatera identitet.
updateType	string	Uppdateringstyp.

UpdateId

Uppdateringsidentifierare.

Name	Typ	Description
name	string	Uppdateringsnamn.
provider	string	Uppdatera provider.
version	string	Uppdatera version.