Updates - Import Update

Hizmet:

Device Update

API Sürümü:

2020-09-01

Yeni güncelleştirme sürümünü içeri aktar.

POST https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates?action=import

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
accountEndpoint	path	True	string	Hesap uç noktası.
instanceId	path	True	string	Hesap örneği tanımlayıcısı.
action	query	True	ImportAction	Güncelleştirme eylemini içeri aktar.

İstek Gövdesi

Name	Gerekli	Tür	Description
files	True	FileImportMetadata[]	Dosya adı ve kaynak URL gibi bir veya daha fazla güncelleştirme dosyası özelliği.
importManifest	True	ImportManifestMetadata	Kaynak URL, dosya boyutu/karmalar gibi bildirim meta verilerini içeri aktarma.

Yanıtlar

Name	Tür	Description
202 Accepted		Kabul edilen güncelleştirme içeri aktarma isteği; durumu izlemek için arka plan işlemi konumu Operation-Location yanıt üst bilgisinde belirtilir. Üst Bilgiler Location: string Operation-Location: string
429 Too Many Requests		Çok fazla istek var; bir süre içinde kaç işlemin yürütülebileceğine ilişkin bir hız sınırı ve kaç eşzamanlı içeri aktarma ve silme arka plan işlemi yürütülebileceği konusunda da bir sınır vardır.

Güvenlik

azure_auth_implicit

Azure Active Directory OAuth2 Örtük Akış

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

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

azure_auth_code

Azure Active Directory OAuth2 AccessCode Akışı

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Belirteç URL'si: https://login.microsoftonline.com/common/oauth2/v2.0/token

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

azure_auth_application

Azure Active Directory OAuth2 Uygulama Akışı

Tür: oauth2
Akış: application
Belirteç URL'si: https://login.microsoftonline.com/common/oauth2/v2.0/token

Kapsamlar

Name	Description
.default	istemci kimlik bilgisi kapsamı

azure_auth_password

Azure Active Directory OAuth2 Parola Akışı

Tür: oauth2
Akış: password
Belirteç URL'si: https://login.microsoftonline.com/common/oauth2/v2.0/token

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Updates_ImportUpdate

Örnek isteği

HTTP

POST https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates?action=import

{
  "importManifest": {
    "url": "http://test.blob.core.windows.net/test/uploadimportMan.json",
    "sizeInBytes": 816,
    "hashes": {
      "sha256": "O19LyyncPe1AGstOdkcmozLV8pSbBdqrE18HdYVohRc="
    }
  },
  "files": [
    {
      "filename": "file1.bin",
      "url": "http://test.blob.core.windows.net/test/upload1v5uww1q"
    },
    {
      "filename": "file2.bin",
      "url": "http://test.blob.core.windows.net/test/uploadkrmn5yw0"
    },
    {
      "filename": "file3.bin",
      "url": "http://test.blob.core.windows.net/test/uploaddq52ky5m"
    }
  ]
}

Örnek yanıt

Durum kodu:

202

Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f
Operation-Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f

Durum kodu:

429

Tanımlar

Name	Description
FileImportMetadata	Güncelleştirme dosyasını açıklayan meta veriler.
ImportAction	Güncelleştirme eylemini içeri aktar.
ImportManifestMetadata	İçeri aktarma bildirimini açıklayan meta veriler, güncelleştirme sürümüyle ilgili dosyaları ve diğer meta verileri açıklayan bir belge.
ImportUpdateInput	Güncelleştirme giriş meta verilerini içeri aktar.

FileImportMetadata

Object

Güncelleştirme dosyasını açıklayan meta veriler.

Name	Tür	Description
filename	string	İçeri aktarma bildiriminde belirtilen dosya adını güncelleştirin.
url	string	IoT Hub için Cihaz Güncelleştirmesi tarafından güncelleştirme dosyasının indirilebildiği Azure Blob konumu. Bu genellikle son kullanma süresi en az 4 saat olarak ayarlanmış salt okunur sas korumalı blob URL'dir.

ImportAction

Listeleme

Güncelleştirme eylemini içeri aktar.

Değer	Description
import	İçeri aktarma eylemi.

ImportManifestMetadata

Object

İçeri aktarma bildirimini açıklayan meta veriler, güncelleştirme sürümüyle ilgili dosyaları ve diğer meta verileri açıklayan bir belge.

Name	Tür	Description
hashes	object	Dosyanın karmalarını içeren bir JSON nesnesi. En azından SHA256 karması gereklidir. Bu nesne, anahtarın karma algoritma olduğu ve değerin bu algoritma kullanılarak hesaplanan dosyanın karması olduğu bir anahtar-değer çiftleri kümesi olarak düşünülebilir.
sizeInBytes	integer (int64)	Bayt sayısı cinsinden dosya boyutu.
url	string	IoT Hub için Cihaz Güncelleştirmesi tarafından içeri aktarma bildiriminin indirilebildiği Azure Blob konumu. Bu genellikle son kullanma süresi en az 4 saat olarak ayarlanmış salt okunur sas korumalı blob URL'dir.

ImportUpdateInput

Object

Güncelleştirme giriş meta verilerini içeri aktar.

Name	Tür	Description
files	FileImportMetadata[]	Dosya adı ve kaynak URL gibi bir veya daha fazla güncelleştirme dosyası özelliği.
importManifest	ImportManifestMetadata	Kaynak URL, dosya boyutu/karmalar gibi bildirim meta verilerini içeri aktarma.