Updates - Get Update

Служба:

Device Update

Версия API:

2020-09-01

Получение определенной версии обновления.

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/providers/{provider}/names/{name}/versions/{version}

Параметры URI

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

Заголовок запроса

Имя	Обязательно	Тип	Описание
If-None-Match		string	Определяет условие If-None-Match. Операция будет выполняться только в том случае, если ETag на сервере не соответствует этому значению.

Ответы

Имя	Тип	Описание
200 OK	Update	Запрошенная версия обновления.
404 Not Found		Не найдено.
429 Too Many Requests		Слишком много запросов; существует ограничение скорости на количество операций, которые могут быть выполнены в течение определенного периода времени.
Other Status Codes		Не изменено.

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

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_GetUpdate

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

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0

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

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

200

{
  "updateId": {
    "provider": "microsoft",
    "name": "adu",
    "version": "1.0.0.0"
  },
  "updateType": "image",
  "installedCriteria": "SwVer=5",
  "compatibility": [
    {
      "deviceManufacturer": "Microsoft",
      "deviceModel": "Toaster"
    }
  ],
  "manifestVersion": "0.1",
  "importedDateTime": "2020-04-22T21:01:43.8408797+00:00",
  "createdDateTime": "2019-09-12T00:00:00.0000000+00:00",
  "etag": "\"3fed3378-0c67-47d2-b796-296962c66cbb\""
}

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

304

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

404

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

429

Определения

Имя	Описание
Compatibility	Обновление сведений о совместимости.
Update	Обновление метаданных.
UpdateId	Идентификатор обновления.

Compatibility

Обновление сведений о совместимости.

Имя	Тип	Описание
deviceManufacturer	string	Производитель устройства, с которым совместимо обновление.
deviceModel	string	Модель устройства, с которым совместимо обновление.

Update

Обновление метаданных.

Имя	Тип	Описание
compatibility	Compatibility[]	Список сведений о совместимости обновлений.
createdDateTime	string	Дата и время создания обновления в формате UTC.
etag	string	Обновление ETag.
importedDateTime	string	Дата и время импорта обновления в формате UTC.
installedCriteria	string	Строка, интерпретируемая клиентом обновления устройства, чтобы определить, установлено ли обновление на устройстве.
manifestVersion	string	Версия схемы манифеста, используемая для импорта обновления.
updateId	UpdateId	Идентификатор обновления.
updateType	string	Тип обновления.

UpdateId

Идентификатор обновления.

Имя	Тип	Описание
name	string	Имя обновления.
provider	string	Поставщик обновлений.
version	string	Обновление версии.