设备部署资源

  • 项目

适用于：合作伙伴中心

以下资源与设备部署相关。

ConfigurationPolicy

ConfigurationPolicy 提供有关配置策略的信息。

properties 类型 描述
ID string 标识策略的 GUID 格式字符串。
name string 策略的友好名称。
category string 类别。
description string 策略说明。
devicesAssignedCount 数字 分配给此策略的设备数。
策略设置 字符串数组 策略设置：“none”、“remove_oem_preinstalls”、“oobe_user_not_local_admin”、“skip_express_settings”、“skip_oem_registration”、“skip_eula”。
createdDate 采用 UTC 日期/时间格式的字符串 策略的创建日期和时间。
lastModifiedDate 采用 UTC 日期/时间格式的字符串 上次修改策略的日期和时间。
attributes ResourceAttributes 元数据属性。

设备

设备 提供有关设备的信息。

properties 类型 描述
ID string 标识设备的 GUID 格式字符串。
serialNumber string 与设备唯一关联的序列号。
productKey string 与设备唯一关联的产品密钥。
hardwareHash string 与设备唯一关联的硬件哈希。
modelName string 与设备关联的模型名称。
oemManufacturerName string 与设备关联的 OEM 制造商的名称。
策略 对象数组 分配给设备的策略列表。
uploadedDate 采用 UTC 日期/时间格式的字符串 上传设备详细信息的日期和时间。
allowedOperations 字符串数组 设备同步上允许的 HTTP 方法列表，如 GET、PATCH、DELETE。
attributes ResourceAttributes 元数据属性。

BatchUploadDetails

BatchUploadDetails 描述设备批量上传设备列表中每个设备的相关信息的状态。

properties 类型 描述
batchTrackingId string 与上传的一批设备关联的 GUID 格式字符串。
状态 string 批上传的状态：“unknown”、“queued”、“processing”、“finished”、“finished_with_errors”。
startedTime 采用 UTC 日期/时间格式的字符串 批处理上传过程的启动日期和时间。
completedTime 采用 UTC 日期/时间格式的字符串 批处理上传过程完成的日期和时间。
devicesStatus DeviceUploadDetails 资源的数组 指定每个设备信息上传状态的对象数组。
attributes ResourceAttributes 元数据属性。

DeviceUploadDetails

DeviceUploadDetails 描述有关设备的信息上传的状态。

properties 类型 说明
deviceId string 与设备关联的 GUID 格式字符串。
serialNumber string 与设备唯一关联的序列号。
productKey string 与设备唯一关联的产品密钥。
状态 string 设备信息上传的状态。 这些值可以正在进行、完成或finished_with_errors。
errorCode string 如果设备上传失败，则返回的 HTTP 状态错误代码。
errorDescription string 如果设备上传失败，HTTP 错误说明。
attributes ResourceAttributes 元数据属性。

DeviceBatch

DeviceBatch 表示设备的集合。

properties 类型 描述
ID string 与一批设备关联的 GUID 格式字符串。
createdBy string 创建集合的租户的名称。
creationDate 采用 UTC 日期/时间格式的字符串 创建集合的数据和时间。
deviceCount 数字 集合中的设备数。
devicesLink 链接 指向此批处理中包含的设备的链接。
attributes ResourceAttributes 元数据属性。

DeviceBatchCreationRequest

DeviceBatchCreationRequest 提供创建设备批处理并使用设备填充所需的信息。

properties 类型 描述
batchId string 与一批设备关联的 GUID 格式字符串。
设备 设备对象的数组 每个对象指定设备。 可接受用于标识设备的以下字段组合：hardwareHash 和 productKey、hardwareHash 和 serialNumber、hardwareHash 和 productKey，仅 serialNumber、hardwareHash only、productKey only、serialNumber 和 oemManufacturerName 和 modelName。
attributes ResourceAttributes 元数据属性。

DevicePolicyUpdateRequest

DevicePolicyUpdateRequest 提供使用策略更新设备列表所需的信息。

properties 类型 描述
设备 设备对象的数组 每个对象指定设备。 需要以下属性：ID 和策略。
attributes ResourceAttributes 元数据属性。