Создание новой отправки для продукта

Статья
10/27/2023

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

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

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

Запрос

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

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

ProductId в методе — это продукт, для которого предназначена отправка.

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

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

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

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

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

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

{
  "name": "VST_apdevtest1_init",
  "type": "initial"
}

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

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

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

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

Ответ

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

{
  "id": 1152921504621465124,
  "productId": 14631253285588838,
  "downloads": {
    "items": [
      {
        "type": "initialPackage",
        "url": "https://ingestionpackages.blob.core.windows.net/ingestion/38c19eaf-7377-4834-893c-28d5791f7896?sv=2017-04-17&sr=b&sig=SlD5j5e067oA4Y3hdk1sPW3UycTSUVlIp80WbWvj4A8%3D&se=2018-03-20T05:00:14Z&sp=rwl"
      }
    ],
    "messages": []
  },
  "links": [
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions/1152921504621465124",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions/1152921504621465124",
      "rel": "update_submission",
      "method": "PATCH"
    }
  ],
  "commitStatus": "commitPending",
  "isExtensionInf": true,
  "isUniversal": true,
  "isDeclarativeInf": true,
  "name": "VST_apdevtest1_init",
  "type": "initial"
}

Текст ответа

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

Коды ошибок

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

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

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