获取产品数据
使用 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 | 产品的专用产品 ID |
sharedProductId | Long | 产品的共享产品 ID |
链接 | 对象数组 | 有关更多详细信息,请参阅链接对象 |
isCommitted | 布尔 | 指示产品是否至少有一个确认的提交 |
isExtensionInf | 布尔 | (已弃用)指示产品是否为扩展驱动程序。 此字段已弃用,不应再使用。 isExtensionInf 移至提交级别属性。 |
deviceMetadataIds | GUID 数组 | 将设备元数据提交映射到驱动程序的 GUID |
deviceType | 字符串 | 指示设备的类型。 可能的值为:
|
isTestSign | 布尔 | 指示产品是否为经过测试签名的驱动程序。 有关对驱动程序包进行测试签名的详细信息,请参阅 WHQL Test Signature Program(WHQL 测试签名计划) |
isFlightSign | 布尔 | 指示产品是否为经过外部测试签名的驱动程序。 经过外部测试签名的驱动程序是指可以通过 Windows 更新发布的测试驱动程序。 它们只能在已注册 Windows 预览体验计划的计算机上发布/安装。 它们可以安装在未禁用安全启动的计算机上。 它们不能在未加入 Windows 预览体验计划的零售计算机上安装。 |
marketingNames | 字符串数组 | 产品的营销名称或别名 |
productName | 字符串 | 在创建期间指定的驱动程序的名称 |
selectedProductTypes | dictionary | 均为字符串的键值对。
|
requestedSignatures | 字符串数组 | 产品通过认证的操作系统签名的列表。 有关所有操作系统的列表,请参阅操作系统代码列表。 |
additionalAttributes | Object | 有关详细信息,请参阅附加属性对象。 |
testHarness | string | 提交的包类型。 可能的值为:
|
announcementDate | datetime | 产品被纳入 Windows Server Catalog 中的日期。 |
提交资源
此资源表示产品的提交。
{
"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 | 提交的 ID |
Productid | 长型 | 与此提交关联的专用产品 ID |
workflowstatus | object | 此项仅在检索特定提交的详细信息时可用。 此对象描述此提交的工作流状态。 有关详细信息,请参阅工作流状态对象。 |
链接 | 对象数组 | 有关更多详细信息,请参阅链接对象 |
commitStatus | 请参阅管理产品提交,了解更多详细信息。 | |
isExtensionInf | 布尔 | 指示提交是否为扩展驱动程序 |
isUniversal | 布尔 | 指示提交是否通过通用 API 测试。 如果驱动程序是声明式且通用,则它符合 DCHU 标准 |
isDeclarativeInf | 布尔 | 指示提交是否通过声明性 INVerif 测试。 如果驱动程序是声明式且通用,则它符合 DCHU 标准。 |
名称 | string | 提交的名称。 |
类型 | string | 指示提交是初始提交还是派生的提交。 可能的值为:
|
下载 | object | 此项仅在只检索特定提交的详细信息时可用。 此对象描述可用于提交的下载。 有关详细信息,请参阅下载对象。 |
工作流状态对象
此对象表示给定实体的工作流状态
{
"currentStep": "finalizeIngestion",
"state": "completed",
"messages": []
}
此对象具有以下值
值 | 类型 | 描述 |
---|---|---|
currentStep | string | 此实体的整个工作流中的当前步骤名称。 对于引入/程序包提交,可能的值为(括号中的内容为说明):
|
State | string | 当前步骤的状态。 可能的值为:
|
消息 | array | 一个字符串数组,用于提供有关当前步骤的消息(特别是在失败时) |
下载对象
此对象表示给定提交的下载。
{
"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": []
}
此对象具有以下值
值 | 类型 | 描述 |
---|---|---|
项目 | array | 下载类型和每种类型的 URL 的数组。 |
类型 | string | 可供下载的程序包的类型。 可能的值为:
|
消息 | array | 一个字符串数组,用于提供有关可下载文件的消息 |
链接对象
此对象表示包含实体的帮助链接的列表
{
"href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/9007199267351834",
"rel": "self",
"method": "GET"
}
此对象具有以下值
值 | 类型 | 描述 |
---|---|---|
Href | 字符串 | 通过 API 访问资源的 URL |
Rel | 字符串 | 资源的类型。 可能的值为:
|
方法 | 字符串 | 调用 URL 时要使用的 http 方法的类型。 可能的值为:
|
附加属性对象
如果产品的类型是 RAID 控制器、存储控制器或服务器虚拟化验证计划 (SVVP),则此对象提供有关产品的更多属性。 它可能包含 StorageController、RaidController、SVVP 这三种对象类型中的一种。
StorageController 对象
值 | 类型 | 描述 |
---|---|---|
biosVersion | string | ROM Bios 版本 |
firmwareVersion | string | 固件版本 |
driverVersion | string | 驱动程序版本 |
driverName | string | 驱动程序名称 |
deviceVersion | string | 设备版本 |
chipsetName | string | 芯片组名称 |
usedProprietary | boolean | 通过专用驱动程序支持的多路径。 如果为 true,则 proprietaryName 和 proprietaryVersion 是必需项。 |
proprietaryName | string | 多路径软件名称 |
proprietaryVersion | string | 多路径软件版本 |
usedMicrosoft | boolean | 通过特定于设备的模块支持的 Microsoft MPIO。 如果为 true,则 microsoftName 和 microsoftVersion 是必需项。 |
microsoftName | string | 多路径软件名称 |
microsoftVersion | string | 多路径软件版本 |
usedBootSupport | boolean | 启动支持 |
usedBetterBoot | boolean | 启动 > 2.2 TB 支持。 如果为 true,则支持的 UEFI 版本和支持的 ACPI 版本是必需项 |
uefiVersion | string | 支持的 UEFI 版本 |
acpiVersion | string | 支持的 ACPI 版本 |
supportsSector4K512E | boolean | 支持 4K/512e 扇区大小 |
supportsSector4K4K | boolean | 支持 4K/4K 扇区大小 |
supportsDifferential | boolean | 差分(高压差分) |
RaidController 对象
值 | 类型 | 描述 |
---|---|---|
firmwareVersion | string | 固件版本 |
filterVersion | string | 驱动程序版本 |
driverVersion | string | 筛选器版本 |
usedProprietary | boolean | 通过专用驱动程序支持的多路径。 如果为 true,则 proprietaryName 和 proprietaryVersion 是必需项 |
proprietaryName | string | 多路径软件名称 |
proprietaryVersion | string | 多路径软件版本 |
usedMicrosoft | boolean | 通过特定于设备的模块支持的 Microsoft MPIO。 如果为 true,则 microsoftName 和 microsoftVersion 是必需项 |
microsoftName | string | 多路径软件名称 |
microsoftVersion | string | 多路径软件版本 |
isThirdPartyNeeded | boolean | 进行连接所需的非 Microsoft 驱动程序 |
isSES | boolean | SES (SCSI Enclosure Services)。 指示是否包含 SES。 SCSI 是连接系统设备的服务总线的标准术语,最初是指 Small Computer System Interface(小型计算机系统接口)。 SES 是 SCSI Enclosure Services 的简称。 |
isSAFTE | boolean | SAF-TE(ANBll 规范)。 指示是否包含 SAF-TE。 ANBll 是一项行业规范。 SAF-TE 是 SCSI Accessed Fault Tolerant Enclosures 的简称。 SCSI 是连接系统设备的服务总线的标准术语,最初是指 Small Computer System Interface(小型计算机系统接口)。 |
additionalInfo | string | 其他信息 |
SVVP 对象
值 | 类型 | 描述 |
---|---|---|
productVersion | string | 产品版本 |
supportLink | string | 支持 URL |
guestOs | string | 来宾操作系统。 可能的值为:
|
processorArchitecture | string | 硬件处理器体系结构。 可能的值为:
|
maxProcessors | integer | 虚拟机中的最大处理器数 |
maxMemory | integer | 虚拟机中的最大内存(以 GB 为单位) |
产品类型列表
产品可以是以下类型。 这些信息与操作系统一起用于确定适用性。
- 3D 打印机
- 加速计传感器
- 一体机
- 触控一体机
- 音频设备
- 音频处理对象
- 蓝牙控制器
- 蓝牙控制器(非 USB)
- Camera
- 相机传感器
- 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 虚拟机(服务器)
- 笔记本电脑
- 触控式笔记本电脑
- LCD
- 光传感器
- 位置传感器
- 媒体播放器
- 移动宽带 CDMA
- 移动宽带 GSM
- 移动电话
- 监视器
- 母板
- 运动传感器融合
- 多功能打印机
- 近场近程
- 网络媒体设备
- NFC
- NFC 智能卡读卡器
- 光驱
- 触控笔数字化器
- 指向绘图
- 精确式触控板
- 存在传感器
- 打印机
- 投影仪
- 可移动存储
- 路由器
- 扫描仪
- SDIO 控制器
- Server
- 服务器虚拟化验证计划
- 签名平板电脑
- 智能卡
- 智能卡读卡器
- 存储阵列
- 存储控制器
- 存储空间适配器
- 存储空间驱动器
- 平板电脑
- 触控
- 触控监视器
- TPM20
- 超级移动电脑
- 触控式超级移动电脑
- USB 控制器
- USB 集线器
- 网络摄像头
- WLAN
- WLAN CSB
- WSD 多功能打印机
- WSD 打印机
- WSD 扫描仪
操作系统系列代码列表
下表列出了操作系统系列代码及其说明。
操作系统系列代码 | 说明 |
---|---|
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 Release 2 |
WindowsServerSolutions | Windows Server 解决方案 |
Windows8 | Windows 8 |
Windows8Server | Windows Server 2012 |
Windows81 | Windows 8.1 |
Windows81Server | Windows Server 2012 R2 |
Windows_v100 | Windows 10 Threshold |
Windows_v100Server | Windows Server Threshold |
Windows_v100_RS1 | Windows 10 周年更新 |
Windows_v100Server_RS1 | Windows Server 2016 |
Windows_v100_RS2 | Windows 10 RS2 更新 |
Windows_v100Server_RS2 | Windows Server RS2 |
Windows_v100_RS3 | Windows 10 RS3 更新 |
Windows_v100Server_RS3 | Windows Server RS3 |
Windows_v100_RS4 | Windows 10 RS4 更新 |
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 更新 |
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 |
操作系统代码列表
下表列出了操作系统代码及其说明。
操作系统代码 | 说明 |
---|---|
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 Release 2 IA64 |
WINDOWS_2008_SERVER_R2_X64 | Windows Server 2008 Release 2 x64 |
WINDOWS_SERVER_SOLUTIONS_X64 | Windows Server 解决方案 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 客户端 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 - 不支持的媒体类型 | 在目标资源上,此方法不支持有效负载的格式。 |
422 - 无法处理的实体 | 验证失败。 |
429 - 请求次数过多 | 发送的请求太多。 调用受到限制,响应中提供了回退时间。 |
500 - 内部服务器错误 | API 服务器中出现无法恢复的错误。 |
如果功能验证失败,则响应正文包含以下其中一个功能错误代码。
错误代码 | 错误消息 | 说明 |
---|---|---|
InvalidInput | 输入验证失败时返回此项。 | |
RequestInvalidForCurrentState | 只能确认待定提交 | 对未处于待定状态的提交应用确认时返回此项。 |
RequestInvalidForCurrentState | 初始提交已存在 | 为已有初始提交的驱动程序创建初始提交时返回此项。 |
RequestInvalidForCurrentState | 由于没有创建初始提交,因此无法创建派生提交 | 为没有初始提交的驱动程序创建派生提交时返回。 |
UpdateUnauthorized | 无权更新产品 | 在尝试更新共享(转售)产品时返回,因为共享产品无法更新。 |
UpdateUnauthorized | 无法在没有初次提交的情况下更新产品 | 尝试更新没有初始提交的产品时返回此项。 |
UpdateUnauthorized | 因工作流失败而无法更新产品 | 在尝试更新工作流失败的产品时返回。 |
UpdateUnauthorized | 引入过程完成后不能更新公告日期 | 引入完成后更新公告日期时返回此项。 |
UpdateUnauthorized | 此时无法更新产品名称。 重试。 | |
UpdateUnauthorized | 无权更新提交 | 尝试更新共享(转售)的产品的提交时返回此项,因为无法更新共享的产品。 |
UpdateUnauthorized | 由于工作流失败,因此无法更新提交 | 尝试更新工作流失败的提交时返回此项。 |
EntityNotFound | 未找到提交 | 尝试确认不存在的提交时返回此项。 |
EntityNotFound | 找不到产品 | 尝试创建产品不存在的提交时返回此项。 |
InvalidInput | 扩展驱动程序必须作为自动更新发布。 isAutoInstallDuringOSUpgrade 或 isAutoInstallOnApplicableSystems 必须为 true。 | 在不选择 isAutoInstallDuringOSUpgrade 或 isAutoInstallOnApplicableSystems 的情况下为扩展 INF 创建 Windows 更新发货标签时返回此项。 |
InvalidInput | 只有当 HardwareIds 适用于 Windows 10 及更高版本的操作系统时才允许使用 CHID。 | 如果在启用 CHID 目标设定的情况下创建一个发货标签,且该标签针对的操作系统低于 Windows 10,则会返回此项。 CHID 目标设定仅适用于 Windows 10 及更高版本。 |
InvalidInput | 当另一工作流正在进行的时候,不能更新发货标签。 重试。 | 当前面的某个工作流仍在进行的时候,如果更新发货标签,则会返回此项。 |
RequestInvalidForCurrentState | 无法为收件箱或系统类型创建“发布”发货标签。 只能共享发货标签。 | 在收件箱驱动程序或系统上创建 Windows 更新发货标签时返回此项。 |
RequestInvalidForCurrentState | 提交尚未做好创建发货标签的准备。 请稍后重试。 | 如果在创建发货标签时不需等待准备或预先处理完成,则返回此项。 |