Updates - Import Update

Tjänst:

Device Update

API-version:

2020-09-01

Importera en ny uppdateringsversion.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountEndpoint	path	True	string	Kontoslutpunkt.
instanceId	path	True	string	Kontoinstansidentifierare.
action	query	True	ImportAction	Importera uppdateringsåtgärd.

Begärandetext

Name	Obligatorisk	Typ	Description
files	True	FileImportMetadata[]	En eller flera uppdateringsfilegenskaper som filnamn och käll-URL.
importManifest	True	ImportManifestMetadata	Importera manifestmetadata som käll-URL, filstorlek/hashvärden osv.

Svar

Name	Typ	Description
202 Accepted		Godkänd begäran om uppdateringsimport; platsen för bakgrundsåtgärden för att spåra status anges i Operation-Location svarsrubrik. Sidhuvuden Location: string Operation-Location: string
429 Too Many Requests		För många begäranden; Det finns en hastighetsgräns för hur många åtgärder som kan utföras inom en tidsperiod och det finns också en gräns för hur många samtidiga import- och borttagningsåtgärder som kan köras.

Säkerhet

azure_auth_implicit

Implicit flöde i Azure Active Directory OAuth2

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

azure_auth_code

Azure Active Directory OAuth2 AccessCode Flow

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token-webbadress: https://login.microsoftonline.com/common/oauth2/v2.0/token

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

azure_auth_application

Azure Active Directory OAuth2-programflöde

Typ: oauth2
Flow: application
Token-webbadress: https://login.microsoftonline.com/common/oauth2/v2.0/token

Omfattningar

Name	Description
.default	omfång för klientautentiseringsuppgifter

azure_auth_password

Azure Active Directory OAuth2-lösenordsflöde

Typ: oauth2
Flow: password
Token-webbadress: https://login.microsoftonline.com/common/oauth2/v2.0/token

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Updates_ImportUpdate

Exempelbegäran

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

Exempelsvar

Statuskod:

202

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

Statuskod:

429

Definitioner

Name	Description
FileImportMetadata	Metadata som beskriver en uppdateringsfil.
ImportAction	Importera uppdateringsåtgärd.
ImportManifestMetadata	Metadata som beskriver importmanifestet, ett dokument som beskriver filer och andra metadata om en uppdateringsversion.
ImportUpdateInput	Importera metadata för uppdateringsindata.

FileImportMetadata

Metadata som beskriver en uppdateringsfil.

Name	Typ	Description
filename	string	Uppdatera filnamnet enligt vad som anges i importmanifestet.
url	string	Azure Blob-plats från vilken uppdateringsfilen kan laddas ned av Enhetsuppdatering för IoT Hub. Detta är vanligtvis en skrivskyddad SAS-skyddad blob-URL med en förfallotid inställd på minst 4 timmar.

ImportAction

Importera uppdateringsåtgärd.

Name	Typ	Description
import	string	Importåtgärd.

ImportManifestMetadata

Metadata som beskriver importmanifestet, ett dokument som beskriver filer och andra metadata om en uppdateringsversion.

Name	Typ	Description
hashes	object	Ett JSON-objekt som innehåller filens hash(es). Minst SHA256-hash krävs. Det här objektet kan betraktas som en uppsättning nyckel/värde-par där nyckeln är hash-algoritmen och värdet är hashen för filen som beräknas med hjälp av den algoritmen.
sizeInBytes	integer	Filstorlek i antal byte.
url	string	Azure Blob-plats från vilken importmanifestet kan laddas ned av Enhetsuppdatering för IoT Hub. Detta är vanligtvis en skrivskyddad SAS-skyddad blob-URL med en förfallotid inställd på minst 4 timmar.

ImportUpdateInput

Importera metadata för uppdateringsindata.

Name	Typ	Description
files	FileImportMetadata[]	En eller flera uppdateringsfilegenskaper som filnamn och käll-URL.
importManifest	ImportManifestMetadata	Importera manifestmetadata som käll-URL, filstorlek/hashvärden osv.