Updates - Import Update

Service:

Device Update

API Version:

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ı vb. 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. Headers 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ğine ilişkin bir sınır da vardır.

Güvenlik

azure_auth_implicit

Azure Active Directory OAuth2 Örtük Akışı

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Scopes

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

azure_auth_code

Azure Active Directory OAuth2 AccessCode Akışı

Type: oauth2
Flow: accessCode
Authorization URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Scopes

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

azure_auth_application

Azure Active Directory OAuth2 Uygulama Akışı

Type: oauth2
Flow: application
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Scopes

Name	Description
.default	istemci kimlik bilgisi kapsamı

azure_auth_password

Azure Active Directory OAuth2 Parola Akışı

Type: oauth2
Flow: password
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Scopes

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

Örnekler

Updates_ImportUpdate

Sample Request

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

Sample Response

Status code:

202

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

Status code:

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

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

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

ImportAction

Güncelleştirme eylemini içeri aktar.

Name	Tür	Description
import	string	İçeri aktarma eylemi.

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.

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 dizi anahtar-değer çifti olarak düşünülebilir.
sizeInBytes	integer	Bayt sayısı cinsinden dosya boyutu.
url	string	IoT Hub için Cihaz Güncelleştirmesi tarafından içeri aktarma bildiriminin indirilebileceği Azure Blob konumu. Bu genellikle son kullanma tarihi en az 4 saat olarak ayarlanmış salt okunur SAS korumalı blob URL'dir.

ImportUpdateInput

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ı vb. gibi bildirim meta verilerini içeri aktarma