Annullare un'etichetta di spedizione
Usare questo metodo nell'API Hardware Microsoft per richiedere l'annullamento di un'etichetta di spedizione in Approvazione Microsoft o implementazione graduale. Prima di usare questo metodo, assicurarsi che l'etichetta di spedizione sia in Approvazione Microsoft o implementazione graduale. Per altre info su come ottenere un'etichetta di spedizione, vedi Ottenere una nuova etichetta di spedizione.
Nota
Non è possibile annullare un'etichetta di spedizione condivisa. Tuttavia, è possibile revocare la condivisione dopo il completamento del flusso di lavoro.
Prerequisiti
Se non è già stato fatto, completare tutti i prerequisiti per le API hardware Microsoft prima di usare questo metodo.
Richiesta
La sintassi di questo metodo è la seguente. Le altre sezioni di questo argomento forniscono esempi di utilizzo e descrizioni del corpo dell'intestazione e della richiesta.
| Metodo | URI richiesta |
|---|---|
| PUT | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId}/cancel |
ProductID, submissionID e shippingLabelId nel metodo rappresentano il prodotto, l'invio e l'etichetta di spedizione per l'annullamento.
Intestazione della richiesta
| Intestazione | Tipo | Descrizione |
|---|---|---|
| Autorizzazione | string | Obbligatorio. Token di accesso Microsoft Entra ID nel formato Token>di connessione<. |
| Accetta | Stringa | Facoltativo. Specifica il tipo di contenuto. Il valore consentito è "application/json" |
Parametri della richiesta
Non fornire parametri di richiesta per questo metodo.
Testo della richiesta
Non fornire il corpo della richiesta per questo metodo.
Esempi di richiesta
Nell'esempio seguente viene illustrato come richiedere l'annullamento di un'etichetta di spedizione.
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>
Risposta
La risposta sarà vuota con stato HTTP 204.
Dopo questo passaggio, usare il metodo in Ottenere un'etichetta di spedizione per ottenere i dettagli aggiornati dell'etichetta di spedizione. Si prega di notare che l'annullamento effettivo del conducente nei sistemi di volo del conducente potrebbe richiedere più di un giorno per il completamento.
Codici di errore
Per altre info sui codici di errore, vedi Codici di errore.