Updates - Import Update

Servizio:

Device Update

Versione API:

2020-09-01

Importare una nuova versione di aggiornamento.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountEndpoint	path	True	string	Endpoint dell'account.
instanceId	path	True	string	Identificatore dell'istanza dell'account.
action	query	True	ImportAction	Importare l'azione di aggiornamento.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
files	True	FileImportMetadata[]	Una o più proprietà del file di aggiornamento, ad esempio nome file e URL di origine.
importManifest	True	ImportManifestMetadata	Importare metadati del manifesto, ad esempio URL di origine, dimensioni/hash del file e così via.

Risposte

Nome	Tipo	Descrizione
202 Accepted		Richiesta di importazione di aggiornamenti accettata; La posizione dell'operazione in background per tenere traccia dello stato viene specificata nell'intestazione della risposta Operation-Location. Intestazioni Location: string Operation-Location: string
429 Too Many Requests		Troppe richieste; è previsto un limite di frequenza per il numero di operazioni che è possibile eseguire entro un periodo di tempo ed è previsto anche un limite al numero di operazioni di importazione ed eliminazione simultanee che è possibile eseguire le operazioni in background.

Sicurezza

azure_auth_implicit

Flusso implicito OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

azure_auth_code

Flusso di codice di accesso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
URL token: https://login.microsoftonline.com/common/oauth2/v2.0/token

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

azure_auth_application

Flusso dell'applicazione OAuth2 di Azure Active Directory

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

Ambiti

Nome	Descrizione
.default	ambito delle credenziali client

azure_auth_password

Flusso password OAuth2 di Azure Active Directory

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

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Updates_ImportUpdate

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

202

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

Codice di stato:

429

Definizioni

Nome	Descrizione
FileImportMetadata	Metadati che descrivono un file di aggiornamento.
ImportAction	Importare l'azione di aggiornamento.
ImportManifestMetadata	Metadati che descrivono il manifesto di importazione, un documento che descrive i file e altri metadati relativi a una versione di aggiornamento.
ImportUpdateInput	Importare i metadati di input di aggiornamento.

FileImportMetadata

Metadati che descrivono un file di aggiornamento.

Nome	Tipo	Descrizione
filename	string	Aggiornare il nome del file come specificato all'interno del manifesto di importazione.
url	string	Percorso BLOB di Azure da cui è possibile scaricare il file di aggiornamento da Aggiornamento dispositivi per hub IoT. Si tratta in genere di un URL BLOB protetto da firma di accesso condiviso di sola lettura con una scadenza impostata su almeno 4 ore.

ImportAction

Importare l'azione di aggiornamento.

Nome	Tipo	Descrizione
import	string	Azione di importazione.

ImportManifestMetadata

Metadati che descrivono il manifesto di importazione, un documento che descrive i file e altri metadati relativi a una versione di aggiornamento.

Nome	Tipo	Descrizione
hashes	object	Oggetto JSON contenente l'hash(es) del file. È necessario almeno l'hash SHA256. Questo oggetto può essere considerato come un set di coppie chiave-valore in cui la chiave è l'algoritmo hash e il valore è l'hash del file calcolato usando tale algoritmo.
sizeInBytes	integer	Dimensioni del file in numero di byte.
url	string	Percorso BLOB di Azure da cui è possibile scaricare il manifesto di importazione da Aggiornamento dispositivi per hub IoT. Si tratta in genere di un URL BLOB protetto da firma di accesso condiviso di sola lettura con una scadenza impostata su almeno 4 ore.

ImportUpdateInput

Importare i metadati di input di aggiornamento.

Nome	Tipo	Descrizione
files	FileImportMetadata[]	Una o più proprietà del file di aggiornamento, ad esempio nome file e URL di origine.
importManifest	ImportManifestMetadata	Importare metadati del manifesto, ad esempio URL di origine, dimensioni/hash del file e così via.