为产品创建新的提交

在 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": "<SAS URL from Hardware API>"
      }
    ],
    "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)