更新出貨標籤

  • 發行項

在 Microsoft 硬體 API 中使用此方法來更新出貨標籤。 使用此方法之前，請確定您已建立出貨標籤。 如需建立出貨標籤的詳細資訊，請參閱 建立新的出貨標籤。

必要條件

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

要求

這個方法的語法如下。 本主題中的其他章節提供標頭和要求本文的使用範例和描述。

方法 要求 URI
PATCH https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId}

方法中的 productID、 submissionID 和 shippingLabelID 代表要更新的產品、提交和出貨標籤。

要求標頭

標頭 類型 描述
授權 String 必要。 Microsoft Entra識別碼存取權杖格式為Bearer< 權杖 > 。
接受 字串 選擇性。 指定內容類型。 允許的值為 「application/json」

要求參數

請勿提供這個方法的要求參數。

要求本文

下列範例示範出貨標籤的 JSON 要求本文。 只有下列類型的變更可以變更出貨標籤：

  • 新增硬體識別碼
  • 移除/到期硬體識別碼
  • 新增 CHID
  • 移除 CHID
  • 新增物件
  • 更新/移除物件
  • 提供變更的商業理由
{
  "targeting": {
    "chids": [
      {
        "action": "add",
        "chid": "812fac65-9c26-473c-b3a9-1eb3803ac22c"
      },
      {
        "action": "remove",
        "chid": "aed6336d-0958-444c-89b6-bf471191d6f0"
      }
    ],
    "hardwareIds": [
      {
        "action": "remove",
        "bundleId": "a2dfbcd8-1d4a-4885-90a3-2ac8360542da",
        "infId": "foo.inf",
        "operatingSystemCode": "WINDOWS_v100_X64_RS3_FULL",
        "pnpString": "pci\\ven_8086&dev_5a85"
      },
      {
        "action": "add",
        "bundleId": "48140805-45a3-4a76-8818-e75c117adba9",
        "infId": "foo.inf",
        "operatingSystemCode": "WINDOWS_v100_X64_RS3_FULL",
        "pnpString": "pci\\ven_8086&dev_5a85"
      }
    ],
    "restrictedToAudiences": [
      "00000000-0000-0000-0000-000000000000",
      "00000000-0000-0000-0000-000000000001"
    ],
    "inServicePublishInfo": {
      "flooring": "RS1",
      "ceiling": "RS3"
    },
    "businessJustification": "Business justification for updating shipping label"
  }
}

如需要求中欄位的詳細資訊，請參閱 ShippingLabel 資源。

注意事項：

  • 更新 CHID 或 HardwareID 時，您必須提供 動作 的值。

  • 物件 是僅限更新的欄位。 在此欄位中提供值會覆寫任何先前的值。 將值保留空白會移除先前的值。

  • 若要瞭解如何取得組織的物件清單，請參閱 取得物件。

  • 更新出貨標籤時，硬體識別碼物件應該包含套件組合識別碼、PNP 識別碼、OS 程式碼和 INF 名稱的有效組合。 若要取得您提交 (套件) 的有效允許這些屬性組合，請在您取得提交的詳細資料時，下載驅動程式中繼資料檔案 (提供為連結) 。 如需詳細資訊，請參閱 驅動程式套件中繼資料。

要求範例

下列範例示範如何更新出貨標籤。

PATCH https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964156/submissions/1152921504621467600/shippingLabels/1152921504606980300 HTTP/1.1
Authorization: Bearer <your access token>

回應

回應會是空的，HTTP 狀態為 204。

在此步驟之後，請使用 取得出貨標籤 中的 方法來取得出貨標籤的更新詳細資料。

錯誤碼

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

另請參閱