Share via

配送先住所ラベルの取り消し

  • [アーティクル]

Microsoft による承認または段階的なロールアウトで配送先住所ラベルの取り消しを要求するには、"Microsoft ハードウェア API" のこのメソッドを使用します。 このメソッドを使用する前に、配送先住所ラベルが Microsoft による承認または段階的なロールアウトにあることを確認してください。 配送先住所ラベルの取得について詳しくは、新しい配送先住所ラベルの取得に関する記事をご覧ください。

Note

共有された配送先住所ラベルを取り消すことはできません。 ただし、ワークフローの完了後に共有を取り消すことができます。

前提条件

Microsoft ハードウェア API に関するすべての前提条件をまだ満たしていない場合は、このメソッドを使用する前に前提条件を整えてください。

要求

このメソッドの構文は次のとおりです。 ヘッダーと要求本文の使用例と説明については、このトピックの他のセクションをご覧ください。

メソッド 要求 URI
PUT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId}/cancel

メソッド内の ProductID、submissionID、shippingLabelId は、取り消される製品、申請および配送先住所ラベルを表します。

要求ヘッダー

Header 型 説明
承認 String 必須。 Bearer<token> 形式の Microsoft Entra ID アクセス トークン。
同意する String 省略可能。 コンテンツの種類を指定します。 使用できる値は "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 で空になります。

この手順の後、「配送先住所ラベルの取得」のメソッドを使用して、配送先住所ラベルの更新に関する詳細を取得してください。 ドライバーのフライティング システムでのドライバーの実際の取り消しは、完了するまでに 1 日以上かかる場合があることに注意してください。

エラー コード

エラー コードについて詳しくは、「Error codes (エラー コード)」をご覧ください。

関連項目