Updates - Import Update

Szolgáltatás:

Device Update

API-verzió:

2020-09-01

Új frissítési verzió importálása.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
accountEndpoint	path	True	string	Fiókvégpont.
instanceId	path	True	string	Fiókpéldány azonosítója.
action	query	True	ImportAction	Frissítési művelet importálása.

Kérelem törzse

Name	Kötelező	Típus	Description
files	True	FileImportMetadata[]	Egy vagy több frissítési fájltulajdonság, például a fájlnév és a forrás URL-címe.
importManifest	True	ImportManifestMetadata	Importálja a jegyzék metaadatait, például a forrás URL-címét, a fájlméretet/kivonatokat stb.

Válaszok

Name	Típus	Description
202 Accepted		Elfogadott frissítésimportálási kérelem; A háttérművelet állapotkövetési helye Operation-Location válaszfejlécben van megadva. Fejlécek Location: string Operation-Location: string
429 Too Many Requests		Túl sok kérés; van egy sebességkorlát arra vonatkozóan, hogy hány művelet hajtható végre egy adott időszakon belül, és azt is korlátozza, hogy hány egyidejű importálási és törlési háttérművelet hajtható végre.

Biztonság

azure_auth_implicit

Azure Active Directory OAuth2 implicit folyamat

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

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

azure_auth_code

Azure Active Directory OAuth2 hozzáférési kód folyamata

Típus: oauth2
Folyamat: accessCode
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Jogkivonat URL-címe: https://login.microsoftonline.com/common/oauth2/v2.0/token

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

azure_auth_application

Azure Active Directory OAuth2 alkalmazásfolyamat

Típus: oauth2
Folyamat: application
Jogkivonat URL-címe: https://login.microsoftonline.com/common/oauth2/v2.0/token

Hatókörök

Name	Description
.default	ügyfél hitelesítő adatainak hatóköre

azure_auth_password

Azure Active Directory OAuth2 jelszó folyamata

Típus: oauth2
Folyamat: password
Jogkivonat URL-címe: https://login.microsoftonline.com/common/oauth2/v2.0/token

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Updates_ImportUpdate

Mintakérelem

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

Mintaválasz

Állapotkód:

202

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

Állapotkód:

429

Definíciók

Name	Description
FileImportMetadata	Egy frissítési fájlt leíró metaadatok.
ImportAction	Frissítési művelet importálása.
ImportManifestMetadata	Az importálási jegyzékfájlt leíró metaadatok, a fájlok és a frissítési verzió egyéb metaadatait leíró dokumentum.
ImportUpdateInput	Frissítési bemeneti metaadatok importálása.

FileImportMetadata

Objektum

Egy frissítési fájlt leíró metaadatok.

Name	Típus	Description
filename	string	Frissítse a fájlnevet az importálási jegyzékben megadott módon.
url	string	Az Azure Blob helye, ahonnan a frissítési fájl letölthető az IoT Hub eszközfrissítésével. Ez általában egy írásvédett SAS által védett blob URL-cím, amelynek lejárati ideje legalább 4 óra.

ImportAction

Enumerálás

Frissítési művelet importálása.

Érték	Description
import	Importálási művelet.

ImportManifestMetadata

Objektum

Az importálási jegyzékfájlt leíró metaadatok, a fájlok és a frissítési verzió egyéb metaadatait leíró dokumentum.

Name	Típus	Description
hashes	object	A fájl kivonatát (kivonatait) tartalmazó JSON-objektum. Legalább SHA256 kivonatra van szükség. Ez az objektum kulcs-érték párok halmazaként is felfogható, ahol a kulcs a kivonatoló algoritmus, az érték pedig az adott algoritmussal kiszámított fájl kivonata.
sizeInBytes	integer (int64)	Fájlméret bájtszámban.
url	string	Az Azure Blob helye, ahonnan az importálási jegyzék letölthető az IoT Hub eszközfrissítésével. Ez általában egy írásvédett SAS által védett blob URL-cím, amelynek lejárati ideje legalább 4 óra.

ImportUpdateInput

Objektum

Frissítési bemeneti metaadatok importálása.

Name	Típus	Description
files	FileImportMetadata[]	Egy vagy több frissítési fájltulajdonság, például a fájlnév és a forrás URL-címe.
importManifest	ImportManifestMetadata	Importálja a jegyzék metaadatait, például a forrás URL-címét, a fájlméretet/kivonatokat stb.