Создание продукта

Статья
12/08/2023

Используйте этот метод в API оборудования Майкрософт для создания нового аппаратного продукта.

Предварительные требования

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

Запрос

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

Метод	Универсальный код ресурса (URI) запроса
POST	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products`

Заголовок запроса

Заголовок	Тип	Описание
Авторизация	строка	Обязательный. Маркер доступа идентификатора Microsoft Entra в виде маркера> носителя<.
accept	строка	Необязательный параметр. Указывает тип содержимого. Допустимое значение — application/json.

Параметры запроса

Не указывайте параметры запроса для этого метода.

Текст запроса

В следующем примере показан текст запроса JSON для создания нового продукта. Дополнительные сведения о значениях в тексте запроса см. в таблице под json.

{
  "productName": "Test_Network_Product2-R",
  "testHarness": "Attestation",
  "announcementDate": "2018-01-01T00:00:00",
  "deviceMetadataIds": [],
  "firmwareVersion": "980",
  "deviceType": "external",
  "isTestSign": false,
  "isFlightSign": false,  
  "marketingNames": [],
  "selectedProductTypes": {
    "windows_v100_RS3": "Unclassified"
  },
  "requestedSignatures": [
    "WINDOWS_v100_RS3_FULL",
    "WINDOWS_v100_X64_RS3_FULL",
    "WINDOWS_VISTA"
  ],
  "additionalAttributes": {}
}

Дополнительные сведения о полях в запросе см. в разделе Ресурс Product.

Примеры запросов

В следующем примере показано, как создать новый продукт.

POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products HTTP/1.1
Authorization: Bearer <your access token>

Ответ

В следующем примере показан текст ответа JSON, возвращенный успешным запросом на создание продукта. Дополнительные сведения о значениях, которые могут содержаться в теле ответа, см. в следующем разделе.

{
  "id": 14631253285588838,
  "sharedProductId": 1152921504607010608,
  "links": [
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v1/hardware/products/14631253285588838",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v1/hardware/products/14631253285588838/submissions",
      "rel": "get_submissions",
      "method": "GET"
    }
  ],
  "isCommitted": false,
  "isExtensionInf": false,
  "announcementDate": "2018-01-01T00:00:00",
  "deviceMetadataIds": [],
  "firmwareVersion": "980",
  "deviceType": "external",
  "isTestSign": false,
  "isFlightSign": false,  
  "marketingNames": [],
  "productName": "VST_apdevtest1",
  "selectedProductTypes": {
    "windows_v100_RS3": "Unclassified"
  },
  "requestedSignatures": [
    "WINDOWS_v100_RS3_FULL",
    "WINDOWS_v100_X64_RS3_FULL",
    "WINDOWS_VISTA"
  ],
  "additionalAttributes": {},
  "testHarness": "attestation"
}

Текст ответа

Дополнительные сведения см. в ресурсе Product .

Коды ошибок

Дополнительные сведения см. в разделе Коды ошибок.

См. также раздел

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

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