Annuler une étiquette d’expédition
Utilisez cette méthode dans l’API matériel Microsoft pour demander l’annulation d’une étiquette d’expédition dans Approbation Microsoft ou Déploiement progressif. Avant d’utiliser cette méthode, assurez-vous que votre étiquette d’expédition est dans Approbation Microsoft ou Déploiement progressif. Pour plus d’informations sur l’obtention d’une étiquette d’expédition, consultez Obtenir une nouvelle étiquette d’expédition.
Notes
Vous ne pouvez pas annuler une étiquette d’expédition partagée. Toutefois, vous pouvez révoquer le partage une fois le flux de travail terminé.
Prérequis
Si vous ne l’avez pas déjà fait, remplissez tous les prérequis pour les API de matériel Microsoft avant d’utiliser cette méthode.
Requête
Cette méthode présente la syntaxe suivante. Les autres sections de cette rubrique fournissent des exemples d’utilisation et des descriptions de l’en-tête et du corps de la requête.
| Méthode | URI de requête |
|---|---|
| PUT | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId}/cancel |
ProductID, submissionID et shippingLabelId dans la méthode représentent le produit, l’envoi et l’étiquette d’expédition en vue de l’annulation.
En-tête de requête
| En-tête | Type | Description |
|---|---|---|
| Autorisation | String | Obligatoire. Jeton d’accès d’ID Microsoft Entra sous la forme Jeton> du porteur<. |
| Accepter | String | Optionnel. Spécifie le type de contenu. La valeur autorisée est « application/json » |
Paramètres de la demande
Ne fournissez pas de paramètres de requête pour cette méthode.
Corps de la demande
Ne fournissez pas le corps de la demande pour cette méthode.
Exemples de demande
L’exemple suivant montre comment demander l’annulation d’une étiquette d’expédition.
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>
response
La réponse sera vide avec une status HTTP de 204.
Après cette étape, utilisez la méthode dans Obtenir une étiquette d’expédition pour obtenir les détails mis à jour de l’étiquette d’expédition. Notez que l’annulation réelle du conducteur dans les systèmes de vol de pilotes peut prendre plus d’une journée.
Codes d’erreur
Pour plus d’informations sur les codes d’erreur, consultez Codes d’erreur.