为产品创建新的提交

项目
02/28/2024

在 Microsoft 硬件 API 中使用此方法为产品创建新的提交。使用此方法之前，请确保已创建了新产品。有关详细信息，请参阅创建新产品。

先决条件

完成 Microsoft 硬件 API 的所有先决条件（如果尚未这样做），然后尝试使用这其中的任何方法。

请求

此方法具有以下语法。请参阅以下部分，获取标头和请求正文的使用示例和描述。

方法	请求 URI
POST	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions`

此方法中的 productId 是提交所适用于的产品。

请求头

标头	类型	说明
授权	字符串	必需。 Bearer<token> 令牌形式的 Microsoft Entra ID 访问令牌。
Accept	字符串	可选。指定内容的类型。允许的值是“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)