建立產品的新提交

發行項
10/27/2023

在 Microsoft 硬體 API 中使用此方法，為產品建立新的提交。使用此方法之前，請確定您已建立新產品。如需詳細資訊，請參閱建立新產品。

必要條件

如果您尚未這麼做，請先完成 Microsoft 硬體 API 的所有必要條件，再嘗試使用這些方法。

要求

這個方法的語法如下。請參閱下列各小節了解標頭和要求主體的使用範例和描述。

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

方法中的 productId 是提交預定的產品。

要求標頭

標頭	類型	描述
授權	String	必要。 Microsoft Entra識別碼存取權杖格式為Bearer< 權杖 > 。
接受	字串	選擇性。指定內容類型。允許的值為「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"
}

回應本文

如需詳細資訊，請參閱提交資源。

錯誤碼

如需詳細資訊，請參閱錯誤碼。

另請參閱

GitHub) (硬體儀表板 API 範例