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


Ресурсы развертывания устройств

Область применения: Центр партнеров

Следующие ресурсы связаны с развертыванием устройства.

ConfigurationPolicy

ConfigurationPolicy предоставляет сведения о политике конфигурации.

Свойство Тип Описание
Идентификатор строка Строка с форматом GUID, определяющая политику.
имя строка Понятное имя политики.
Категория строка Категория.
description строка Описание политики.
devicesAssignedCount Номер Количество устройств, назначенных этой политике.
политика Параметры массив строк Параметры политики: none,"remove_oem_preinstalls","oobe_user_not_local_admin","skip_express_settings","skip_oem_registration", "skip_eula".
createdDate строка в формате даты и времени в формате UTC Дата и время создания политики.
lastModifiedDate строка в формате даты и времени в формате UTC Дата и время последнего изменения политики.
атрибутов ResourceAttributes Атрибуты метаданных.

Устройство

Устройство предоставляет сведения об устройстве.

Свойство Тип Описание
Идентификатор строка Строка с форматом GUID, определяющая устройство.
serialNumber строка Серийный номер уникально связан с устройством.
productKey строка Ключ продукта однозначно связан с устройством.
hardwareHash строка Хэш оборудования, однозначно связанный с устройством.
modelName строка Имя модели, связанное с устройством.
oemManufacturerName строка Имя изготовителя оборудования, связанного с устройством.
политики массив объектов Список политик, назначенных устройству.
UploadedDate строка в формате даты и времени в формате UTC Дата и время отправки сведений об устройстве.
allowedOperations массив строк Список методов HTTP, разрешенных для синхронизации устройств с помощью GET, PATCH, DELETE.
атрибутов ResourceAttributes Атрибуты метаданных.

BatchUploadDetails

BatchUploadDetails описывает состояние пакетной отправки сведений о каждом устройстве в списке устройств.

Свойство Тип Описание
batchTrackingId строка Строка с форматом GUID, связанная с пакетом отправленных устройств.
status строка Состояние пакетной отправки: "неизвестно", "queued", "processing", "готово", "finished_with_errors".
startedTime строка в формате даты и времени в формате UTC Дата и время запуска процесса отправки пакета.
completedTime строка в формате даты и времени в формате UTC Дата и время завершения процесса отправки пакета.
devicesStatus массив ресурсов DeviceUploadDetails Массив объектов, указывающих состояние каждой отправки сведений об устройстве.
атрибутов ResourceAttributes Атрибуты метаданных.

DeviceUploadDetails

DeviceUploadDetails описывает состояние отправки сведений об устройстве.

Свойство Тип Описание
deviceId строка Строка с форматом GUID, связанная с устройством.
serialNumber строка Серийный номер уникально связан с устройством.
productKey строка Ключ продукта однозначно связан с устройством.
status строка Состояние отправки сведений об устройстве. Значения могут быть завершены, завершены или finished_with_errors.
errorCode строка Код ошибки состояния HTTP возвращается, если отправка устройства завершается ошибкой.
errorDescription строка Описание ошибки HTTP, если отправка устройства завершается ошибкой.
атрибутов ResourceAttributes Атрибуты метаданных.

DeviceBatch

DeviceBatch представляет коллекцию устройств.

Свойство Тип Описание
Идентификатор строка Строка с форматом GUID, связанная с пакетом устройств.
createdBy строка Имя клиента, создавшего коллекцию.
creationDate строка в формате даты и времени в формате UTC Данные и время создания коллекции.
deviceCount Номер Количество устройств в коллекции.
deviceLink Ссылка Ссылка на устройства, содержащиеся в этом пакете.
атрибутов ResourceAttributes Атрибуты метаданных.

DeviceBatchCreationRequest

DeviceBatchCreationRequest предоставляет сведения, необходимые для создания пакета устройства и заполняет его устройствами.

Свойство Тип Описание
batchId строка Строка с форматом GUID, связанная с пакетом устройств.
IoT-устройства массив объектов Device Каждый объект задает устройство. Ниже приведены сочетания полей для идентификации устройства: hardwareHash и productKey, hardwareHash и serialNumber, hardwareHash и productKey с serialNumber, hardwareHash, hardwareHash only, productKey only, serialNumber и oemManufacturerName с modelName.
атрибутов ResourceAttributes Атрибуты метаданных.

DevicePolicyUpdateRequest

DevicePolicyUpdateRequest предоставляет сведения, необходимые для обновления списка устройств с помощью политики.

Свойство Тип Описание
IoT-устройства массив объектов Device Каждый объект задает устройство. Требуются следующие свойства: идентификатор и политики.
атрибутов ResourceAttributes Атрибуты метаданных.