Device Update - List Versions

Hizmet:

Device Update

API Sürümü:

2026-06-01

Belirtilen sağlayıcı ve adla eşleşen tüm güncelleştirme sürümlerinin listesini alın.

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (url)	IoT Hub hesabı uç noktası için Cihaz Güncelleştirmesi (yalnızca konak adı, protokol yok).
instanceId	path	True	string	IoT Hub hesap örneği tanımlayıcısı için Cihaz Güncelleştirmesi.
name	path	True	string	Adı güncelleştirin.
provider	path	True	string	Sağlayıcıyı güncelleştirin.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
filter	query		string	Güncelleştirmeleri isDeployable özelliğine göre filtrelemek için isteğe bağlıdır.

Yanıtlar

Name	Tür	Description
200 OK	StringsList	İstek başarılı oldu.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

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

Örnekler

DeviceUpdate_ListVersions

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:

200

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

Tanımlar

Name	Description
Error	Hata ayrıntıları.
ErrorResponse	Yaygın hata yanıtı.
InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
StringsList	Sunucu disk belleği desteğine sahip dizelerin listesi.

Error

Nesne

Hata ayrıntıları.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodu.
details	Error[]	Bildirilen hataya yol açan bir hata dizisi.
innererror	InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.
occurredDateTime	string (date-time)	Hatanın oluştuğu TARIH ve SAAT UTC.
target	string	Hatanın hedefi.

ErrorResponse

Nesne

Yaygın hata yanıtı.

Name	Tür	Description
error	Error	Hata ayrıntıları.

InnerError

Nesne

Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.

Name	Tür	Description
code	string	İçeren hata tarafından sağlanandan daha özel bir hata kodu.
errorDetail	string	İç hata veya özel durum iletisi.
innerError	InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.

StringsList

Nesne

Sunucu disk belleği desteğine sahip dizelerin listesi.

Name	Tür	Description
nextLink	string	Öğelerin sonraki sayfasına bağlantı.
value	string[]	Sayfalanabilir öğeler koleksiyonu.