更新出貨標籤
在 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。
在此步驟之後，請使用 取得出貨標籤 中的 方法來取得出貨標籤的更新詳細資料。
錯誤碼
如需錯誤碼的詳細資訊，請參閱 錯誤碼。