Ресурсы развертывания устройств
применимо к: Центр партнеров
Следующие ресурсы связаны с развертыванием устройства.
Политика настройки
ConfigurationPolicy предоставляет сведения о политике конфигурации.
| Собственность | Тип | Описание |
|---|---|---|
| ИДЕНТИФИКАТОР | струна | Строка с форматом GUID, определяющая политику. |
| имя | струна | Удобное имя политики. |
| категория | струна | Категория. |
| описание | струна | Описание политики. |
| количествоНазначенныхУстройств | число | Количество устройств, назначенных данной политике. |
| настройки политики | массив строк | Параметры политики: "нет","remove_oem_preinstalls","oobe_user_not_local_admin","skip_express_settings","skip_oem_registration", "skip_eula". |
| датаСоздания | строка в формате даты и времени в формате UTC | Дата и время создания политики. |
| дата последнего изменения | строка в формате даты и времени в формате UTC | Дата и время последнего изменения политики. |
| Атрибуты | ResourceAttributes | Атрибуты метаданных. |
Устройство
устройство предоставляет сведения об устройстве.
| Свойство | Тип | Описание |
|---|---|---|
| ИДЕНТИФИКАТОР | струна | Строка с форматом GUID, определяющая устройство. |
| серийный номер | струна | Серийный номер уникально связан с устройством. |
| ключ продукта | струна | Ключ продукта однозначно связан с устройством. |
| аппаратный хэш | струна | Хэш, уникально связанный с аппаратным обеспечением устройства. |
| modelName | струна | Имя модели, связанное с устройством. |
| oemManufacturerName | струна | Имя изготовителя оборудования, связанного с устройством. |
| Политики | массив объектов | Список политик, назначенных устройству. |
| Дата загрузки | строка в формате даты и времени в формате UTC | Дата и время отправки сведений об устройстве. |
| разрешенные операции | массив строк | Список методов HTTP, разрешенных для синхронизации на устройстве: GET, PATCH, DELETE. |
| Атрибуты | АтрибутыРесурса | Атрибуты метаданных. |
ДеталиПакетнойЗагрузки
BatchUploadDetails описывает состояние пакетной отправки сведений о каждом устройстве в списке устройств.
| Свойство | Тип | Описание |
|---|---|---|
| идентификатор пакетного отслеживания | струна | Строка с форматом GUID, связанная с пакетом отправленных устройств. |
| статус | струна | Состояние пакетной отправки: "неизвестно", "в очереди", "обрабатывается", "готово", "готово с ошибками". |
| startedTime | строка в формате даты и времени в формате UTC | Дата и время запуска процесса отправки пакета. |
| время завершения | строка в формате даты и времени в формате UTC | Дата и время завершения процесса отправки пакета. |
| статус устройств | массив ресурсов DeviceUploadDetails | Массив объектов, указывающих состояние каждой отправки сведений об устройстве. |
| Атрибуты | ResourceAttributes | Атрибуты метаданных. |
ДеталиЗагрузкиУстройства
DeviceUploadDetails описывает состояние отправки сведений об устройстве.
| Свойство | Тип | Описание |
|---|---|---|
| идентификатор устройства | струна | Строка с форматом GUID, связанная с устройством. |
| серийный номер | струна | Серийный номер уникально связан с устройством. |
| ключ продукта | струна | Ключ продукта однозначно связан с устройством. |
| статус | струна | Состояние отправки сведений об устройстве. Значения могут быть в процессе, завершены или завершены с ошибками. |
| Код ошибки | струна | Код ошибки HTTP, возвращаемый в случае неудачной загрузки устройства. |
| ОписаниеОшибки | струна | Описание ошибки HTTP в случае неудачи отправки устройства. |
| Атрибуты | ResourceAttributes | Атрибуты метаданных. |
DeviceBatch
DeviceBatch представляет коллекцию устройств.
| Свойство | Тип | Описание |
|---|---|---|
| ИДЕНТИФИКАТОР | струна | Строка с форматом GUID, связанная с пакетом устройств. |
| создано_кем | струна | Имя клиента, создавшего коллекцию. |
| дата создания | строка в формате даты и времени в формате UTC | Данные и время создания коллекции. |
| количествоУстройств | число | Количество устройств в коллекции. |
| deviceLink | Ссылка | Ссылка на устройства, содержащиеся в этом пакете. |
| Атрибуты | ResourceAttributes | Атрибуты метаданных. |
Запрос на создание партии устройств
DeviceBatchCreationRequest предоставляет сведения, необходимые для создания партии устройств, и заполняет её устройствами.
| Свойство | Тип | Описание |
|---|---|---|
| идентификатор партии | струна | Строка с форматом GUID, связанная с пакетом устройств. |
| приборы | массив объектов устройства | Каждый объект задает устройство. Ниже приведены сочетания полей для идентификации устройства: hardwareHash и productKey, hardwareHash и serialNumber, hardwareHash, productKey и serialNumber, только hardwareHash, только productKey, serialNumber и oemManufacturerName с modelName. |
| Атрибуты | ResourceAttributes | Атрибуты метаданных. |
Запрос на обновление политики устройства
DevicePolicyUpdateRequest предоставляет сведения, необходимые для обновления списка устройств с помощью политики.
| Свойство | Тип | Описание |
|---|---|---|
| приборы | массив объектов устройства | Каждый объект задает устройство. Требуются следующие свойства: идентификатор (ID) и политики. |
| Атрибуты | ResourceAttributes | Атрибуты метаданных. |