裝置部署資源
適用于：合作夥伴中心
下列資源與裝置部署相關。
ConfigurationPolicy
ConfigurationPolicy 提供設定原則的相關資訊。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 識別碼 | string | 識別原則的 GUID 格式字串。 |
| NAME | 字串 | 原則的易記名稱。 |
| category | string | 類別。 |
| description | string | 原則描述。 |
| devicesAssignedCount | 數值 | 指派給此原則的裝置數目。 |
| policy設定 | 字串陣列 | 原則設定：「none」、「remove_oem_preinstalls」、「oobe_user_not_local_admin」、「skip_express_settings」、「skip_oem_registration」、「skip_eula」。 |
| createdDate | UTC 日期時間格式的字串 | 建立原則的日期和時間。 |
| lastModifiedDate | UTC 日期時間格式的字串 | 上次修改原則的日期和時間。 |
| attributes | ResourceAttributes | 中繼資料屬性。 |
裝置
裝置 提供裝置的相關資訊。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 識別碼 | string | 識別裝置的 GUID 格式字串。 |
| serialNumber | string | 與裝置唯一關聯的序號。 |
| productKey | string | 與裝置唯一關聯的產品金鑰。 |
| hardwareHash | string | 與裝置唯一關聯的硬體雜湊。 |
| modelName | string | 與裝置相關聯的模型名稱。 |
| oemManufacturerName | string | 與裝置相關聯的 OEM 製造商名稱。 |
| 原則 | 物件陣列 | 指派給裝置的原則清單。 |
| uploadedDate | UTC 日期時間格式的字串 | 上傳裝置詳細資料的日期和時間。 |
| allowedOperations | 字串陣列 | 裝置同步處理時允許做為 GET、PATCH、DELETE 的 HTTP 方法清單。 |
| attributes | ResourceAttributes | 中繼資料屬性。 |
BatchUploadDetails
BatchUploadDetails 說明裝置批次上傳裝置清單中每個裝置的相關資訊狀態。
| 屬性 | 類型 | 描述 |
|---|---|---|
| batchTrackingId | string | 與上傳的裝置批次相關聯的 GUID 格式字串。 |
| status | 字串 | 批次上傳的狀態：「unknown」、「queued」、「processing」、「finished」、「finished_with_errors」。 |
| startedTime | UTC 日期時間格式的字串 | 批次上傳程式啟動的日期和時間。 |
| completedTime | UTC 日期時間格式的字串 | 批次上傳程式完成的日期和時間。 |
| devicesStatus | DeviceUploadDetails 資源的陣列 | 物件的陣列，指定每個裝置資訊上傳的狀態。 |
| attributes | ResourceAttributes | 中繼資料屬性。 |
DeviceUploadDetails
DeviceUploadDetails 描述裝置相關資訊上傳的狀態。
| 屬性 | 類型 | 描述 |
|---|---|---|
| deviceId | string | 與裝置相關聯的 GUID 格式字串。 |
| serialNumber | string | 與裝置唯一關聯的序號。 |
| productKey | string | 與裝置唯一關聯的產品金鑰。 |
| status | 字串 | 裝置資訊上傳的狀態。 這些值可以是進行中、已完成或finished_with_errors。 |
| errorCode | string | 如果裝置上傳失敗，則傳回的 HTTP 狀態錯誤碼。 |
| errorDescription | string | 如果裝置上傳失敗，HTTP 錯誤描述。 |
| attributes | ResourceAttributes | 中繼資料屬性。 |
DeviceBatch
DeviceBatch 代表裝置的集合。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 識別碼 | string | 與裝置批次相關聯的 GUID 格式字串。 |
| createdBy | string | 建立集合之租使用者的名稱。 |
| creationDate | UTC 日期時間格式的字串 | 建立集合的資料與時間。 |
| deviceCount | 數值 | 集合中的裝置數目。 |
| devicesLink | 連結 | 此批次中包含的裝置連結。 |
| attributes | ResourceAttributes | 中繼資料屬性。 |
DeviceBatchCreationRequest
DeviceBatchCreationRequest 提供建立裝置批次並填入裝置所需的資訊。
| 屬性 | 類型 | 描述 |
|---|---|---|
| batchId | string | 與裝置批次相關聯的 GUID 格式字串。 |
| 裝置 | Device 物件的陣列 | 每個物件都會指定裝置。 已接受下列用來識別裝置的欄位組合：hardwareHash 和 productKey、hardwareHash 和 serialNumber、hardwareHash 和 productKey 與 serialNumber、hardwareHash only、productKey only、serialNumber 和 oemManufacturerName 搭配 modelName。 |
| attributes | ResourceAttributes | 中繼資料屬性。 |
DevicePolicyUpdateRequest
DevicePolicyUpdateRequest 提供使用原則更新裝置清單所需的資訊。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 裝置 | Device 物件的陣列 | 每個物件都會指定裝置。 需要下列屬性：識別碼和原則。 |
| attributes | ResourceAttributes | 中繼資料屬性。 |