Aggiornare un'etichetta di spedizione
Usare questo metodo nell'API Hardware Microsoft per aggiornare un'etichetta di spedizione. Prima di usare questo metodo, assicurarsi di aver già creato un'etichetta di spedizione. Per altre info sulla creazione di un'etichetta di spedizione, vedi Creare una nuova etichetta di spedizione.
Prerequisiti
Se non è già stato fatto, completare tutti i prerequisiti per le API hardware Microsoft prima di usare uno di questi metodi.
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 |
|---|---|
| PATCH | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId} |
ProductID, submissionID e shippingLabelID nel metodo rappresentano il prodotto, l'invio e l'etichetta di spedizione da aggiornare.
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
L'esempio seguente illustra il corpo della richiesta JSON per un'etichetta di spedizione. Solo i tipi di modifiche seguenti possono essere apportati a un'etichetta di spedizione:
- Aggiungere ID hardware
- Rimuovere/scadere gli ID hardware
- Aggiungere CHID
- Rimuovere i CHID
- Aggiungere gruppi di destinatari
- Aggiornare/rimuovere gruppi di destinatari
- Fornire una giustificazione aziendale per le modifiche
{
"targeting": {
"chids": [
{
"action": "add",
"chid": "812fac65-9c26-473c-b3a9-1eb3803ac22c"
},
{
"action": "remove",
"chid": "aed6336d-0958-444c-89b6-bf471191d6f0"
}
],
"hardwareIds": [
{
"action": "remove",
"bundleId": "a2dfbcd8-1d4a-4885-90a3-2ac8360542da",
"infId": "foo.inf",
"operatingSystemCode": "WINDOWS_v100_X64_RS3_FULL",
"pnpString": "pci\\ven_8086&dev_5a85"
},
{
"action": "add",
"bundleId": "48140805-45a3-4a76-8818-e75c117adba9",
"infId": "foo.inf",
"operatingSystemCode": "WINDOWS_v100_X64_RS3_FULL",
"pnpString": "pci\\ven_8086&dev_5a85"
}
],
"restrictedToAudiences": [
"00000000-0000-0000-0000-000000000000",
"00000000-0000-0000-0000-000000000001"
],
"inServicePublishInfo": {
"flooring": "RS1",
"ceiling": "RS3"
},
"businessJustification": "Business justification for updating shipping label"
}
}
Per informazioni dettagliate sui campi nella richiesta, vedere Risorsa ShippingLabel.
Punti da notare:
È necessario specificare un valore per l'azione durante l'aggiornamento di CHID o HardwareID.
Il gruppo di destinatari è un campo di sola aggiornamento. Se si specifica un valore in questo campo, viene sovrascritto qualsiasi valore precedente. Se si lascia vuoto il valore, il valore precedente viene rimosso.
Per informazioni su come ottenere un elenco di destinatari per l'organizzazione, vedere Ottenere destinatari.
L'oggetto ID hardware deve contenere una combinazione valida di ID bundle, ID PNP, codice del sistema operativo e nome INF durante l'aggiornamento di un'etichetta di spedizione. Per ottenere le combinazioni valide e consentite di questi attributi per l'invio (pacchetto), scaricare il file di metadati del driver (fornito come collegamento) quando si ottengono i dettagli di un invio. Per informazioni dettagliate, vedere Metadati del pacchetto driver.
Esempi di richiesta
Nell'esempio seguente viene illustrato come aggiornare un'etichetta di spedizione.
PATCH https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964156/submissions/1152921504621467600/shippingLabels/1152921504606980300 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.
Codici di errore
Per altre info sui codici di errore, vedi Codici di errore.