取消出貨標籤
在 Microsoft 硬體 API 中使用此方法，在 Microsoft 核准或漸進式推出中要求取消出貨標籤。 使用此方法之前，請確定您的出貨標籤位於 Microsoft 核准或漸進式推出中。 如需取得出貨標籤的詳細資訊，請參閱 取得新的出貨標籤。
注意
您無法取消共用出貨標籤。 不過，您可以在工作流程完成之後撤銷共用。
必要條件
如果您尚未這麼做，請先完成 Microsoft 硬體 API 的所有 必要條件 ，再使用此方法。
要求
這個方法的語法如下。 本主題中的其他章節提供標頭和要求本文的使用範例和描述。
| 方法 | 要求 URI |
|---|---|
| PUT | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId}/cancel |
方法中的 productID、 submissionID 和 shippingLabelId 代表要取消的產品、提交和出貨標籤。
要求標頭
| 標頭 | 類型 | 描述 |
|---|---|---|
| 授權 | String | 必要。 Microsoft Entra識別碼存取權杖格式為Bearer< 權杖 > 。 |
| 接受 | 字串 | 選擇性。 指定內容類型。 允許的值為 「application/json」 |
要求參數
請勿提供這個方法的要求參數。
要求本文
請勿提供這個方法的要求本文。
要求範例
下列範例示範如何要求取消出貨標籤。
PUT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964156/submissions/1152921504621467600/shippingLabels/1152921504606980300/cancel HTTP/1.1
Authorization: Bearer <your access token>
回應
回應會是空的，HTTP 狀態為 204。
在此步驟之後，請使用 取得出貨標籤 中的 方法來取得出貨標籤的更新詳細資料。 請注意，驅動程式正式發行前小眾測試版系統中的驅動程式實際取消可能需要一天才能完成。
錯誤碼
如需錯誤碼的詳細資訊，請參閱 錯誤碼。