Updates - Import Update

Служба:

Device Update

Версия API:

2020-09-01

Импорт новой версии обновления.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
accountEndpoint	path	True	string	Конечная точка учетной записи.
instanceId	path	True	string	Идентификатор экземпляра учетной записи.
action	query	True	ImportAction	Импорт действия обновления.

Текст запроса

Имя	Обязательно	Тип	Описание
files	True	FileImportMetadata[]	Одно или несколько свойств файла обновления, таких как имя файла и URL-адрес источника.
importManifest	True	ImportManifestMetadata	Импорт метаданных манифеста, таких как исходный URL-адрес, размер файла, хэши и т. д.

Ответы

Имя	Тип	Описание
202 Accepted		Принятый запрос на импорт обновлений; Расположение фоновой операции для отслеживания состояния указывается в заголовке ответа Operation-Location. Заголовки Location: string Operation-Location: string
429 Too Many Requests		Слишком много запросов; Существует ограничение скорости на количество операций, которые можно выполнить в течение определенного периода времени, а также ограничение на количество одновременных операций импорта и удаления фоновых операций.

Безопасность

azure_auth_implicit

Неявный поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

azure_auth_code

Поток кода доступа OAuth2 Для Azure Active Directory

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
URL-адрес токена: https://login.microsoftonline.com/common/oauth2/v2.0/token

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

azure_auth_application

Поток приложений OAuth2 в Azure Active Directory

Тип: oauth2
Flow: application
URL-адрес токена: https://login.microsoftonline.com/common/oauth2/v2.0/token

Области

Имя	Описание
.default	область учетных данных клиента

azure_auth_password

Поток паролей OAuth2 в Azure Active Directory

Тип: oauth2
Flow: password
URL-адрес токена: https://login.microsoftonline.com/common/oauth2/v2.0/token

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Updates_ImportUpdate

Образец запроса

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

Пример ответа

Код состояния:

202

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

Код состояния:

429

Определения

Имя	Описание
FileImportMetadata	Метаданные, описывающие файл обновления.
ImportAction	Импорт действия обновления.
ImportManifestMetadata	Метаданные, описывающие манифест импорта, документ, в котором описываются файлы и другие метаданные об обновлении версии.
ImportUpdateInput	Импорт входных метаданных обновления.

FileImportMetadata

Метаданные, описывающие файл обновления.

Имя	Тип	Описание
filename	string	Обновите имя файла, указанное в манифесте импорта.
url	string	Расположение большого двоичного объекта Azure, из которого можно скачать файл обновления с помощью обновления устройств для Центр Интернета вещей. Обычно это URL-адрес большого двоичного объекта, защищенного SAS только для чтения, срок действия которых составляет не менее 4 часов.

ImportAction

Импорт действия обновления.

Имя	Тип	Описание
import	string	Действие импорта.

ImportManifestMetadata

Метаданные, описывающие манифест импорта, документ, в котором описываются файлы и другие метаданные об обновлении версии.

Имя	Тип	Описание
hashes	object	Объект JSON, содержащий хэши файла. Требуется по крайней мере хэш SHA256. Этот объект можно рассматривать как набор пар "ключ-значение", где ключ является хэш-алгоритмом, а значение — хэш файла, вычисленного с помощью этого алгоритма.
sizeInBytes	integer	Размер файла в байтах.
url	string	Расположение BLOB-объекта Azure, из которого можно скачать манифест импорта с помощью обновления устройств для Центр Интернета вещей. Обычно это URL-адрес большого двоичного объекта, защищенного SAS только для чтения, срок действия которых составляет не менее 4 часов.

ImportUpdateInput

Импорт входных метаданных обновления.

Имя	Тип	Описание
files	FileImportMetadata[]	Одно или несколько свойств файла обновления, таких как имя файла и URL-адрес источника.
importManifest	ImportManifestMetadata	Импорт метаданных манифеста, таких как исходный URL-адрес, размер файла, хэши и т. д.