设备部署资源
适用于：合作伙伴中心
以下资源与设备部署相关。
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 | 元数据属性。 |