取得產品數據
使用 Microsoft 硬體 API 中的下列方法,擷取註冊至 開發人員中心 帳戶的硬體產品數據。 如需Microsoft硬體 API 的簡介,包括使用 API 的必要條件,請參閱 使用 API 管理硬體提交。
https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/
您必須先存在於 開發人員中心 帳戶中,才能使用這些方法。 若要建立或管理產品的提交,請參閱管理產品提交中的方法。
方法 | URI | 描述 |
---|---|---|
GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/ |
取得您所有產品的數據 |
GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} |
取得特定產品的數據 |
GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions |
取得產品所有提交的數據 |
GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} |
取得產品特定提交的數據 |
必要條件
嘗試使用上述任何方法之前,請先完成Microsoft硬體 API 的所有 必要條件 。
資料資源
取得產品數據的Microsoft硬體 API 方法會使用下列 JSON 數據資源
產品資源
此資源代表已向您的帳戶註冊的硬體產品(驅動程式)。
{
"id": 9007199267351834,
"sharedProductId": 1152921504606971100,
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/9007199267351834",
"rel": "self",
"method": "GET"
},
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/9007199267351834/submissions",
"rel": "get_submissions",
"method": "GET"
}
],
"isCommitted": true,
"isExtensionInf": false, "_comment": "This field is deprecated and moved to submission resource",
"deviceMetadataIds": [],
"deviceType": "notSet",
"isTestSign": false,
"isFlightSign": false,
"marketingNames": [
"marketing name 1",
"marketing name 2"
],
"productName": "product name",
"selectedProductTypes": {
"windows_v100Server": "Unclassified",
"windows_v100": "Unclassified"
},
"requestedSignatures": [
"WINDOWS_v100_X64_TH1_FULL",
"WINDOWS_v63_X64"
],
"additionalAttributes": {},
"testHarness": "hlk",
"announcementDate": "2016-10-22T00:00:00Z",
}
此資源具有下列值
值 | 類型 | 描述 |
---|---|---|
Id | Long | 產品的私人產品標識碼 |
sharedProductId | Long | 產品的共享產品標識碼 |
連結 | 物件陣列 | 如需詳細資訊,請參閱鏈接物件 |
isCommitted | 布林值 | 指出產品是否至少有一個已認可提交 |
isExtensionInf | 布林值 | (已淘汰)指出產品是否為延伸模組驅動程式。 此欄位已被取代,不應再使用。 isExtensionInf 已移至提交層級屬性。 |
deviceMetadataIds | GUID 的陣列 | 將裝置元數據提交對應至驅動程式的 GUID |
deviceType | String | 指出裝置的類型。 可能的值包括:
|
isTestSign | 布林值 | 指出產品是否為測試簽署的驅動程式。 如需測試簽署驅動程式套件的詳細資訊,請參閱 WHQL 測試簽章計劃 |
isFlightSign | 布林值 | 指出產品是否為正式發行前小眾測試版簽署的驅動程式。 正式發行前小眾測試版簽署的驅動程式是可透過 Windows Update 發佈的測試驅動程式。 它們只能在註冊 Windows 測試人員計劃的電腦上發佈/安裝。 它們可以安裝在機器上,而不需要停用安全開機。 它們無法安裝在不屬於 Windows 測試人員計劃的零售電腦上。 |
marketingNames | 字串陣列 | 產品的行銷名稱或別名 |
productName | String | 建立期間指定的驅動程式名稱 |
selectedProductTypes | 字典 | 兩者都是字串的索引鍵值組。 |
requestedSignatures | 字串陣列 | 認證產品的操作系統簽章清單。 如需所有作業系統的清單,請參閱 OS 程式代碼清單。 |
additionalAttributes | Object | 如需詳細資訊,請參閱 其他屬性物件。 |
testHarness | 字串 | 提交的套件類型。 可能的值包括:
|
announcementDate | Datetime | 產品包含在 Windows Server 目錄上的日期。 |
提交資源
此資源代表產品的提交。
{
"id": 1152921504621442000,
"productId": 13635057453741328,
"workflowStatus": {
"currentStep": "finalizeIngestion",
"state": "completed",
"messages": []
},
"links": [
{
"href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/13635057453741329/submissions/1152921504621441944",
"rel": "self",
"method": "GET"
}
],
"commitStatus": "CommitPending",
"isExtensionInf": true,
"isUniversal": true,
"isDeclarativeInf": true,
"name": "HARRY-Duatest2",
"type": "derived"
}
此資源具有下列值:
值 | 類型 | 描述 |
---|---|---|
Id | long | 提交的標識碼 |
Productid | long | 與此提交相關聯的私人產品標識碼 |
workflowstatus | object | 只有在擷取特定提交的詳細數據時,才能使用這項功能。 此物件描述此提交的工作流程狀態。 如需詳細資訊,請參閱 工作流程狀態物件。 |
連結 | 物件陣列 | 如需詳細資訊,請參閱鏈接物件 |
commitStatus | 如需詳細資訊,請參閱管理產品提交。 | |
isExtensionInf | 布林值 | 指出提交是否為延伸模組驅動程式 |
isUniversal | 布林值 | 指出提交是否通過通用 API 測試。 如果驅動程式為宣告式和通用,則驅動程式符合 DCHU 規範 |
isDeclarativeInf | 布林值 | 指出提交是否通過宣告式 INVerif 測試。 如果驅動程式為宣告式和通用,則驅動程式符合 DCHU 規範。 |
名稱 | 字串 | 提交的名稱。 |
型別 | 字串 | 指出提交是初始或衍生的提交。 可能的值包括:
|
下載 | object | 只有在擷取特定提交的詳細數據時,才可使用此專案。 此物件描述提交可用的下載。 如需詳細資訊,請參閱 下載物件。 |
工作流程狀態物件
這個物件代表指定實體的工作流程狀態
{
"currentStep": "finalizeIngestion",
"state": "completed",
"messages": []
}
此物件具有下列值
值 | 類型 | 描述 |
---|---|---|
currentStep | 字串 | 此實體整體工作流程中目前步驟的名稱。 針對擷取/套件提交,可能的值為 (括弧中的描述):
|
州 (縣/市) | 字串 | 目前步驟的狀態。 可能的值包括:
|
訊息 | 陣列 | 字串數位,以提供目前步驟的相關訊息(特別是如果失敗時) |
下載物件
這個物件代表指定提交的下載。
{
"items": [
{
"type": "initialPackage",
"url": "<SAS URL from Hardware API>"
},
{
"type": "derivedPackage",
"url": "<SAS URL from Hardware API>"
},
{
"type": "signedPackage",
"url": "<SAS URL from Hardware API>"
},
{
"type": "certificationReport",
"url": "https:// manage.devcenter.microsoft.com/dashboard/hardware/Driver/DownloadCertificationReport/29963920/13635057453741329/1152921504621441930"
}
],
"messages": []
}
此物件具有下列值
值 | 類型 | 描述 |
---|---|---|
項目 | 陣列 | 每個下載類型和 URL 的陣列。 |
型別 | 字串 | 可供下載的套件類型。 可能的值包括:
|
訊息 | 陣列 | 字串數位,提供可下載檔案的相關訊息 |
Link 物件
此物件代表包含實體的實用連結清單
{
"href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/9007199267351834",
"rel": "self",
"method": "GET"
}
此物件具有下列值
值 | 類型 | 描述 |
---|---|---|
Href | String | 可透過 API 存取資源的 URL |
相對 | String | 資源類型。 可能的值包括:
|
方法 | String | 叫用 URL 時要使用的 HTTP 方法類型。 可能的值包括:
|
其他 Attribute 物件
如果此物件的類型為RAID控制器、記憶體控制器或伺服器虛擬化驗證程式 (SVVP),則此物件會提供產品的相關更多屬性。 它可以包含三種類型的物件之一 : StorageController、RaidController 或 SVVP。
StorageController 物件
值 | 類型 | 描述 |
---|---|---|
biosVersion | 字串 | ROM Bios 版本 |
firmwareVersion | 字串 | 韌體版本 |
driverVersion | 字串 | 驅動程式版本 |
driverName | 字串 | 驅動程式名稱 |
deviceVersion | 字串 | 裝置版本 |
晶片組名稱 | 字串 | 晶片組名稱 |
usedProprietary | boolean | 透過專屬驅動程式支援多重路徑。 如果為 true,則必須使用 proprietaryName 和 proprietaryVersion。 |
proprietaryName | 字串 | 多重路徑軟體名稱 |
proprietaryVersion | 字串 | 多重路徑軟體版本 |
usedMicrosoft | boolean | Microsoft透過裝置特定模組支援的 MPIO。 如果為 true,則 microsoftName 和 microsoftVersion 是必要的。 |
microsoftName | 字串 | 多重路徑軟體名稱 |
microsoftVersion | 字串 | 多重路徑軟體版本 |
usedBootSupport | boolean | 開機支援 |
usedBetterBoot | boolean | 開機 > 2.2-TB 支援。 如果為 true,則必須支援 UEFI 版本和支援的 ACPI 版本 |
uefiVersion | 字串 | 支援的 UEFI 版本 |
acpiVersion | 字串 | 支援的 ACPI 版本 |
supportsSector4K512E | boolean | 支援扇區大小 4K/512e |
supportsSector4K4K | boolean | 支援扇區大小 4K/4K |
supportsDifferential | boolean | 差異 (高壓差異) |
RaidController 物件
值 | 類型 | 描述 |
---|---|---|
firmwareVersion | 字串 | 韌體版本 |
filterVersion | 字串 | 驅動程式版本 |
driverVersion | 字串 | 篩選版本 |
usedProprietary | boolean | 透過專屬驅動程式支援多重路徑。 如果為 true,則必須使用 proprietaryName 和 proprietaryVersion |
proprietaryName | 字串 | 多重路徑軟體名稱 |
proprietaryVersion | 字串 | 多重路徑軟體版本 |
usedMicrosoft | boolean | Microsoft透過裝置特定模組支援的 MPIO。 如果為 true,則 microsoftName 和 microsoftVersion 是必要的 |
microsoftName | 字串 | 多重路徑軟體名稱 |
microsoftVersion | 字串 | 多重路徑軟體版本 |
isThirdPartyNeeded | boolean | 線上所需的非Microsoft驅動程式 |
isSES | boolean | SES (SCSI 機箱服務)。 指出是否包含 SES。 SCSI 是連接系統上裝置的服務總線標準詞彙,最初稱為小型計算機系統介面。 SES 適用於 SCSI 機箱服務。 |
isSAFTE | boolean | SAF-TE (ANBll 規格)。 指出是否包含 SAF-TE。 ANBll 產業規格。 SAF-TE 適用於 SCSI 存取容錯機箱。 SCSI 是連接系統上裝置的服務總線標準詞彙,最初稱為小型計算機系統介面。 |
additionalInfo | 字串 | 附加資訊 |
SVVP 物件
值 | 類型 | 描述 |
---|---|---|
productVersion | 字串 | 產品版本 |
supportLink | 字串 | 支援 URL |
guestOs | 字串 | 客體OS。 可能的值包括:
|
processorArchitecture | 字串 | 硬體處理器架構。 可能的值包括:
|
maxProcessors | 整數 | VM 中的處理器數目上限 |
maxMemory | 整數 | VM 中的記憶體上限(以 GB 為單位) |
產品類型清單
產品可以是下列類型。 除了操作系統之外,這項資訊也可用來識別適用性。
- 3D 印表機
- 加速計感測器
- 全部一個
- All In One with Touch
- 音訊裝置
- 音訊處理物件
- 藍牙控制器
- 藍牙控制器非USB
- 相機
- 數位相機感測器
- Cluster
- 計算加速器 MCDM 2.7
- 計算加速器 MCDM 3.1
- 計算加速器 MCDM 3.2
- 可轉換平板電腦
- 桌面
- 數位媒體轉譯器
- 數位媒體伺服器
- 數位靜止相機
- 數位攝影機
- 已啟用散發掃描管理的裝置
- 企業 WSD 多功能印表機
- 手指列印讀取器
- 遊戲控制器
- 一般控制器
- 一般可攜式裝置
- 圖形配接器 MCDM2.7
- 圖形配接器 MCDM2.8
- 圖形配接器 MCDM2.9
- 圖形配接器 MCDM3.0
- 圖形配接器 WDDM1.0
- 圖形配接器 WDDM1.1
- 圖形配接器 WDDM1.2
- 圖形配接器 WDDM1.2 DisplayOnly
- 圖形配接器 WDDM1.2 RenderOnly
- 圖形配接器 WDDM1.3
- 圖形配接器 WDDM1.3 DisplayOnly
- 圖形配接器 WDDM1.3 RenderOnly
- 圖形配接器 WDDM2.0
- 圖形配接器 WDDM2.0 僅顯示
- 僅限圖形配接器 WDDM2.0 轉譯
- 圖形配接器 WDDM2.1
- 僅限圖形配接器 WDDM2.1 顯示
- 僅限圖形配接器 WDDM2.1 轉譯
- 圖形配接器 WDDM2.2
- 僅限圖形配接器 WDDM2.2 顯示
- 僅限圖形配接器 WDDM2.2 轉譯
- 圖形配接器 WDDM2.3
- 僅限圖形配接器 WDDM2.3 顯示
- 僅限圖形配接器 WDDM2.3 轉譯
- 圖形配接器 WDDM2.4
- 僅限圖形配接器 WDDM2.4 顯示
- 僅限圖形配接器 WDDM2.4 轉譯
- 圖形配接器 WDDM2.4 VM
- 圖形配接器 WDDM2.5
- 僅限圖形配接器 WDDM2.5 顯示
- 僅限圖形配接器 WDDM2.5 轉譯
- 圖形配接器 WDDM2.5 VM
- 圖形配接器 WDDM2.6
- 僅限圖形配接器 WDDM2.6 顯示
- 僅限圖形配接器 WDDM2.6 轉譯
- 圖形配接器 WDDM2.6 VM
- 圖形配接器 WDDM2.7
- 僅限圖形配接器 WDDM2.7 顯示
- 僅限圖形配接器 WDDM2.7 轉譯
- 圖形配接器 WDDM2.7 VM
- 圖形配接器 WDDM2.8
- 僅限圖形配接器 WDDM2.8 顯示
- 僅限圖形配接器 WDDM2.8 轉譯
- 圖形配接器 WDDM2.8 VM
- 圖形配接器 WDDM2.9
- 僅限圖形配接器 WDDM2.9 顯示
- 僅限圖形配接器 WDDM2.9 轉譯
- 圖形配接器 WDDM2.9 VM
- 圖形配接器 WDDM3.0
- 圖形配接器 WDDM3.0 僅顯示
- 僅限圖形配接器 WDDM3.0 轉譯
- 圖形配接器 WDDM3.0 VM
- 圖形配接器 WDDM3.1
- 僅限圖形配接器 WDDM3.1 顯示
- 僅限圖形配接器 WDDM3.1 轉譯
- 圖形配接器 WDDM3.1 VM
- 圖形配接器 WDDM3.2
- 僅限圖形配接器 WDDM3.2 顯示
- 僅限圖形配接器 WDDM3.2 轉譯
- 圖形配接器 WDDM3.2 VM
- 圖形平板電腦
- 陀螺儀感測器
- 硬碟
- 硬體多功能轉換
- 鍵盤
- 鍵盤視訊滑鼠開關
- LAN
- LAN (伺服器)
- LAN CS
- LAN 虛擬機器 (伺服器)
- [膝上型電腦]
- 具有觸控功能的膝上型計算機
- 液晶顯示器
- 光感測器
- 位置感測器
- 媒體播放器
- 行動寬頻CDMA
- 行動寬頻 GSM
- 行動電話
- 監視器
- 母板
- 動作感測器融合
- 多功能印表機
- 接近欄位鄰近性
- 網路媒體裝置
- NFC
- NFC 智慧卡卡片閱讀機
- 光驅
- 畫筆數位板
- 指向繪圖
- PrecisionTouchpad
- 目前狀態感測器
- 印表機
- Projector
- 卸除式存放裝置
- 路由器
- 掃描器
- SDIO 控制器
- 伺服器
- 伺服器虛擬化驗證計劃
- 簽章平板電腦
- 智慧卡
- 智慧卡讀取器
- 存放裝置陣列
- 記憶體控制器
- 儲存空間 配接器
- 儲存空間 磁碟驅動器
- Tablet
- 觸控
- 觸控監視器
- TPM20
- Ultra-Mobile PC
- 具有觸控功能的 Ultra 行動電腦
- USB 控制器
- USB 中樞
- 網路攝影機
- WLAN
- WLAN CSB
- WSD 多功能印表機
- WSD 印表機
- WSD 掃描器
操作系統系列代碼清單
下表列出操作系統系列代碼及其描述。
OS 系列程式代碼 | 描述 |
---|---|
WindowsMe | Windows Me |
Windows2000 | Windows 2000 |
Windows98 | Windows 98 |
WindowsNT40 | Windows NT 4.0 |
WindowsXP | Windows XP |
WindowsServer2003 | Windows Server 2003 |
WindowsVista | Windows Vista |
Windows2008Server | Windows Server 2008 |
WindowsHomeServer | Windows Home Server |
Windows7 | Windows 7 |
Windows2008ServerR2 | Windows Server 2008 版本 2 |
WindowsServerSolutions | Windows Server 解決方案 |
Windows8 | Windows 8 |
Windows8Server | Windows Server 2012 |
Windows81 | Windows 8.1 |
Windows81Server | Windows Server 2012 R2 |
Windows_v100 | Windows 10 閾值 |
Windows_v100Server | Windows Server Threshold |
Windows_v100_RS1 | Windows 10 年度更新 |
Windows_v100Server_RS1 | Windows Server 2016 |
Windows_v100_RS2 | Windows 10 RS2 Update |
Windows_v100Server_RS2 | Windows Server RS2 |
Windows_v100_RS3 | Windows 10 RS3 更新 |
Windows_v100Server_RS3 | Windows Server RS3 |
Windows_v100_RS4 | Windows 10 RS4 Update |
Windows_v100Server_RS5 | Windows Server 2019 |
Windows_v100_RS5 | Windows 10 RS5 x86 |
Windows_v100_RS5 | Windows 10 RS5 x64 |
Windows_v100_19H1 | Windows 10 19H1 Update |
Windows_v100_VB | Windows 10 版本 2004 |
Windows_v100Server_FE | Windows - Server 版本 21H2 |
Windows_v100_CO | Windows - 用戶端版本 21H2 |
Windows_v100_NI | Windows 11 用戶端版本 22H2 |
Windows_v100_GE | Windows 11 用戶端版本 24H2 |
Windows_v100Server_GE | Windows Server 2025 |
操作系統程式代碼清單
下表列出操作系統代碼及其描述。
OS 程式代碼 | 描述 |
---|---|
WINDOWS_ME | Windows Me |
WINDOWS_98 | Windows 98 |
WINDOWS_2000 | Windows 2000 |
WINDOWS_NT40 | Windows NT 4.0 |
WINDOWS_XP | Windows XP |
WINDOWS_XP_IA64 | Windows XP IA64 |
WINDOWS_XP_X64 | Windows XP X64 |
WINDOWS_XP_MEDIA_CENTER | Windows XP Media Center |
WINDOWS_2003 | Windows Server 2003 |
WINDOWS_2003_IA64 | Windows Server 2003 IA64 |
WINDOWS_2003_X64 | Windows Server 2003 X64 |
WINDOWS_VISTA | Windows Vista 用戶端 |
WINDOWS_VISTA_X64 | Windows Vista 用戶端 X64 |
WINDOWS_2008_SERVER | Windows Server 2008 |
WINDOWS_2008_SERVER_IA64 | Windows Server 2008 IA64 |
WINDOWS_2008_SERVER_X64 | Windows Server 2008 X64 |
WINDOWS_HOME_SERVER | Windows Home Server |
WINDOWS_7 | Windows 7 用戶端 |
WINDOWS_7_X64 | Windows 7 用戶端 x64 |
WINDOWS_2008_SERVER_R2_IA64 | Windows Server 2008 版本 2 IA64 |
WINDOWS_2008_SERVER_R2_X64 | Windows Server 2008 版本 2 x64 |
WINDOWS_SERVER_SOLUTIONS_X64 | Windows Server Solutions x64 |
WINDOWS_8 | Windows 8 用戶端 |
WINDOWS_8_X64 | Windows 8 用戶端 x64 |
WINDOWS_8_ARM | Windows 8 用戶端 RT |
WINDOWS_8_SERVER_X64 | Windows Server 2012 |
WINDOWS_v63 | Windows 8.1用戶端 |
WINDOWS_v63_X64 | Windows 8.1 Client x64 |
WINDOWS_v63_ARM | Windows 8.1用戶端 RT |
WINDOWS_v63_SERVER_X64 | Windows Server 2012 R2 x64 |
WINDOWS_v100_TH1_FULL | Windows 10 用戶端版本 1506 和 1511 (TH1) |
WINDOWS_v100_X64_TH1_FULL | Windows 10 用戶端版本 1506 和 1511 x64 (TH1) |
WINDOWS_v100_SERVER_X64_TH1_FULL | Windows Server 2016 x64 (TH1) |
WINDOWS_v100_TH2_FULL | Windows 10 用戶端版本 1506 和 1511 (TH2) |
WINDOWS_v100_X64_TH2_FULL | Windows 10 用戶端版本 1506 和 1511 x64 (TH2) |
WINDOWS_v100_SERVER_X64_TH2_FULL | Windows Server 2016 x64 (TH2) |
WINDOWS_v100_RS1_FULL | Windows 10 用戶端版本 1607 |
WINDOWS_v100_X64_RS1_FULL | Windows 10 用戶端版本 1607 x64 |
WINDOWS_v100_SERVER_X64_RS1_FULL | Windows Server 2016 x64 (RS1) |
WINDOWS_v100_RS2_FULL | Windows 10 RS2 用戶端 |
WINDOWS_v100_X64_RS2_FULL | Windows 10 RS2 用戶端 x64 |
WINDOWS_v100_RS3_FULL | Windows 10 RS3 用戶端 |
WINDOWS_v100_X64_RS3_FULL | Windows 10 RS3 用戶端 x64 |
WINDOWS_v100_ARM64_RS3_FULL | Windows 10 RS3 用戶端 Arm64 |
WINDOWS_v100_RS4_FULL | Windows 10 RS4 用戶端 |
WINDOWS_v100_X64_RS4_FULL | Windows 10 RS4 用戶端 x64 |
WINDOWS_v100_ARM64_RS4_FULL | Windows 10 RS4 用戶端 Arm64 |
WINDOWS_v100_SERVER_X64_RS5_FULL | Windows Server 2019 |
WINDOWS_v100_RS5_FULL | Windows 10 RS5 x86 |
WINDOWS_v100_X64_RS5_FULL | Windows 10 RS5 用戶端 x64 |
WINDOWS_v100_19H1_FULL | Windows 19H1 用戶端 x86 |
WINDOWS_v100_X64_19H1_FULL | Windows 19H1 用戶端 x64 |
WINDOWS_v100_ARM64_19H1_FULL | Windows 19H1 用戶端 Arm64 |
WINDOWS_v100_VB_FULL | Windows 10 版本 2004 用戶端 x86 |
WINDOWS_v100_X64_VB_FULL | Windows 版本 2004 用戶端 x64 |
WINDOWS_v100_ARM64_VB_FULL | Windows 版本 2004 用戶端 Arm64 |
WINDOWS_v100_SERVER_X64_FE_FULL | Windows - Server 版本 21H2 x64 |
WINDOWS_v100_SERVER_ARM64_FE_FULL | Windows - Server 版本 21H2 Arm64 |
WINDOWS_v100_X64_CO_FULL | Windows - 用戶端版本 21H2 x64 |
WINDOWS_v100_ARM64_CO_FULL | Windows - 用戶端版本 21H2 Arm64 |
WINDOWS_v100_X64_NI_FULL | Windows 11 用戶端版本 22H2 x64 |
WINDOWS_v100_ARM64_NI_FULL | Windows 11 用戶端版本 22H2 Arm64 |
WINDOWS_v100_X64_GE_FULL | Windows 11 用戶端版本 24H2 x64 |
WINDOWS_v100_ARM64_GE_FULL | Windows 11 用戶端版本 24H2 ARM64 |
WINDOWS_v100_SERVER_X64_GE_FULL | Windows Server 2025 x64 |
WINDOWS_v100_SERVER_ARM64_GE_FULL | Windows Server 2025 ARM64 |
錯誤碼
錯誤碼適用於 API 的所有 Web 方法。 如果無法順利完成要求,回應會包含下列其中一個 HTTP 錯誤碼。
HTTP 狀態 | 描述 |
---|---|
400 – 不正確的要求 | 要求格式不正確(例如格式不正確的要求語法、無效的要求訊息框架或欺騙性要求路由) |
401 - 未經授權 | 驗證失敗或未提供 |
403 - 禁止 | 禁止存取資源。 |
404 – 找不到 | 找不到要求的實體。 |
415 - 不支援的媒體類型 | Payload 的格式為目標資源上此方法不支援的格式。 |
422 - 無法處理的實體 | 驗證失敗。 |
429 - 要求太多 | 傳送太多要求。 呼叫會進行節流處理,並在回應中提供輪詢時間。 |
500 - 內部伺服器錯誤 | API 伺服器發生無法復原的錯誤。 |
如果發生功能驗證失敗,響應主體會包含下列其中一個功能錯誤碼。
錯誤碼 | 錯誤訊息 | 描述 |
---|---|---|
InvalidInput | 輸入驗證失敗時傳回。 | |
RequestInvalidForCurrentState | 只有擱置的提交才能認可 | 在未處於擱置狀態的提交上套用認可時傳回。 |
RequestInvalidForCurrentState | 初始提交已經存在 | 針對已經有初始提交的驅動程式建立初始提交時,會傳回 。 |
RequestInvalidForCurrentState | 無法建立衍生提交,因為未建立初始提交 | 針對沒有初始提交的驅動程式建立衍生提交時傳回。 |
UpdateUnauthorized | 未獲授權更新產品 | 嘗試更新共用產品時傳回 ,因為無法更新共享產品。 |
UpdateUnauthorized | 若未提交初始提交,就無法更新產品 | 嘗試更新沒有初始提交的產品時傳回。 |
UpdateUnauthorized | 無法更新產品,因為工作流程失敗 | 嘗試更新具有失敗工作流程的產品時傳回。 |
UpdateUnauthorized | 擷取程式完成之後,無法更新公告日期 | 在擷取完成後更新公告日期時傳回。 |
UpdateUnauthorized | 目前無法更新產品名稱。 然後再試一次。 | |
UpdateUnauthorized | 未獲授權更新提交 | 嘗試更新已共用(轉售)產品提交時傳回,因為無法更新共享產品。 |
UpdateUnauthorized | 無法更新提交,因為工作流程失敗 | 嘗試更新具有失敗工作流程的提交時傳回。 |
EntityNotFound | 找不到提交 | 嘗試認可不存在的提交時傳回。 |
EntityNotFound | 找不到產品 | 嘗試建立產品不存在的提交時傳回。 |
InvalidInput | 擴充功能驅動程式必須發佈為自動更新。 isAutoInstallDuringOSUpgrade 或 isAutoInstallOnApplicableSystems 必須為 true。 | 建立擴充功能 INF 的 Windows 更新寄送標籤時傳回,而不需要選擇 isAutoInstallDuringOSUpgrade 或 isAutoInstallOnApplicableSystems。 |
InvalidInput | 只有在 HardwareId 適用於作業系統 Windows 10 和更新版本時,才允許 CHID。 | 當以小於 Windows 10 為目標的出貨標籤使用 CHID 目標建立時傳回。 CHID 目標僅適用於 Windows 10 和更新版本。 |
InvalidInput | 當另一個工作流程正在進行時,無法更新出貨標籤。 然後再試一次。 | 當先前的工作流程仍在進行中時更新出貨標籤時傳回。 |
RequestInvalidForCurrentState | 無法為收件匣或系統類型建立發佈出貨標籤。 一個只能共用出貨標籤。 | 在收件匣驅動程式或系統上建立 Windows Update Shipping 標籤時傳回。 |
RequestInvalidForCurrentState | 提交尚未準備好建立出貨標籤。 請稍後重試。 | 建立出貨標籤時傳回,而不需要等待準備或前置處理完成。 |