Получение данных о продукте

Статья
09/12/2024

Используйте следующие методы в API оборудования Майкрософт, чтобы получить данные для аппаратных продуктов, зарегистрированных в вашей учетной записи Центр разработки. Общие сведения об API оборудования Майкрософт, включая предварительные требования для использования API, см. в статье "Управление отправкой оборудования с помощью API".

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/

Прежде чем использовать эти методы, продукт должен уже существовать в вашей учетной записи Центр разработки. Сведения о создании и управлении отправками для продуктов см. в разделе "Управление отправками продуктов".

Method	URI	Description
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}`	Получение данных для определенной отправки продукта

Необходимые компоненты

Выполните все предварительные требования для API оборудования Майкрософт, прежде чем пытаться использовать любой из этих методов.

Ресурсы данных

Методы 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",
}

Этот ресурс имеет следующие значения.

Значение	Тип	Описание
Артикул	Long	Идентификатор частного продукта продукта
sharedProductId	Long	Общий идентификатор продукта
Ссылки.	массив объектов	Дополнительные сведения см. в разделе "Ссылка объекта "
isCommitted	Логический	Указывает, имеет ли продукт по крайней мере одну зафиксированную отправку
isExtensionInf	Логический	(НЕ РЕКОМЕНДУЕТСЯ) Указывает, является ли продукт драйвером расширения. Это поле устарело и больше не должно использоваться. isExtensionInf перемещен на свойство уровня отправки.
deviceMetadataIds	массив идентификаторов GUID	Идентификаторы GUID, которые сопоставляют отправку метаданных устройства драйверу
deviceType	Строка	Указывает тип устройства. Возможны следующие значения: "internal" — внутренний компонент, устройство является частью системы и подключается к компьютеру "external" — внешний компонент, устройство — это внешнее устройство (периферийное устройство), которое подключается к компьютеру. "internalExternal" — оба устройства могут быть подключены внутренне (внутри компьютера) и внешне (периферийное устройство) NotSet — данные недоступны
isTestSign	Логический	Указывает, является ли продукт тестируемым драйвером, подписанным. Дополнительные сведения о пакетах драйверов для подписывания тестов см. в статье WHQL Test Signature Program
isFlightSign	Логический	Указывает, является ли продукт драйвером, подписанным рейсом. Водители, подписанные полетом, являются тестовые водители, которые можно опубликовать с помощью Обновл. Windows. Их можно публиковать и устанавливать только на компьютерах, зарегистрированных в программе предварительной оценки Windows. Их можно установить на компьютерах без отключения безопасной загрузки. Они не могут быть установлены на розничных компьютерах, которые не являются частью программы предварительной оценки Windows.
marketingNames	массив строк	Маркетинговые имена или псевдонимы продукта
productName	Строка	Имя драйвера, указанного во время создания
selectedProductTypes	dictionary	Пара "Ключевое значение", в которой оба являются строками. Ключ представляет семейный код операционной системы. Список кодов семейства операционных систем см . в списке кодов семейства ОС. Значение представляет тип продукта. Список типов продуктов см. в разделе "Типы продуктов".
запрошенные знаки	массив строк	Список подписей операционной системы, для которых сертифицирован продукт. Список всех операционных систем см . в списке кодов ОС.
additionalAttributes	Object	Дополнительные сведения см. в разделе "Дополнительные атрибуты".
testHarness	строка	Тип отправленного пакета. Возможные значения: hlk hck attestation notset
объявлениеDate	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"
}

Этот ресурс имеет следующие значения:

Значение	Тип	Описание
Артикул	длинный	Идентификатор отправки
Productid	длинный	Идентификатор частного продукта, к которому связана эта отправка
workflowstatus	объект	Это доступно только при получении сведений о конкретной отправке. Этот объект показывает состояние рабочего процесса для этой отправки. Дополнительные сведения см . в разделе "Объект состояния рабочего процесса".
Ссылки.	массив объектов	Дополнительные сведения см. в разделе "Ссылка объекта "
commitStatus	Дополнительные сведения см. в разделе "Управление отправками продуктов".
isExtensionInf	Логический	Указывает, является ли отправка драйвером расширения
isUniversal	Логический	Указывает, передает ли отправка тест универсального API. Драйвер является совместимым с DCHU, если он декларативный и универсальный
isDeclarativeInf	Логический	Указывает, передает ли отправка декларативный тест INVerif. Драйвер является совместимым с DCHU, если он декларативный и универсальный.
Имя.	строка	Имя отправки.
Тип	строка	Указывает, является ли отправка первоначальной или производной. Возможные значения: начальный производные
загрузки	объект	Это доступно только при получении сведений только о конкретной отправке. Этот объект изображает скачиваемый файл, доступный для отправки. Дополнительные сведения см. в разделе "Скачать объект".

Объект "Состояние рабочего процесса"

Этот объект представляет состояние рабочего процесса для заданной сущности.

{
      "currentStep": "finalizeIngestion",
      "state": "completed",
      "messages": []
    }

Этот объект имеет следующие значения

Значение	Тип	Описание
currentStep	строка	Имя текущего шага в общем рабочем процессе для этой сущности. Для приема и отправки пакета возможные значения : (описание в скобках): packageInfoValidation (проверка метаданных и содержимого пакета) подготовка (подготовка пакета к обработке) сканирование (сканирование содержимого пакета для вредоносных программ) проверка (проверка результатов теста) catalogCreation (создание каталога безопасности для пакета) manualReview (прохождение ручной проверки) подпись (подписывание двоичных файлов) завершение приема (завершение приема и получение подписанных файлов, готовых к загрузке или публикации)
State	string	Состояние текущего шага. Возможны следующие значения: notStarted из этих вариантов ошибка Завершено
Сообщения	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-адрес для каждого.
Тип	строка	Тип пакета, доступный для скачивания. Возможны следующие значения: InitialPackage — пакет, отправленный пользователем (для новой отправки, указывает на URI SAS для отправки пакета) "derivedPackage" — оболочка для производных отправки "signedPackage" — пакет, подписанный корпорацией Майкрософт "certificationReport" — отчет о сертификации для подписанного продукта driverMetadata — указывает ссылку на файл, позволяющий скачать метаданные драйвера. Дополнительные сведения см . в разделе метаданных пакета драйверов. ExternalNotes Неизвестно
Сообщения	array	Массив строк для предоставления сообщений о скачиваемых файлах

Объект Link

Этот объект представляет список полезных ссылок для содержащей сущности.

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

Этот объект имеет следующие значения

Значение	Тип	Описание
Href	Строка	URL-адрес для доступа к ресурсу через API
Rel	Строка	Тип ресурса. Возможны следующие значения: self — связь указывает на себя next_link — ссылки на следующий ресурс обычно используются для разбиения на страницы get_submissions — ссылка указывает на все отправки продукта commit_submission — ссылки указывают на фиксацию отправки update_submission — ссылки на обновление отправки update_shippinglabel — ссылки указывают на обновление метки доставки
Способ	Строка	Тип метода HTTP, который будет использоваться при вызове URL-адреса. Возможные значения: GET POST PATCH

Дополнительный объект Атрибута

Этот объект предоставляет дополнительные атрибуты продукта, если он имеет тип контроллера RAID, контроллера хранилища или программы проверки виртуализации сервера (SVVP). Он может содержать один из трех типов объектов : StorageController, RaidController или SVVP.

Объект StorageController

Значение	Тип	Описание
biosVersion	строка	Версия BIOS для РОМ
FirmwareVersion	строка	Версия встроенного ПО
driverVersion	строка	Версия драйвера
DriverName	строка	Driver Name
deviceVersion	строка	Версия устройства
набор микросхемName	строка	Имя набора микросхем
usedProprietary	boolean	Поддержка нескольких путей с помощью собственного драйвера. Если задано значение true, то требуется присвоить имя владельца и проприетарную версию.
proprietaryName	строка	Имя программного обеспечения с несколькими путями
proprietaryVersion	строка	Версия программного обеспечения с несколькими путями
usedMicrosoft	boolean	Microsoft MPIO поддерживается с помощью модуля для конкретного устройства. Если значение true, то microsoftName и microsoftVersion являются обязательными.
microsoftName	строка	Имя программного обеспечения с несколькими путями
microsoftVersion	строка	Версия программного обеспечения с несколькими путями
usedBootSupport	boolean	Поддержка загрузки
usedBetterBoot	boolean	Поддержка загрузки > 2.2 ТБ. Если значение 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	строка	Версия программного обеспечения с несколькими путями
usedMicrosoft	boolean	Microsoft MPIO поддерживается с помощью модуля для конкретного устройства. Если значение true, то microsoftName и microsoftVersion являются обязательными
microsoftName	строка	Имя программного обеспечения с несколькими путями
microsoftVersion	строка	Версия программного обеспечения с несколькими путями
isThirdPartyNeeded	boolean	Драйвер, отличный от Майкрософт, необходимый для подключения
isSES	boolean	SES (службы корпуса SCSI). Указывает, включен ли SES. SCSI — это стандартный термин служебной шины, которая подключает устройства к системе, изначально небольшой системный интерфейс. SES является коротким для служб корпуса SCSI.
isSAFTE	boolean	SAF-TE (спецификация ANBll). Указывает, включен ли SAF-TE. ANBll спецификации отрасли. SAF-TE является коротким для SCSI Доступ к отказоустойчивым корпусам. SCSI — это стандартный термин служебной шины, которая подключает устройства к системе, изначально небольшой системный интерфейс.
additionalInfo	строка	Additonal Information

Объект SVVP

Значение	Тип	Описание
productVersion	строка	Версия продукта
supportLink	строка	URL-адрес службы поддержки
гостевые объекты	строка	Гостевая ОС. Возможны следующие значения: Windows Server 2008 Windows Server 2008 версии 2 Windows Server 2012 Windows Server 2012 R2
processorArchitecture	строка	Архитектура аппаратного процессора. Возможны следующие значения: Xeon Opteron Itanium 2
maxProcessors	integer	Максимальное количество процессоров в виртуальной машине
maxMemory	integer	Максимальная память в виртуальной машине (в ГБ)

Список типов продуктов

Продукт может иметь следующие типы. Вместе с операционной системой эти сведения используются для выявления применимости.

Трехмерный принтер
Датчик акселерометра
Все в одном
Все в одном с сенсорным касанием
Звуковое устройство
Объекты обработки звука
Контроллер Bluetooth
Контроллер Bluetooth, отличный от USB
Камера
Датчик камеры
Кластер
Акселератор вычислений 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 графического адаптера
Графический адаптер WDDM2.5
Только графический адаптер WDDM2.5
Только графический адаптер WDDM2.5
Виртуальная машина WDDM2.5 графического адаптера
Графический адаптер WDDM2.6
Только графический адаптер WDDM2.6
Только графический адаптер WDDM2.6
Виртуальная машина WDDM2.6 графического адаптера
Графический адаптер WDDM2.7
Только графический адаптер WDDM2.7
Только графический адаптер WDDM2.7
Виртуальная машина WDDM2.7 графического адаптера
Графический адаптер WDDM2.8
Только графический адаптер WDDM2.8
Только графический адаптер WDDM2.8
Виртуальная машина WDDM2.8 графического адаптера
Графический адаптер WDDM2.9
Только графический адаптер WDDM2.9
Только графический адаптер WDDM2.9
Виртуальная машина WDDM2.9 графического адаптера
Графический адаптер WDDM3.0
Только графический адаптер WDDM3.0
Только графический адаптер WDDM3.0
Виртуальная машина WDDM3.0 графического адаптера
Графический адаптер WDDM3.1
Только графический адаптер WDDM3.1
Только графический адаптер WDDM3.1
Виртуальная машина WDDM3.1 графического адаптера
Графический адаптер WDDM3.2
Только графический адаптер WDDM3.2
Только графический адаптер WDDM3.2
Виртуальная машина WDDM3.2 графического адаптера
Графический планшет
Датчик гироскопа
Жесткий диск
Многофункционные преобразования оборудования
Клавиатура
Переключатель мыши на клавиатуре
Локальная сеть
ЛОКАЛЬНая сеть (сервер)
CS локальной сети
Виртуальная машина локальной сети (сервер)
ноутбук
Ноутбук с сенсорным экраном
ЖКД
Датчик света
Датчик расположения
Проигрыватель мультимедиа
Мобильный широкополосный CDMA
Мобильный широкополосный GSM
Мобильный телефон
Azure Monitor
Материнская плата
Датчик движения Fusion
Принтер с несколькими функциями
Близкое к полю близкое расположение
Сетевое устройство мультимедиа
NFC
Средство чтения смарт-карт NFC
Оптический диск
Перо Дигитайзер
Указание рисунка
PrecisionTouchpad
Датчик присутствия
Принтер
Projector
Съемные носители
Маршрутизатор
Сканер
Контроллер SDIO
Сервер
Программа проверки виртуализации сервера
Сигнатурный планшет
Смарт-карты
Средство чтения смарт-карт
Массив хранения данных
Контроллер хранилища
Адаптер дисковые пространства
диск дисковые пространства
Планшет
Сенсорный ввод
Сенсорный монитор
TPM20
Ультра-мобильный компьютер
Ультра-мобильный компьютер с сенсорным интерфейсом
USB-контроллер
USB-концентратор
Веб-камера
WLAN
WLAN CSB
Многофакторный принтер WSD
Принтер WSD
Сканер WSD

Список кодов семейства операционных систем

В следующей таблице перечислены коды семейства операционных систем и их описания.

Семейный код ОС	Description
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 Anniversary Update
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

Список кодов операционной системы

В следующей таблице перечислены коды операционной системы и их описания.

Код ОС	Description
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 x64
WINDOWS_8	Клиент Windows 8
WINDOWS_8_X64	x64-клиент Windows 8
WINDOWS_8_ARM	Windows 8 Client 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 Client 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 Client x64
WINDOWS_v100_RS3_FULL	Клиент Windows 10 RS3
WINDOWS_v100_X64_RS3_FULL	Windows 10 RS3 Client x64
WINDOWS_v100_ARM64_RS3_FULL	Windows 10 RS3 Client Arm64
WINDOWS_v100_RS4_FULL	Клиент Windows 10 RS4
WINDOWS_v100_X64_RS4_FULL	Windows 10 RS4 Client x64
WINDOWS_v100_ARM64_RS4_FULL	Windows 10 RS4 Client 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 Client x86
WINDOWS_v100_X64_VB_FULL	Клиент Windows версии 2004 x64
WINDOWS_v100_ARM64_VB_FULL	Windows версии 2004 Client 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. Если запрос не может быть выполнен успешно, ответ содержит один из следующих кодов ошибок HTTP.

Состояние HTTP	Description
400 — недопустимый запрос	Запрос не хорошо сформирован (например, неправильный синтаксис запроса, недопустимая маршрутизация сообщений запроса или обманчивая маршрутизация запросов)
401 — не авторизовано;	Сбой проверки подлинности или не указан
403 — запрещено;	Запрещен доступ к ресурсу.
404 — не найден	Запрошенная сущность не найдена.
415 — неподдерживаемый тип носителя	Полезные данные в формате, который не поддерживается этим методом в целевом ресурсе.
422 — необработаемая сущность	Сбои проверки.
429 — слишком много запросов	Отправляется слишком много запросов. Вызовы регулируются, а время отступа предоставляется в ответе.
500 — внутренняя ошибка сервера	На сервере API произошла неустранимая ошибка.

Если возникают сбои функциональной проверки, текст ответа содержит один из следующих кодов функциональных ошибок.

Код ошибки	Сообщение об ошибке	Description
InvalidInput		Возвращается при сбое проверки входных данных.
RequestInvalidForCurrentState	Можно зафиксировать только ожидающие отправки	Возвращается при применении фиксации к отправке, которая не находится в состоянии ожидания.
RequestInvalidForCurrentState	Начальная отправка уже существует	Возвращается при создании первоначальной отправки для драйвера, который уже имеет начальную отправку.
RequestInvalidForCurrentState	Не удается создать производную отправку, так как первоначальная отправка не создана	Возвращается при создании производной отправки для драйвера, который не имеет начальной отправки.
UpdateUnauthorized	Не авторизовано для обновления продукта	Возвращается при попытке обновить продукт, который был общим (перепродан), так как общие продукты не могут быть обновлены.
UpdateUnauthorized	Не удается обновить продукт без первоначальной отправки	Возвращается при попытке обновить продукт, который не имеет начальной отправки.
UpdateUnauthorized	Не удается обновить продукт, так как рабочий процесс завершился сбоем	Возвращается при попытке обновить продукт, у которого произошел сбой рабочий процесс.
UpdateUnauthorized	Дата объявления не может быть обновлена после завершения процесса приема	Возвращается при обновлении даты объявления после завершения приема.
UpdateUnauthorized	Имя продукта в настоящее время не может быть обновлено. Повторите попытку.
UpdateUnauthorized	Не авторизовано для обновления отправки	Возвращается при попытке обновить отправку для продукта, который был общим (перепроданным), так как общие продукты не могут быть обновлены.
UpdateUnauthorized	Не удается обновить отправку, так как рабочие процессы завершили сбой	Возвращается при попытке обновить отправку, в которой произошел сбой рабочий процесс.
EntityNotFound	Отправка не найдена	Возвращается при попытке фиксации для отправки, которая не существует.
EntityNotFound	Продукт не найден	Возвращается при попытке создать отправку, для которой продукт не существует.
InvalidInput	Драйверы расширений должны быть опубликованы как автоматическое обновление. Любой из isAutoInstallDuringOSUpgrade или isAutoInstallOnApplicableSystems должен иметь значение true.	Возвращается при создании метки доставки обновлений Windows для INF-файла без выбора isAutoInstallDuringOSUpgrade или isAutoInstallOnApplicableSystems.
InvalidInput	ChiD разрешены только в том случае, если аппаратные идентификаторы предназначены для операционных систем Windows 10 и более поздних версий.	Возвращается, когда метка доставки, предназначенная для ОС меньше windows 10, создается с целевым назначением CHID. Назначение CHID применимо только для Windows 10 и более поздних версий.
InvalidInput	Не удается обновить метку доставки, когда выполняется другой рабочий процесс. Повторите попытку.	Возвращается при обновлении метки доставки при выполнении предыдущего рабочего процесса.
RequestInvalidForCurrentState	Не удается создать метку доставки публикации для входящие или системного типа. Можно поделиться только меткой доставки.	Возвращается при создании метки доставки обновлений Windows на драйвере папки "Входящие" или системе.
RequestInvalidForCurrentState	Отправка пока не готова к созданию метки доставки. Повторите попытку через некоторое время.	Возвращается при создании метки доставки, не ожидая завершения подготовки или предварительной обработки.

См. также

Примеры API панели мониторинга оборудования (GitHub)

Поделиться через

Получение данных о продукте

Необходимые компоненты

Ресурсы данных

Ресурс продукта

Ресурс отправки

Объект "Состояние рабочего процесса"

Скачивание объекта

Объект Link

Дополнительный объект Атрибута

Объект StorageController

Объект RaidController

Объект SVVP

Список типов продуктов

Список кодов семейства операционных систем

Список кодов операционной системы

Коды ошибок

См. также

Обратная связь

Дополнительные ресурсы