Updates - Import Update
Zaimportuj nową wersję aktualizacji.
POST https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates?action=import
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
account
|
path | True |
string |
Punkt końcowy konta. |
instance
|
path | True |
string |
Identyfikator wystąpienia konta. |
action
|
query | True |
Akcja importowania aktualizacji. |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
files | True |
Co najmniej jedna właściwości pliku aktualizacji, na przykład nazwa pliku i adres URL źródła. |
|
importManifest | True |
Zaimportuj metadane manifestu, takie jak źródłowy adres URL, rozmiar pliku/skróty itp. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
202 Accepted |
Zaakceptowane żądanie importu aktualizacji; Lokalizacja operacji w tle do śledzenia stanu jest określona w nagłówku odpowiedzi Operation-Location. Nagłówki
|
|
429 Too Many Requests |
Zbyt wiele żądań; Istnieje limit szybkości wykonywania operacji w danym okresie. Istnieje również limit liczby współbieżnych operacji importowania i usuwania operacji w tle. |
Zabezpieczenia
azure_auth_implicit
Przepływ niejawny OAuth2 usługi Azure Active Directory
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
azure_auth_code
Przepływ kodu dostępu OAuth2 w usłudze Azure Active Directory
Typ:
oauth2
Flow:
accessCode
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Adres URL tokenu:
https://login.microsoftonline.com/common/oauth2/v2.0/token
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
azure_auth_application
Przepływ aplikacji OAuth2 usługi Azure Active Directory
Typ:
oauth2
Flow:
application
Adres URL tokenu:
https://login.microsoftonline.com/common/oauth2/v2.0/token
Zakresy
Nazwa | Opis |
---|---|
.default | zakres poświadczeń klienta |
azure_auth_password
Przepływ haseł OAuth2 w usłudze Azure Active Directory
Typ:
oauth2
Flow:
password
Adres URL tokenu:
https://login.microsoftonline.com/common/oauth2/v2.0/token
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
Updates_ImportUpdate
Przykładowe żądanie
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"
}
]
}
Przykładowa odpowiedź
Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f
Operation-Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f
Definicje
Nazwa | Opis |
---|---|
File |
Metadane opisujące plik aktualizacji. |
Import |
Akcja importowania aktualizacji. |
Import |
Metadane opisujące manifest importu, dokument opisujący pliki i inne metadane dotyczące wersji aktualizacji. |
Import |
Importowanie metadanych wejściowych aktualizacji. |
FileImportMetadata
Metadane opisujące plik aktualizacji.
Nazwa | Typ | Opis |
---|---|---|
filename |
string |
Zaktualizuj nazwę pliku zgodnie z opisem w manifeście importu. |
url |
string |
Lokalizacja obiektu blob platformy Azure, z której można pobrać plik aktualizacji przez usługę Device Update dla IoT Hub. Zazwyczaj jest to adres URL obiektu blob chronionego tylko do odczytu z wygaśnięciem ustawionym na co najmniej 4 godziny. |
ImportAction
Akcja importowania aktualizacji.
Nazwa | Typ | Opis |
---|---|---|
import |
string |
Akcja importu. |
ImportManifestMetadata
Metadane opisujące manifest importu, dokument opisujący pliki i inne metadane dotyczące wersji aktualizacji.
Nazwa | Typ | Opis |
---|---|---|
hashes |
object |
Obiekt JSON zawierający skróty pliku. Wymagany jest co najmniej skrót SHA256. Ten obiekt można traktować jako zestaw par klucz-wartość, w których klucz jest algorytmem wyznaczania wartości skrótu, a wartość jest skrótem pliku obliczanego przy użyciu tego algorytmu. |
sizeInBytes |
integer |
Rozmiar pliku w liczbie bajtów. |
url |
string |
Lokalizacja obiektu blob platformy Azure, z której manifest importu można pobrać za pomocą usługi Device Update dla IoT Hub. Zazwyczaj jest to adres URL obiektu blob chronionego tylko do odczytu z wygaśnięciem ustawionym na co najmniej 4 godziny. |
ImportUpdateInput
Importowanie metadanych wejściowych aktualizacji.
Nazwa | Typ | Opis |
---|---|---|
files |
Co najmniej jedna właściwości pliku aktualizacji, na przykład nazwa pliku i adres URL źródła. |
|
importManifest |
Zaimportuj metadane manifestu, takie jak źródłowy adres URL, rozmiar pliku/skróty itp. |