Stornieren eines Versandetiketts
Verwenden Sie diese Methode in der Microsoft Hardware-API , um den Abbruch einer Versandbezeichnung in Microsoft Approval or Gradual Rollout anzufordern. Bevor Sie diese Methode verwenden, stellen Sie sicher, dass sich Ihr Versandetikett in der Microsoft-Genehmigung oder dem schrittweisen Rollout befindet. Weitere Informationen zum Abrufen eines Versandetiketts finden Sie unter Abrufen eines neuen Versandetiketts.
Hinweis
Sie können ein freigegebenes Versandetikett nicht stornieren. Sie können die Freigabe jedoch widerrufen, nachdem der Workflow abgeschlossen ist.
Voraussetzungen
Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft-Hardware-APIs erfüllen, bevor Sie diese Methode verwenden.
Anforderung
Diese Methode hat die folgende Syntax. Die anderen Abschnitte in diesem Thema enthalten Verwendungsbeispiele und Beschreibungen des Headers und des Anforderungstexts.
| Methode | Anforderungs-URI |
|---|---|
| PUT | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId}/cancel |
Die productID, submissionID und shippingLabelId in der Methode stellen das Produkt-, Übermittlungs- und Versandetikett für die Stornierung dar.
Anforderungsheader
| Header | type | BESCHREIBUNG |
|---|---|---|
| Authorization | String | Erforderlich. Das Microsoft Entra ID-Zugriffstoken im Format Bearertoken<>. |
| Akzeptieren | String | Optional. Gibt den Typ des Inhalts an. Zulässiger Wert ist "application/json" |
Anforderungsparameter
Geben Sie keine Anforderungsparameter für diese Methode an.
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Anforderungsbeispiele
Im folgenden Beispiel wird veranschaulicht, wie sie den Abbruch einer Versandbezeichnung anfordern.
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>
Antwort
Die Antwort ist leer mit dem HTTP-status 204.
Verwenden Sie nach diesem Schritt die -Methode unter Abrufen eines Versandetiketts , um die aktualisierten Details des Versandetiketts abzurufen. Bitte beachten Sie, dass die tatsächliche Stornierung des Fahrers in den Fahrerflugsystemen einen Tag dauern kann.
Fehlercodes
Weitere Informationen zu Fehlercodes finden Sie unter Fehlercodes.