取消发货标签
在 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 表示要取消的产品、提交和发货标签。
请求头
| 标头 | 类型 | 说明 |
|---|---|---|
| 授权 | 字符串 | 必需。 Bearer<token> 令牌形式的 Microsoft Entra ID 访问令牌。 |
| Accept | 字符串 | 可选。 指定内容的类型。 允许的值是“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。
完成此步骤后，请使用获取发货标签中的方法获取发货标签的更新详细信息。 请注意，在驱动程序外部测试系统中实际取消驱动程序可能需要一天以上的时间才能完成。
错误代码
有关错误代码的更多信息，请参阅错误代码。