Creare un nuovo invio per un prodotto
Usare questo metodo nell'API Hardware Microsoft per creare un nuovo invio per un prodotto. Prima di usare questo metodo, assicurarsi di aver creato un nuovo prodotto. Per informazioni dettagliate, vedere Creare un nuovo prodotto.
Prerequisiti
Se non è già stato fatto, completare tutti i prerequisiti per le API hardware Microsoft prima di provare a usare uno di questi metodi.
Richiesta
La sintassi di questo metodo è la seguente. Vedi le sezioni seguenti per esempi di uso e descrizioni dell'intestazione e del contenuto della richiesta.
| Metodo | URI richiesta |
|---|---|
| POST | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions |
ProductId nel metodo è il prodotto per il quale è previsto l'invio.
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 la creazione di un nuovo invio.
{
"name": "VST_apdevtest1_init",
"type": "initial"
}
Per informazioni dettagliate sui campi nella richiesta, vedere Risorsa invio.
Esempi di richiesta
Nell'esempio seguente viene illustrato come creare un nuovo invio.
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions HTTP/1.1
Authorization: Bearer <your access token>
Risposta
L'esempio seguente illustra il corpo della risposta JSON restituito da una richiesta riuscita per la creazione di un nuovo invio per un prodotto. Per altri dettagli sui valori nel contenuto della risposta, vedi la sezione seguente.
{
"id": 1152921504621465124,
"productId": 14631253285588838,
"downloads": {
"items": [
{
"type": "initialPackage",
"url": "<SAS URL from Hardware API>"
}
],
"messages": []
},
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions/1152921504621465124",
"rel": "self",
"method": "GET"
},
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions/1152921504621465124",
"rel": "update_submission",
"method": "PATCH"
}
],
"commitStatus": "commitPending",
"isExtensionInf": true,
"isUniversal": true,
"isDeclarativeInf": true,
"name": "VST_apdevtest1_init",
"type": "initial"
}
Corpo della risposta
Per altri dettagli, vedere Risorsa di invio .
Codici di errore
Per altre info, vedi Codici di errore.