Updates - Import Update

Dienst:

Device Update

API-Version:

2020-09-01

Importieren Sie die neue Updateversion.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountEndpoint	path	True	string	Kontoendpunkt.
instanceId	path	True	string	Konto instance Bezeichner.
action	query	True	ImportAction	Updateaktion importieren.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
files	True	FileImportMetadata[]	Mindestens eine Aktualisierung von Dateieigenschaften wie Dateiname und Quell-URL.
importManifest	True	ImportManifestMetadata	Importieren Sie Manifestmetadaten wie Quell-URL, Dateigröße/Hashes usw.

Antworten

Name	Typ	Beschreibung
202 Accepted		Updateimportanforderung akzeptiert; Der Speicherort des Hintergrundvorgangs zum Nachverfolgen status wird in Operation-Location Antwortheader angegeben. Header Location: string Operation-Location: string
429 Too Many Requests		Zu viele Anforderungen; Es gibt ein Ratenlimit für die Anzahl von Vorgängen, die innerhalb eines Zeitraums ausgeführt werden können, und es gibt auch eine Begrenzung für die Anzahl gleichzeitiger Import- und Löschvorgänge im Hintergrund.

Sicherheit

azure_auth_implicit

Impliziter Azure Active Directory OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

azure_auth_code

Azure Active Directory OAuth2 AccessCode Flow

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token-URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

azure_auth_application

Azure Active Directory OAuth2-Anwendungsflow

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

Bereiche

Name	Beschreibung
.default	Clientanmeldeinformationsbereich

azure_auth_password

Azure Active Directory OAuth2-Kennwortfluss

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

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Updates_ImportUpdate

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

202

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

Statuscode:

429

Definitionen

Name	Beschreibung
FileImportMetadata	Metadaten, die eine Updatedatei beschreiben.
ImportAction	Updateaktion importieren.
ImportManifestMetadata	Metadaten, die das Importmanifest beschreiben, ein Dokument, das die Dateien und andere Metadaten zu einer Updateversion beschreibt.
ImportUpdateInput	Importieren von Metadaten für Die Aktualisierungseingabe.

FileImportMetadata

Metadaten, die eine Updatedatei beschreiben.

Name	Typ	Beschreibung
filename	string	Aktualisieren Sie den Dateinamen, wie im Importmanifest angegeben.
url	string	Azure Blob-Speicherort, von dem die Updatedatei von Device Update for IoT Hub heruntergeladen werden kann. Dies ist in der Regel eine schreibgeschützte SAS-geschützte Blob-URL, deren Ablauf auf mindestens 4 Stunden festgelegt ist.

ImportAction

Updateaktion importieren.

Name	Typ	Beschreibung
import	string	Aktion importieren.

ImportManifestMetadata

Metadaten, die das Importmanifest beschreiben, ein Dokument, das die Dateien und andere Metadaten zu einer Updateversion beschreibt.

Name	Typ	Beschreibung
hashes	object	Ein JSON-Objekt, das die Hash(n) der Datei enthält. Mindestens SHA256-Hash ist erforderlich. Dieses Objekt kann als eine Gruppe von Schlüssel-Wert-Paaren betrachtet werden, bei denen der Schlüssel der Hashalgorithmus ist, und der Wert ist der Hash der Datei, die mit diesem Algorithmus berechnet wird.
sizeInBytes	integer	Dateigröße in Byte
url	string	Azure Blob-Speicherort, von dem das Importmanifest von Device Update für IoT Hub heruntergeladen werden kann. Dies ist in der Regel eine schreibgeschützte SAS-geschützte Blob-URL, deren Ablauf auf mindestens 4 Stunden festgelegt ist.

ImportUpdateInput

Importieren von Metadaten für Die Aktualisierungseingabe.

Name	Typ	Beschreibung
files	FileImportMetadata[]	Mindestens eine Aktualisierung von Dateieigenschaften wie Dateiname und Quell-URL.
importManifest	ImportManifestMetadata	Importieren Sie Manifestmetadaten wie Quell-URL, Dateigröße/Hashes usw.