Device Update - List Versions

Szolgáltatás:

Device Update

API-verzió:

2026-06-01

A megadott szolgáltatónak és névnek megfelelő frissítési verziók listájának lekérése.

GET https://{endpoint}/deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions?api-version=2026-06-01

Opcionális paraméterekkel:

GET https://{endpoint}/deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions?api-version=2026-06-01&filter={filter}

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string (url)	Az IoT Hub-fiók végpontjának eszközfrissítése (csak gazdagépnév, protokoll nélkül).
instanceId	path	True	string	Az IoT Hub-fiókpéldány-azonosító eszközfrissítése.
name	path	True	string	Frissítés neve.
provider	path	True	string	Frissítési szolgáltató.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.
filter	query		string	Nem kötelező szűrni a frissítéseket az isDeployable tulajdonság alapján.

Válaszok

Name	Típus	Description
200 OK	StringsList	A kérés sikeres volt.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
https://api.adu.microsoft.com/.default

Példák

DeviceUpdate_ListVersions

Mintakérelem

HTTP

GET https://contoso.api.adu.microsoft.com/deviceUpdate/blue/updates/providers/microsoft/names/adu/versions?api-version=2026-06-01

Mintaválasz

Állapotkód:

200

{
  "value": [
    "1.0.0.0",
    "1.0.0.1"
  ]
}

Definíciók

Name	Description
Error	Hiba részletei.
ErrorResponse	Gyakori hibaválasz.
InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
StringsList	A kiszolgáló lapozási támogatásával rendelkező sztringek listája.

Error

Tárgy

Hiba részletei.

Name	Típus	Description
code	string	Kiszolgáló által definiált hibakód.
details	Error[]	Hibatömb, amely a jelentett hibához vezetett.
innererror	InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
occurredDateTime	string (date-time)	A hiba bekövetkezésének dátuma és időpontja (UTC).
target	string	A hiba célpontja.

ErrorResponse

Tárgy

Gyakori hibaválasz.

Name	Típus	Description
error	Error	A hiba részletei.

InnerError

Tárgy

Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.

Name	Típus	Description
code	string	Pontosabb hibakód, mint amit a hiba tartalmazott.
errorDetail	string	A belső hiba vagy kivétel üzenete.
innerError	InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.

StringsList

Tárgy

A kiszolgáló lapozási támogatásával rendelkező sztringek listája.

Name	Típus	Description
nextLink	string	A következő oldalra mutató link.
value	string[]	A lapozható elemek gyűjteménye.