Поделиться через

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

Поток AccessCode в Azure Active Directory OAuth2

Тип: 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

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

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

Object

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

Имя Тип Описание
filename

string

Обновите имя файла, указанное внутри манифеста импорта.
url

string

Расположение BLOB-объектов Azure, из которого файл обновления можно скачать с помощью центра Интернета вещей. Обычно это URL-адрес большого двоичного объекта, защищенного только для чтения, с сроком действия не менее 4 часов.

ImportAction

Перечисление

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

Значение Описание
import

Действие импорта.

ImportManifestMetadata

Object

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

Имя Тип Описание
hashes

object

Объект JSON, содержащий хэш(es) файла. Требуется по крайней мере хэш SHA256. Этот объект можно рассматривать как набор пар "ключ-значение", где ключ является хэш-алгоритмом, а значение — хэш файла, вычисляемого с помощью этого алгоритма.
sizeInBytes

integer (int64)

Размер файла в количестве байтов.
url

string

Расположение BLOB-объектов Azure, из которого манифест импорта можно скачать с помощью центра Интернета вещей. Обычно это URL-адрес большого двоичного объекта, защищенного только для чтения, с сроком действия не менее 4 часов.

ImportUpdateInput

Object

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

Имя Тип Описание
files

FileImportMetadata[]

Одно или несколько свойств файла обновления, таких как имя файла и URL-адрес источника.
importManifest

ImportManifestMetadata

Импорт метаданных манифеста, таких как исходный URL-адрес, размер файла и хэши и т. д.