共用方式為


取得產品數據

使用 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 指出裝置的類型。 可能的值包括:
  • 「內部」- 內部元件、裝置是系統的一部分,且會在計算機內連線
  • 「外部」- 外部元件,裝置是連線到電腦的外部裝置(周邊裝置)
  • “internalExternal” - 兩者,裝置都可以在內部(計算機內部)和外部連線(周邊)
  • “notSet” – 沒有可用的數據
isTestSign 布林值 指出產品是否為測試簽署的驅動程式。 如需測試簽署驅動程式套件的詳細資訊,請參閱 WHQL 測試簽章計劃
isFlightSign 布林值 指出產品是否為正式發行前小眾測試版簽署的驅動程式。 正式發行前小眾測試版簽署的驅動程式是可透過 Windows Update 發佈的測試驅動程式。 它們只能在註冊 Windows 測試人員計劃的電腦上發佈/安裝。 它們可以安裝在機器上,而不需要停用安全開機。 它們無法安裝在不屬於 Windows 測試人員計劃的零售電腦上。
marketingNames 字串陣列 產品的行銷名稱或別名
productName String 建立期間指定的驅動程式名稱
selectedProductTypes 字典 兩者都是字串的索引鍵值組。
  • 索引鍵 代表作業系統系列程序代碼。 如需操作系統系列代碼的清單,請參閱 OS 系列代碼清單。
  • 代表產品的型別。 如需產品類型的清單,請參閱 產品類型
requestedSignatures 字串陣列 認證產品的操作系統簽章清單。 如需所有作業系統的清單,請參閱 OS 程式代碼清單。
additionalAttributes Object 如需詳細資訊,請參閱 其他屬性物件
testHarness 字串 提交的套件類型。 可能的值包括:
  • hlk
  • hck
  • 證明
  • notset
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 字串 此實體整體工作流程中目前步驟的名稱。
針對擷取/套件提交,可能的值為 (括弧中的描述):
  • packageInfoValidation (驗證套件元數據和內容
  • 準備 (準備封裝以供處理
  • 掃描 (掃描惡意代碼的套件內容)
  • 驗證 (測試結果驗證)
  • catalogCreation (建立套件的安全性目錄)
  • manualReview (進行手動檢閱
  • 簽署 (簽署二進位檔
  • finalizeIngestion (完成擷取並取得已簽署的檔案以下載或發佈
州 (縣/市) 字串 目前步驟的狀態。 可能的值包括:
  • notStarted
  • 啟動
  • 失敗
  • 已完成
訊息 陣列 字串數位,以提供目前步驟的相關訊息(特別是如果失敗時)

下載物件

這個物件代表指定提交的下載。

{
  "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 的陣列。
型別 字串 可供下載的套件類型。 可能的值包括:
  • “initialPackage” – 使用者上傳的套件(針對新的提交,它會指向上傳套件的 SAS URI)
  • “derivedPackage” – 衍生提交的殼層
  • “signedPackage” - 由 Microsoft 簽署的套件
  • “certificationReport” - 已簽署產品的認證報告
  • driverMetadata - 鏈接會指向允許下載驅動程式元數據的檔案。 如需詳細資訊,請參閱 驅動程式套件元數據
  • ExternalNotes
  • Unknown
訊息 陣列 字串數位,提供可下載檔案的相關訊息

此物件代表包含實體的實用連結清單

{
      "href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/9007199267351834",
      "rel": "self",
      "method": "GET"
    }

此物件具有下列值

類型 描述
Href String 可透過 API 存取資源的 URL
相對 String 資源類型。 可能的值包括:
  • self – 鏈接指向本身
  • next_link – 連結指向通常用於分頁的下一個資源
  • get_submissions – 鏈接指向產品的所有提交
  • commit_submission – 提交認可的連結點
  • update_submission – 鏈接點以更新提交
  • update_shippinglabel – 連結點以更新出貨標籤
方法 String 叫用 URL 時要使用的 HTTP 方法類型。 可能的值包括:
  • GET
  • POST
  • 修補檔

其他 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。 可能的值包括:
  • Windows Server 2008
  • Windows Server 2008 版本 2
  • Windows Server 2012
  • Windows Server 2012 R2
processorArchitecture 字串 硬體處理器架構。 可能的值包括:
  • Xeon
  • Opteron
  • Itanium 2
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 提交尚未準備好建立出貨標籤。 請稍後重試。 建立出貨標籤時傳回,而不需要等待準備或前置處理完成。

另請參閱