配送先住所ラベルの取り消し
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 (エラー コード)」をご覧ください。